ADR-NNNN: Title in the imperative ("Use X for Y")
- Status: Proposed | Accepted | Deprecated | Superseded by ADR-NNNN
- Date: YYYY-MM-DD
- Deciders: names or GitHub handles
- Issue / PR: #n
Context
Section titled “Context”What forces are at play? The problem, the constraints (technical, time, skills), and why a decision is needed now. Facts only; no solution yet.
Decision
Section titled “Decision”What we decided, in one or two sentences, in the active voice (“We use …”).
Alternatives considered
Section titled “Alternatives considered”For each serious alternative: what it is, its advantages, and why it was not chosen. At least two.
Consequences
Section titled “Consequences”What becomes easier, what becomes harder, what we must now do or maintain, and what would make us revisit this decision.