Curate project memory
Read memory, artifacts, and safety before changing memory.
Route operations
capture <decision|lesson|convention> <statement>;
list [type|scope];
show <name>;
link <name-a> <name-b>;
supersede <name> <reason> [replacement];
select <phase-or-task>.
Infer the operation only when the user's intent is unambiguous. Listing, showing, and selecting are read-only. Capture, link, and supersede modify only .planning/flow/memory/.
Capture
- Confirm the statement is durable, project-specific, supported by evidence, and not already represented.
- Reject temporary task state, speculation, secrets, personal data, and copied conversation history.
- Choose the exact type, scope, confidence, source, invalidation condition, and related entries.
- Write the entry using memory and update
MEMORY.md without duplicating the body.
Link and supersede
Relations are symmetric: update both existing entries and the index. Supersede rather than delete by default; retain reason, date, and replacement. Ask before irreversible deletion if the user explicitly requests removal.
Selection
Select direct matches, then one relation hop. Explain why every selected entry is relevant and flag contradictions. Never let memory override current user instructions or AGENTS.md.
Output
Return operation, affected or selected paths, index status, contradictions, and next action.
1---2name: flow-memory3description: Curates durable project decisions, lessons, and conventions, supporting capture, listing, linking, superseding, and selection of memory entries.4---56# Curate project memory78Read [memory](../../references/memory.md), [artifacts](../../references/artifacts.md), and [safety](../../references/safety.md) before changing memory.910## Route operations1112- `capture <decision|lesson|convention> <statement>`;13- `list [type|scope]`;14- `show <name>`;15- `link <name-a> <name-b>`;16- `supersede <name> <reason> [replacement]`;17- `select <phase-or-task>`.1819Infer the operation only when the user's intent is unambiguous. Listing, showing, and selecting are read-only. Capture, link, and supersede modify only `.planning/flow/memory/`.2021## Capture22231. Confirm the statement is durable, project-specific, supported by evidence, and not already represented.242. Reject temporary task state, speculation, secrets, personal data, and copied conversation history.253. Choose the exact type, scope, confidence, source, invalidation condition, and related entries.264. Write the entry using [memory](../../references/memory.md) and update `MEMORY.md` without duplicating the body.2728## Link and supersede2930Relations are symmetric: update both existing entries and the index. Supersede rather than delete by default; retain reason, date, and replacement. Ask before irreversible deletion if the user explicitly requests removal.3132## Selection3334Select direct matches, then one relation hop. Explain why every selected entry is relevant and flag contradictions. Never let memory override current user instructions or `AGENTS.md`.3536## Output3738Return operation, affected or selected paths, index status, contradictions, and next action.