Skip to content

Template 04

ADR-000: Title of Architecture Decision

🔖 Status

Status: proposed | accepted | rejected | deprecated | superseded by [ADR-XXX](link-to-adr)

Date: YYYY-MM-DD

🧭 Context

Business Context

Brief description of the business situation driving this decision

Technical Context

Brief description of the technical environment and constraints

❓ Problem Statement

Concise description of the architectural issue that needs to be addressed

📐 Decision Drivers

Business Drivers

  • Driver 1
  • Driver 2

Technical Drivers

  • Driver 1
  • Driver 2

⛓ Constraints

  • Constraint 1
  • Constraint 2

🎯 Objectives

  • Objective 1
  • Objective 2

⚖ Forces

  • Force 1 (pressure/influence on the decision)
  • Force 2

💡 Solutions Considered

Solution 1: Title

Description: Brief description of the solution

Pros:

  • Pro 1
  • Pro 2

Cons:

  • Con 1
  • Con 2

Mitigation Strategies:

  • Strategy 1 for Con 1
  • Strategy 2 for Con 2

Solution 2: Title

Description: Brief description of the solution

Pros:

  • Pro 1
  • Pro 2

Cons:

  • Con 1
  • Con 2

Mitigation Strategies:

  • Strategy 1 for Con 1
  • Strategy 2 for Con 2

⚖ Trade-off Analysis

Technical Trade-offs

Criteria Solution 1 Solution 2
Criteria 1 Rating Rating
Criteria 2 Rating Rating
Criteria 3 Rating Rating

Business Trade-offs

Criteria Solution 1 Solution 2
Cost Rating Rating
Time-to-market Rating Rating
Scalability Rating Rating

✅ Decision

Chosen Solution: Solution X

Justification

Technical and business reasoning for the chosen solution

  • Key reason 1
  • Key reason 2

➡ Consequences

Positive

  • Consequence 1
  • Consequence 2

Negative

  • Consequence 1
  • Consequence 2

Neutral

  • Consequence 1
  • Consequence 2

👣 Implementation Notes

  • Note 1
  • Note 2

📝 Notes and References