Skip to content

Commit f883923

Browse files
committed
docs: restack file-layout diagram as the real pipeline
Publish is plumbing, not a phase: it writes recaps and raw_memories.md. Phase 2 is consolidate only — MEMORY.md then memory_summary.md, never editing recaps.
1 parent 69b825b commit f883923

2 files changed

Lines changed: 83 additions & 91 deletions

File tree

‎docs/how-ai-memory-works.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -134,8 +134,8 @@ separation is what keeps the markdown workspace the single source of truth
134134
for retrieval.
135135

136136
![On-disk layout: memory.db sits beside the memories folder. Phase 1 writes
137-
the database; Phase 2 publishes a ranked subset as markdown and consolidates
138-
it; the read path searches only the published files.](memory-files.svg)
137+
the database; a publish step writes a ranked subset as markdown; Phase 2
138+
consolidates; the read path searches only the published files.](memory-files.svg)
139139

140140
Two extra files live in the folder that are not pyramid layers:
141141
`raw_memories.md` (a temporary merge of selected Phase-1 rows; consolidation's
@@ -264,8 +264,8 @@ corrupt the very structure they are supposed to maintain.
264264

265265
### Publishing: candidates become markdown files
266266

267-
Phase 2 does not read the whole candidate pool. It first **publishes a
268-
ranked subset** into the memory folder:
267+
Consolidation does not read the whole candidate pool. A **publish** step
268+
first writes a ranked subset into the memory folder:
269269

270270
1. Rank the database rows by demonstrated usefulness and recency, drop
271271
anything unused past the retention horizon, and cap how many recaps feed

‎docs/memory-files.svg‎

Lines changed: 79 additions & 87 deletions
Loading

0 commit comments

Comments
 (0)