Skip to content

ADR-XXX: [Title]

Status: [Proposed | Accepted | Deprecated | Superseded] Date: YYYY-MM-DD Authors: [Author names] Reviewers: [Reviewer names]

Context

What is the issue that we're seeing that is motivating this decision or change? What is the context of this decision?

Decision

What is the change that we're proposing or have agreed to implement?

Rationale

Why are we making this decision? What are the driving factors?

Consequences

What becomes easier or more difficult to do and any risks introduced by this change?

Positive Consequences

  • [List positive outcomes]

Negative Consequences

  • [List negative outcomes or trade-offs]

Alternatives Considered

Alternative 1: [Name]

  • Description: [Brief description]
  • Pros: [Benefits]
  • Cons: [Drawbacks]
  • Reason for rejection: [Why not chosen]

Implementation Notes

Any specific implementation details, timeline, or migration considerations.

References

  • [Link to related issues, discussions, or documentation]

Template Usage Notes: - Replace XXX with sequential ADR number (001, 002, etc.) - Remove template usage notes before publishing - Use make adr-new title to create new ADRs from this template