ADR-XXX: [Decision Title]

Status: [Proposed | Accepted | Deprecated | Superseded by ADR-XXX]

Date: [YYYY-MM-DD]

Authors: [Names]

Reviewers: [Names for architecture decisions]

Context

[Describe the business or technical context that led to this decision. Include:]

• Current situation
• Problems to solve
• Constraints or requirements
• Key stakeholders affected

Decision

[State the decision clearly and concisely. Include:]

• What we decided to do
• Key alternatives considered
• Why this option was chosen

Consequences

Positive

• [List benefits and positive outcomes]
• [Impact on performance, maintainability, etc.]

Negative

• [List drawbacks and risks]
• [Technical debt or limitations introduced]

Neutral

• [Changes that are neither positive nor negative]

Implementation Notes

[Technical details for implementing this decision:]

• Configuration changes needed
• Migration steps required
• Timeline for implementation
• Dependencies on other systems

Related Decisions

• [Link to related ADRs]
• [Reference relevant architecture docs]

---

Template Usage

1. Copy this template to docs/architecture/decisions/
2. Rename with format: ADR-001-decision-title.md
3. Fill in all sections
4. Add link to navigation in mkdocs.yml
5. Submit for review (architecture changes require principal engineer approval)