What problem does it solve? Project memory stores grow monotonically because every session can append entries but nothing ever demotes or removes them, leading to bloated indexes, duplicate facts, and stale pointers that every session pays for in injected context. ## Core Features & Use Cases - Survey-driven audit: Runs a memory survey script to surface dead index links, orphaned files, near-duplicates, and unreferenced entries, then reads each candidate before judging it. - Four-part proposal: Emits a diff under Merge, Retire, Re-verify, and Promote headings, with evidence (overlap scores, file:line citations, dates) for every entry. - Safe retirement: Moves retired entries to memory/archive/ with a pointer in archive/README.md instead of deleting them, so a wrong call is one git mv away from reversal. - Promotion and ownership checks: Identifies entries that should become executable checks (pytest guards, prek hooks) or move into a single agent's own memory directory. - Use Case: When the SessionStart hook reports MEMORY.md is over its line cap, run this pass as a standalone session to produce a shrink proposal the operator applies by hand. ## Quick Start Run a memory consolidation pass over the project memory store and propose which entries to merge, retire, re-verify, or promote.
