Skip to content

Commit 53af64a

Browse files
author
Forge
committed
docs: warn about tiers overwriting hand-curated L0/L1
The tiers command scores by keyword matching which produces low-signal output when run against observations/ directories. Hand-curated L0/L1 files will be silently overwritten on next tiers run.
1 parent 76a4828 commit 53af64a

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,9 +319,18 @@ All fields optional — sensible defaults are used when absent.
319319
| `memory/.codebook.json` | Dictionary codebook (must travel with memory files) |
320320
| `memory/.observed-sessions.json` | Tracks processed transcripts |
321321
| `memory/observations/` | Compressed session summaries |
322-
| `memory/MEMORY-L0.md` | Level 0 summary (~200 tokens) |
322+
| `memory/MEMORY-L0.md` | Level 0 summary (~200 tokens) — **see note below** |
323+
| `memory/MEMORY-L1.md` | Level 1 summary (~1000 tokens) — **see note below** |
323324
| `memory/.compactor-state.json` | Auto-compress tracking state |
324325

326+
### ⚠️ L0/L1 Warning: Hand-curate, don't auto-generate
327+
328+
The `tiers` command generates L0/L1/L2 files by scoring section headers with keyword matching. This works well for structured memory files (e.g. `MEMORY.md`) but produces **low-signal output when run against `memory/observations/`** — it fills the token budget with short, generic `[config] exec operation` sections instead of meaningful summaries.
329+
330+
**Recommendation:** Write `MEMORY-L0.md` and `MEMORY-L1.md` manually. Use `tiers` for analysis (`--json` flag) to understand your token distribution, but treat the generated files as drafts that need review before use as boot context.
331+
332+
Running `tiers` again will silently overwrite hand-curated files. If you've written your own L0/L1, either exclude them from the `tiers` output directory or don't run `tiers --output-dir` against your memory directory.
333+
325334
---
326335

327336
## Heartbeat Automation

0 commit comments

Comments
 (0)