Understand, write it down, get it back

Understand, write it down, get it back A sequence diagram generated by Archify. map(repo) The shape first: files, symbols, entry points. shape of the codebase find(concept) where it lives explain(symbol) signature, callers, callees neighbors(symbol) what it touches read(symbol) Source only when structure is not enough. exact source exact lines Breakpoints, device tables, the authority test. the numbers store_memory(evidence) Files, lines, source, tags, retention. store_decision(rationale) Rejected alternatives; linked to the evidence. decision + supports edge hybrid_search(task) No shared context with Session A. the gotcha and the decision verify the claim at source A memory is a claim to check, not a fact. confirmed in the current code Understand Write it down Get it back Session A · a new repo · Sequence participant Session A a new repo MIMIR² · comprehension · Sequence participant MIMIR² comprehension Repository · source files · Sequence participant Repository source files Ogham · memory · Sequence participant Ogham memory Session B · a different agent · Sequence participant Session B a different agent Legend result tool call

Understand

  • • Structure first: map, find, explain, neighbors, read
  • • Exact lines only to confirm the numbers

Write it down

  • • Evidence first, then the decision that cites it
  • • Source, tags and retention on both

Get it back

  • • A different session recalls the decision by meaning
  • • and verifies it against the code before relying on it