One file per decision, numbered. Each says what was decided, why, and which test enforces it. Keep them short. When a decision changes, add a dated line to the log at the bottom of the ADR, or write a new ADR that supersedes it.
| ADR | Decision |
|---|---|
| 0001 | Context budget first: every token we put in a host’s context has to pay for itself |
| 0002 | Layered reads, no silent cuts |
| 0003 | Five tools: read, list, write, schema, read_skill |
| 0004 | Entity logic lives in its namespace; roots are frameworks |
| 0008 | Stay on MCP python-sdk 1.x for now; the 2.x port is known (proposed) |