Skip to main content

MEMORY.md compact index contract — MC #101645

MC #101645 — MEMORY.md compact index contract

Status: implemented locally with deterministic line-count guard.

Contract

  • ~/.claude/projects/-Users-makinja/memory/MEMORY.md is an index, not a fact dump.
  • Maximum size: 50 lines.
  • Detailed facts belong in separate memory memo files, BookStack pages, MC evidence, or LightRAG.
  • Global-critical facts may be linked from MEMORY.md, but should not be expanded inline.

Implementation evidence

  • Current MEMORY.md line count: 41.
  • Pre-compaction snapshot: ~/.claude/projects/-Users-makinja/memory/_archive/MEMORY-pre-101645-20260521T113803Z.md.
  • Guard: ~/.claude/hooks/memory-size-gate.sh.
  • Git pre-commit hook: ~/.claude/.git/hooks/pre-commit invokes the guard.

Recovery

If a needed fact appears missing from the compact index, query deep memory with node ~/system/tools/discover.js memory "topic" or inspect the pre-compaction snapshot.

No comments to display

Back to top