Memory Ready Score

July 20, 2026 · View on GitHub

Public contract for memory-audit.

Same ritual as Loop Ready / Fleet Ready:

node tools/memory-audit/cli.js . --suggest
# later: npx @cobusgreyling/memory-audit . --suggest

Levels

LevelScoreMeaningSafe behavior
M00–39Ad-hoc memoryChat history only; no shared policy
M140–64StructuredScratch + episodic files; no auto durable
M265–84BudgetedRecall caps + hygiene loop
M385–100Gated durableVerifier/human promotion + CI dogfood

CI examples:

node tools/memory-audit/cli.js . --min-score=40   # M1
node tools/memory-audit/cli.js . --min-score=65   # M2

Weights (v0)

Base 10.

SignalPoints
MEMORY.md posture+16
MEMORY-STATE.md+14
Tiers documented in MEMORY.md+8
memory-write skill+8
memory-recall skill+8
memory-hygiene skill+8
memory-verifier skill+8
memory-budget.md+10
memory-constraints.md+6
memory-run-log.md+4
Confidence tags in use+4
GitHub audit workflow+4
Patterns registry present+2

Penalties:

IssuePenalty
Durable section without any owner/evidence hints−8
Memory files mention secrets patterns−15
STATE.md > 100KB with no MEMORY split−5

Human output template

Memory Ready: 47/100  ·  M1 structured

OK
  MEMORY.md present
  MEMORY-STATE.md present
  memory-write skill
  memory-recall skill

WARN
  Missing memory-budget.md
  Missing memory-hygiene skill

Suggested actions
  node tools/memory-init/cli.js . --pattern retrieval-budget
  node tools/memory-init/cli.js . --pattern memory-hygiene-loop

Climb path

  1. memory-init --pattern session-scratchpad → ~M1
  2. Add episodic + budget → mid M1 / low M2
  3. Hygiene loop + verifier → M2
  4. Durable store with gates + CI → M3