Architecture Decisions¶
Records of the decisions that shape this project, and — more usefully — the reasons behind them. An ADR is written when a choice is hard to reverse or likely to be re-proposed.
The point is not the decision; it is the alternatives that were rejected and why. A record that only states the outcome saves nobody the argument.
A decision is changed by writing a new ADR that supersedes the old one, never by editing the old one. The history is the value.
Format¶
NNN-kebab-case-title.md, numbered in the order written, with the sections:
- Status — Proposed, Accepted, or Superseded by ADR-NNN
- Context — the forces in play, before any decision
- Decision — what was decided
- Consequences — what this costs, including what it makes harder