Library / Templates / Architecture decision record
EDITABLE DESIGN TOOL

Architecture decision record

Record an important choice with alternatives, forces, consequences and verification.

ADR-[000]: [decision, not topic]

Status: Proposed | Accepted | Rejected | Superseded
Date: [YYYY-MM-DD]
Owner / decision maker: [role]
Related capabilities / patterns: [references]
Supersedes: [ADR or none]

Context and forces

What problem or constraint makes this choice necessary now? Include measurable quality needs.

Decision drivers

  1. [Driver / ranked priority]
  2. [Driver]
  3. [Driver]

Options considered

Option Advantages Costs / risks
A. [name]
B. [name]
C. Keep current

Decision

We will [specific choice], owned by [team], within [boundary], because [primary rationale].

Consequences and trade-offs

Benefits: ...
Costs / constraints accepted: ...
Reversibility / exit: ...

Verification and triggers

  • Evidence or test that proves the decision works:
  • Metric / SLO:
  • Revisit when:

Links

  • Context or component diagrams:
  • Threat model / impact assessment:
  • Related or superseding ADRs: