Skip to main content

[Number]. [Title in Imperative Voice]

Date: YYYY-MM-DD

Status​

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

Context​

What is the issue or problem we're addressing?

  • What requirements or constraints exist?
  • What alternatives were considered?
  • Why is this decision being made now?
  • What factors influenced this decision?

Decision​

What did we decide to do?

  • Be specific about the choice
  • Include any important implementation details
  • Explain how this will be applied

Consequences​

What are the outcomes of this decision?

Positive:

  • Benefit 1
  • Benefit 2

Negative:

  • Tradeoff 1
  • Tradeoff 2

Neutral (if applicable):

  • Other considerations

Mitigation (if applicable):

  • How we address negative consequences