Skip to content

ADR-[number]: [Title]

Status: [Proposed | Accepted | Deprecated | Superseded]

Date: YYYY-MM-DD

Decision Makers: [List of people involved in the decision]

Technical Story: [Optional: Link to related issue/story]

[Describe the context and problem statement. What is the issue that we’re seeing that is motivating this decision or change?]

  • [Driver 1: e.g., performance requirements]
  • [Driver 2: e.g., maintainability concerns]
  • [Driver 3: e.g., team expertise]
  • [Driver 4: e.g., cost considerations]
  • [Option 1]
  • [Option 2]
  • [Option 3]

Chosen option: “[Option X]”

[Describe why this option was selected. What are the expected positive outcomes?]

  • [Positive consequence 1]
  • [Positive consequence 2]
  • [Negative consequence 1]
  • [Negative consequence 2]
  • [Neutral consequence 1]

[Brief description of option 1]

Pros:

  • [Advantage 1]
  • [Advantage 2]

Cons:

  • [Disadvantage 1]
  • [Disadvantage 2]

[Brief description of option 2]

Pros:

  • [Advantage 1]
  • [Advantage 2]
  • [Advantage 2]

Cons:

  • [Disadvantage 1]
  • [Disadvantage 2]

[Brief description of option 3]

Pros:

  • [Advantage 1]
  • [Advantage 2]
  • [Advantage 2]

Cons:

  • [Disadvantage 1]
  • [Disadvantage 2]

[Optional: Describe the implementation plan, timeline, and any specific technical details]

  • [Link to related ADR 1]
  • [Link to related ADR 2]
  • [Link to resource 1]
  • [Link to resource 2]
  • [Link to resource 3]

[Any additional notes, follow-up items, or context that doesn’t fit elsewhere]