ADR-NNNN:

NOTE

Template. Copy to docs/adr/NNNN-title.md. One decision per record, 1–2 pages. The practice is in the Architecture chapter.

  • Status: proposed | accepted | superseded by ADR-XXXX
  • Date: YYYY-MM-DD

Context

What's the situation and the forces at play? What makes this decision necessary?

Decision

What we're doing, in the active voice: "We will …"

Consequences

What becomes easier or harder as a result — the trade-offs we're accepting.