Skip to content

ADR-XXXX: [title]

Author: @author Status: [Draft | Proposed | Accepted | Rejected | Deprecated | Superseded by ADR-XXXX] Date: YYYY-MM-DD Deciders: @name1, @name2, @name3 Technical Story: [optional link to ticket/issue] Tags: [tag1, tag2, tag3]

Context

  • [Description of the problem space and why a decision needs to be made]
  • [What is the issue that we're seeing that is motivating this decision or change?]

Decision

[Description of the solution/approach being chosen or What is the change that we're proposing and/or doing?]

For now: - [Placeholder for current implementation approach] - [Placeholder for immediate next steps] - [Placeholder for temporary measures]

Rationale

[Why is this the right decision given our architectural pillars?]

Rationale Pillars

Why [title] ([status])

  • Pillar 1 (e.g., Stability and Support)
  • Supporting detail 1

  • Supporting detail 2

  • Pillar 2 (e.g., Ecosystem Readiness)

  • Supporting detail 1

  • Supporting detail 2

  • Pillar 3 (e.g., Team Proficiency and Velocity)

  • Supporting detail 1

  • Supporting detail 2

  • Pillar 4 (e.g., Modern Features without migration burden)

  • Supporting detail 1

  • Supporting detail 2

  • Pillar 5 (e.g., Risk Management)

  • Supporting detail 1

  • Supporting detail 2

  • Pillar 6 (e.g., Upgrade Path Considerations)

  • Supporting detail 1
  • Supporting detail 2

Deferred Alternatives

[What alternatives are we deferring for future consideration?]

Alternative: [Name] - Trigger: [What condition would make us reconsider this?] - Timeline: [When should we revisit this?] - Reason for deferral: [Why not now?]

Alternative: [Name] - Trigger: [What condition would make us reconsider this?] - Timeline: [When should we revisit this?] - Reason for deferral: [Why not now?]

Rejected Alternatives

[What alternatives are we rejecting?]

  • Alternative X: Brief description and reason for rejection
  • Alternative Y: Brief description and reason for rejection

Consequences

[What becomes easier or more difficult to do because of this change?]

Positive: - Benefit 1 - Benefit 2 - ...

Negative: - Risk 1 - Risk 2 - ...

Mitigation Strategies: - ... - ...

Revisit Triggers

  • Condition 1 (e.g., ecosystem certification, measurable benefit)
  • Condition 2 (e.g., scheduled upgrade window with regression capacity)

Target Sprint for Formal Decision

  • Target Sprint: Sprint N (or timeframe) for adoption/change

Guardrails

Must

  • Critical requirements that cannot be compromised
  • Non-negotiable constraints

Should

  • Important considerations that should be followed unless there's strong justification
  • Best practices and preferred approaches

Won't

  • Explicit exclusions and out-of-scope items
  • Things we deliberately choose not to do

Approvals

Review Reviewer Date (YYYY-MM-DD) Status Notes
Architectural Review Pending
Security Review Pending
SRE Review Pending

Review Before Deciding:
- Performance benchmarks: /docs/benchmarks/api-performance.md
- Security guidelines: /docs/security/security-guidelines.md
- Architecture principles: /docs/architecture/principles.md
- Technology radar: /docs/tech-radar/technology-radar.md
- Cost analysis framework: /docs/cost-analysis/framework.md
- Scalability patterns: /docs/patterns/scalability-patterns.md
- Monitoring standards: /docs/monitoring/standards.md
- Compliance requirements: /docs/compliance/requirements.md

Technology Landscape: [Link to relevant technology documentation]

Product/PRD: [Link to product requirements document]

Sprint Plan:[Link to sprint planning documentation]

Related ADRs:
- [Link to related ADR]
- [Link to related ADR]