Architecture Decision Record (ADR) Template

Last updated:

Status values: Proposed (under consideration) · Accepted (approved and in effect) · Superseded (replaced — link to the new ADR) · RFC (open for feedback until a deadline)

# [Number]. [Title]

**Status**: [Proposed | Accepted | Superseded | RFC (deadline: YYYY-MM-DD)]

**Context**:
[Describe the situation, problem, and forces at play. What alternatives did you consider? What constraints exist?]

**Decision**:
We will [clear, specific statement of the decision].

[Justification: Why does this decision make sense given the context? What business value does it provide?]

**Consequences**:

**Pros**:
- [Benefit with specific metrics where possible]
- [Benefit]
- [Benefit]

**Cons**:
- [Trade-off or cost]
- [Trade-off or cost]
- [Trade-off or cost]

**Compliance**:
[How will adherence be measured? What tools or processes ensure compliance?]

**Notes**:
- Author: [Name]
- Date: [YYYY-MM-DD]
- Approved by: [Name/Role]
- Supersedes: [Link to previous ADR if applicable]
- Superseded by: [Link to newer ADR if applicable]

Found this useful? Share it:

Share on LinkedIn