# Architecture Decision Records

One file per decision: `NNNN-short-title.md`. Record the context, the decision, and the consequences. When a decision conflicts with [`CLAUDE.md`](../../CLAUDE.md), change the charter first (charter §18).

## Index

- _none yet_

<!-- Template:
## NNNN — Title
- **Status:** proposed | accepted | superseded by NNNN
- **Context:** what forced the decision
- **Decision:** what we chose
- **Consequences:** what this makes easy / hard
-->