Skip to content

Architecture Decision Record Template

ADR-XXXX: [Brief title describing the decision]

Status

  • Proposed
  • Accepted
  • Deprecated
  • Superseded

Context

Describe the issue or problem that motivated this decision. Include: - Background information - Constraints - Assumptions - Stakeholders affected

Decision

Describe what we will do and why we chose this approach.

Considered Alternatives

List other options evaluated and why they were rejected:

  1. Alternative 1
  2. Pros:
  3. Cons:

  4. Alternative 2

  5. Pros:
  6. Cons:

Consequences

Positive

  • Benefit 1
  • Benefit 2

Negative

  • Trade-off 1
  • Trade-off 2

Neutral

  • Side effect 1

Implementation Notes

  • How to implement this decision
  • Dependencies and timeline
  • Migration path (if replacing previous approach)

References

  • Related issues/PRs: #123, #124
  • External documentation: [link]
  • Related ADRs: ADR-0001, ADR-0002

Revision History

Date Author Change
YYYY-MM-DD Name Initial proposal