Skip to content

ADR-XXXX: [Decision Title]

Status

[Proposed | Accepted | Superseded by ADR-YYYY | Deprecated]

Context

Describe the architectural problem or decision that needs to be made. Include:

  • The current situation
  • The forces at play
  • What constraints exist
  • Why this decision is needed

Decision

State the architectural decision that was made clearly and concisely.

Rationale

Explain why this decision was made. Include:

  • What alternatives were considered
  • Why this option was chosen over others
  • What trade-offs were made
  • What benefits this decision provides

Consequences

Describe the consequences of this decision:

Positive

  • Benefits gained
  • Problems solved
  • Capabilities enabled

Negative

  • New limitations introduced
  • Complexity added
  • Potential risks

Neutral

  • Changes that are neither clearly positive nor negative

Implementation Notes

Any specific implementation details, patterns, or guidelines that follow from this decision.

  • Links to other ADRs that relate to this decision
  • Dependencies or decisions that this supersedes

Date

YYYY-MM-DD