Skip to main content

ADR-XXX: [Short Title]

Context

What is the issue we're facing and the context around it? What are we trying to achieve?

Decision

What is the change we're proposing/announcing?

Rationale

Why did we choose this approach? What alternatives did we consider?

Alternatives Considered

  1. Alternative 1: Description

    • Pros: ...
    • Cons: ...
    • Rejected because: ...
  2. Alternative 2: Description

    • Pros: ...
    • Cons: ...
    • Rejected because: ...

Consequences

Positive

  • What becomes easier
  • What capabilities do we gain

Negative

  • What becomes harder
  • What trade-offs are we making

Neutral

  • What stays the same
  • What new considerations emerge

Implementation Notes

Key technical details, gotchas, or migration steps.

// Example code if relevant

References

  • [Link to related ADRs]
  • [Link to external resources]
  • [Link to requirements docs]

Revision History

  • YYYY-MM-DD: Initial draft
  • YYYY-MM-DD: Accepted after review