Skip to content

Architecture Decision Record (ADR) Template

[Short, descriptive title of the decision]

ADR Number: [Incremental number]
Date: [YYYY-MM-DD]
Status: [Proposed | Accepted | Rejected | Deprecated | Superseded]

Context

  • Describe the background of the decision, including the problem or opportunity.
  • Explain why this decision is being made (business, technical, or operational drivers).

Assumptions

  • List any assumptions that are made in this decision.

Constraints

  • List any constraints that are relevant to this decision.

Risks

  • Include any risks or uncertainties that could affect this decision.

Dependencies

  • Mention any dependencies that could impact this decision.

Decision

  • Clearly state the chosen solution or approach.
  • Justify why this decision was made over alternatives.
  • If applicable, provide diagrams or references to architecture models.

Alternatives Considered

  • List and briefly describe alternative options that were evaluated.
  • Explain the pros and cons of each alternative.
  • Include why these alternatives were not chosen.

Consequences

  • Positive Impacts: What benefits does this decision bring?
  • Negative Impacts/Risks: What potential downsides exist, and how can they be mitigated?
  • Technical Debt: Will this introduce any long-term challenges?
  • Describe how this decision will be implemented.
  • Include timelines, key milestones, and responsibilities.
  • Mention any tooling, frameworks, or integrations required.
  • Reference any prior ADRs that relate to or influence this decision.
  • Link to any future ADRs that modify or supersede this one.

References (If applicable)

  • Include links to supporting documentation, RFCs, architecture diagrams, or relevant discussions.