ADR

One file per significant decision in docs/adr/, numbered 0001-short-title.md. Never edit an accepted ADR’s decision; supersede it with a new one.

docs/adr/NNNN-title.md

# ADR-NNNN: <short decision title>

**Status:** proposed | accepted | superseded by ADR-XXXX · **Date:** YYYY-MM-DD · **Decider:** <name>

## Context
<What situation or requirement forces a decision? Constraints, forces, facts (with links).>

## Options considered
1. **<Option A>** — pros / cons
2. **<Option B>** — pros / cons
3. **Do nothing** — pros / cons

## Decision
<What we chose, in one or two sentences.>

## Consequences
- Positive: …
- Negative / costs: …
- Follow-ups: …

## Devbook deviation (only if this loosens a devbook rule)
- Rule: <link to the devbook page and rule>
- Why it does not fit here: …
- Compensating controls: …
- Review date: YYYY-MM-DD