07_decisions/

Architecture/Decision Records (ADRs). One decision per file, numbered.

File naming: NNNN-slug.md (4-digit zero-padded, e.g. 0004-grant-staging.md). Frontmatter type: decision.

Shape: Context → Decision → Consequences → Timeline. Use _TEMPLATE.md.

Why ADRs: they make "why did we do it this way?" answerable months later. The compiled-truth section can be refined; the timeline records when and why.

Owner: Matt + Patrik review (07_decisions/ in CODEOWNERS).

---

How to add a decision

1. cp _TEMPLATE.md NNNN-<slug>.md using the next number.
2. Fill frontmatter + Context / Decision / Consequences.
3. Append a Timeline entry dated today with the source.
4. make verify, commit, open a PR (bot/adr-NNNN-<slug>). Never push to main.