Skip to content

ADR-[number]: [Decision Title]

Status

Proposed | Accepted | Deprecated | Superseded by ADR-XXX

Date

YYYY-MM-DD

Context

What is the issue or situation that motivates this decision? Describe the forces at play (technical, business, organizational). What problem are we trying to solve?

Decision

What is the change that we're proposing and/or doing? State the decision clearly and concisely.

Consequences

Positive

  • Benefit 1
  • Benefit 2

Negative

  • Trade-off 1
  • Trade-off 2

Neutral

  • Side effect that is neither positive nor negative

Alternatives Considered

Option 1: [Name]

  • Description: What this option entails
  • Pros: Benefits
  • Cons: Drawbacks
  • Why not chosen: Rationale

Option 2: [Name]

  • Description:
  • Pros:
  • Cons:
  • Why not chosen:

Implementation Notes

How will this decision be implemented? Any specific steps, timeline, or dependencies.

Review Date

When should this decision be revisited? (e.g., 6 months, after next release)

  • Link to technical specs, solution docs, or other ADRs.