.memory

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# .memory

The project's durable record, committed to the repository on purpose.

| File | What it is | How it is maintained |
| --- | --- | --- |
| `summary.md` | A snapshot of the present: what this is, how it is built, the decisions in force | **Edited in place.** Only what a session establishes or invalidates changes; the rest is left byte for byte. |
| `history.md` | One dated entry per session, in order | **Append only.** Never rewritten, never tidied. A history you edit is not a history. |
| `handoffs/` | One file per session: state, work in flight, next steps, traps | Written at the end of a session. Never overwrite somebody else's. |

`.memory/` is for whoever *continues building* this. `docs/` is for whoever *uses* it. Keep the two apart.