Skip to content

ADR-NNNN: [Title]

Status

Proposed | Accepted | Deprecated | Superseded by ADR-XXXX

Date

YYYY-MM-DD

Context

What is the issue? Why do we need to decide?

Decision Drivers

  • Must: …
  • Should: …
  • Nice-to-have: …

Considered Options

Option A: …

  • Pros: …
  • Cons: …

Option B: …

  • Pros: …
  • Cons: …

Decision

We will use Option X because …

Consequences

Positive

Negative

Risks & Mitigations

  • Risk: … → Mitigation: …
  • ADR-XXXX: …
  • GA-N / F-N — decision, grey-area, or scope reference from the kickoff / scoping doc