ADR: Short title
- Status: proposed | accepted | superseded | deprecated
- Date: YYYY-MM-DD
- Supersedes / Superseded by: (optional links)
Context
What forces or constraints make a decision necessary? Cite existing docs or code when possible.
Decision
The choice we are making, in one short paragraph (or a tight bullet list).
Consequences
What becomes easier, harder, or explicitly out of scope.
Sources
Links to README, concepts, experiments, PRs, or code that already support this decision.