Skip to content

[ADR Number]: [Brief Title]

  • Status: open for review | accepted | rejected | deprecated | superseded by [ADR-NNNN]
  • Date: YYYY-MM-DD
  • Decision Makers: [List of people involved]
  • Tags: [e.g., backend, infrastructure, security]

Context

[Describe the context and problem statement. What forces are at play? What are the constraints?]

Decision

[State the decision clearly. Use active voice: "We will..."]

Rationale

[Explain why this decision was made. What are the benefits? What trade-offs were accepted?]

Consequences

Positive

  • [Benefit 1]
  • [Benefit 2]

Negative

  • [Drawback 1]
  • [Drawback 2]

Neutral

  • [Change 1]
  • [Change 2]

Alternatives Considered

Option 1: [Name]

[Brief description]

Rejected because: [Reason]

Option 2: [Name]

[Brief description]

Rejected because: [Reason]

  • [ADR-NNNN]: [Related decision]
  • [RFC-NNNN]: [Related proposal]

Notes

[Any additional notes, links, or references]