Skip to content

ADR [NNNN]: [Title]

Status: [Proposed | Accepted | Deprecated | Superseded by ADR-XXXX]
Date: [YYYY-MM-DD]
Authors: [Name(s)]

Context

Describe the issue or decision that prompted this ADR. Include: - Background and motivation - Constraints and requirements - Why this decision is significant

Decision

State the architectural decision clearly and concisely. What was chosen?

Consequences

Positive

  • What benefits does this decision provide?
  • What problems does it solve?

Negative

  • What trade-offs are introduced?
  • What becomes harder or more expensive?

Neutral

  • What aspects are neither good nor bad but important to be aware of?

Alternatives Considered

List other options that were evaluated:

Alternative 1: [Name]

  • Pros:
  • Cons:
  • Why rejected:

Alternative 2: [Name]

  • Pros:
  • Cons:
  • Why rejected:

Implementation Notes

Any implementation guidance: - Configuration examples - Related tools/technologies - Integration points - Known issues or workarounds

References

  • Links to relevant documentation
  • Related ADRs
  • External resources

Approval

  • Approved by: [Name(s)]
  • Date: [YYYY-MM-DD]

History

Date Status Notes
2026-04-24 Proposed Initial proposal