Architecture Decision Record

Write an Architecture Decision Record.

Decision being recorded: {{DECISION}}
Why now: {{TRIGGER}}
Options considered: {{LIST}}
Chosen option: {{CHOICE}}

Format:
# ADR-{{NUMBER}}: {{TITLE}}

## Status
Proposed / Accepted / Deprecated / Superseded by ADR-{{N}}

## Context
What is the issue, why does it matter now, who is affected.

## Decision
The chosen option, in 1 to 2 paragraphs.

## Options considered
For each option: pros, cons, why rejected.

## Consequences
- Good: what this unlocks
- Bad: what this constrains or risks
- Followups: TODO items this creates

## Notes
Anything else (links to research, prior discussions).

Save as docs/adr/{{NUMBER}}-{{slug}}.md