ADR-NNNN: [Short Title Describing the Decision]

Status

[Proposed | Accepted | Deprecated | Superseded by ADR-XXXX]

Date

[YYYY-MM-DD]

Context

[Describe the situation. What problem are we solving? What constraints exist? What forces are at play? Be specific – include numbers, deadlines, team capabilities, and technical requirements where relevant.]

Decision

[State the decision clearly and concisely. Use active voice: “We will use X” not “X should be considered.”]

Alternatives Considered

[Alternative 1]

  • Pros: …
  • Cons: …
  • Why rejected: …

[Alternative 2]

  • Pros: …
  • Cons: …
  • Why rejected: …

Consequences

Positive

  • [What becomes easier or better]

Negative

  • [What becomes harder or worse]

Risks

  • [What could go wrong]
  • [Links to related ADRs]