Update Memory
Record the smallest durable change supported by completed project work.
Load the Contract and Establish Context
- Read references/memory-contract.md completely before proposing edits.
- Resolve one project root and memory root from the user's request or current project. Ask for explicit consent before reading or writing any global store, sibling project, unrelated repository, or other root outside that project.
- Read the active
MEMORY.md and relevant local files. If no useful baseline exists, route to create-memory.
- Gather evidence from the user's confirmed summary, adopted decisions, completed work, changed interfaces, tests, failures, and available focused repository diff or history. Treat repository state as evidence, not a substitute for user intent.
- Route a task whose primary purpose is importing or refreshing supplied external content to
ingest-memory. When a source-backed conclusion arose incidentally during project work, record full structured provenance under the contract.
Decide Whether to Write
Write only a durable architectural or product decision, workflow or integration constraint, recurring preference, resolved failure and prevention rule, shipped contract or migration, operational milestone, or source-backed fact needed later.
Skip temporary progress, unfinished experiments, routine implementation detail, information obvious from code or existing instructions, secrets, private data, raw logs or conversations, and unadopted ideas.
Use this order:
- Update an existing focused file only when its durable truth changed.
- Propose one focused new file when durable knowledge is absent.
- Skip and explain temporary, redundant, unsupported, or uncertain material.
Preview file-level changes. Ask for confirmation when the root was inferred, cross-root access is involved, substantial text would be replaced, more than three files would be created, or relationships across multiple topics would change.
Update and Reconcile
- State the new durable fact and evidence in one sentence before editing.
- Search all local memory filenames, names, descriptions, source identities, and distinctive claims for duplicates or conflicts.
- Determine current truth from the strongest available evidence; do not automatically prefer existing text or newer text.
- Update the smallest focused section. Preserve dated historical context when it explains the current state, mark superseded details explicitly, and keep unresolved contradictions in a short
Conflicts or Open Questions section.
- Follow the contract exactly. Preserve or add structured provenance, keep local
related filenames symmetric, and update last_updated only when durable content changes.
- Update
MEMORY.md only when a file or its purpose changes, using the exact contract grammar.
Validate and Report
Run:
python scripts/validate_memory.py <memory-root>
Fix only errors introduced within the approved scope. Report evidence used, files changed, facts skipped, duplicate or conflict decisions, validation results, and remaining limitations. Recommend audit-memory after cross-file, index, relationship, or provenance changes.
1---2name: update-memory-33description: Maintain an existing project-memory store with durable facts learned during completed project work, decisions, fixes, migrations, or milestones. Use only when a usable baseline already exists; do not use for initial bootstrap, primary ingestion or refresh of an external source, read-only auditing, temporary progress, or speculative notes.4---56# Update Memory78Record the smallest durable change supported by completed project work.910## Load the Contract and Establish Context11121. Read [references/memory-contract.md](references/memory-contract.md) completely before proposing edits.132. Resolve one project root and memory root from the user's request or current project. Ask for explicit consent before reading or writing any global store, sibling project, unrelated repository, or other root outside that project.143. Read the active `MEMORY.md` and relevant local files. If no useful baseline exists, route to `create-memory`.154. Gather evidence from the user's confirmed summary, adopted decisions, completed work, changed interfaces, tests, failures, and available focused repository diff or history. Treat repository state as evidence, not a substitute for user intent.165. Route a task whose primary purpose is importing or refreshing supplied external content to `ingest-memory`. When a source-backed conclusion arose incidentally during project work, record full structured provenance under the contract.1718## Decide Whether to Write1920Write only a durable architectural or product decision, workflow or integration constraint, recurring preference, resolved failure and prevention rule, shipped contract or migration, operational milestone, or source-backed fact needed later.2122Skip temporary progress, unfinished experiments, routine implementation detail, information obvious from code or existing instructions, secrets, private data, raw logs or conversations, and unadopted ideas.2324Use this order:25261. Update an existing focused file only when its durable truth changed.272. Propose one focused new file when durable knowledge is absent.283. Skip and explain temporary, redundant, unsupported, or uncertain material.2930Preview file-level changes. Ask for confirmation when the root was inferred, cross-root access is involved, substantial text would be replaced, more than three files would be created, or relationships across multiple topics would change.3132## Update and Reconcile33341. State the new durable fact and evidence in one sentence before editing.352. Search all local memory filenames, names, descriptions, source identities, and distinctive claims for duplicates or conflicts.363. Determine current truth from the strongest available evidence; do not automatically prefer existing text or newer text.374. Update the smallest focused section. Preserve dated historical context when it explains the current state, mark superseded details explicitly, and keep unresolved contradictions in a short `Conflicts` or `Open Questions` section.385. Follow the contract exactly. Preserve or add structured provenance, keep local `related` filenames symmetric, and update `last_updated` only when durable content changes.396. Update `MEMORY.md` only when a file or its purpose changes, using the exact contract grammar.4041## Validate and Report4243Run:4445```text46python scripts/validate_memory.py <memory-root>47```4849Fix only errors introduced within the approved scope. Report evidence used, files changed, facts skipped, duplicate or conflict decisions, validation results, and remaining limitations. Recommend `audit-memory` after cross-file, index, relationship, or provenance changes.
ValentinNikolaev