ADR-XXX: [Title]

Status: [Proposed | Accepted | Deprecated | Superseded] Date: YYYY-MM-DD Deciders: [List of people involved] Related: [Links to related ADRs]

Context

What is the problem we're trying to solve? What are the constraints?

Decision

What did we decide to do?

Rationale

Why did we choose this over alternatives?

Alternatives Considered

Option 1: [Name]

Pros:

• Advantage 1
• Advantage 2

Cons:

• Disadvantage 1
• Disadvantage 2

Verdict: ❌ Rejected - [Reason]

Option 2: [Name] (SELECTED)

Pros:

• ✅ Advantage 1
• ✅ Advantage 2

Cons:

• Disadvantage 1 (mitigated by X)

Verdict: ✅ SELECTED

Consequences

Positive:

• Benefit 1
• Benefit 2

Negative:

• Tradeoff 1
• Tradeoff 2

Mitigations:

• How we address negative consequences

Implementation Notes

Any specific implementation details or gotchas.

References

• External links (e.g., package documentation, blog posts, RFCs)
• Internal docs (e.g., /architecture/backend, /guides/deployment)