template
Type
External
Status
Published
Created
Jul 4, 2026
Updated
Jul 4, 2026
Source
View

ADR-NNNN: [Decision Title]#

Date: YYYY-MM-DD
Status: proposed | accepted | deprecated | superseded by ADR-NNNN
Deciders: [who was involved]

Context#

What is the issue that we're seeing that is motivating this decision or change?

[2-5 sentences describing the situation, constraints, and forces at play]

Decision#

What is the change that we're proposing and/or doing?

[1-3 sentences stating the decision clearly]

Alternatives Considered#

Alternative 1: [Name]#

  • Pros: [benefits]
  • Cons: [drawbacks]
  • Why not: [specific reason this was rejected]

Alternative 2: [Name]#

  • Pros: [benefits]
  • Cons: [drawbacks]
  • Why not: [specific reason this was rejected]

Consequences#

Positive#

  • [benefit 1]

Negative#

  • [trade-off 1]

Risks#

  • [risk and mitigation]
template | Dosu