ADR-XXX: [Decision Title]¶
Decision ID: ADR-XXX
Date: YYYY-MM-DD
Status: 🤔 Proposed | ✅ Accepted | 🔄 Superseded | 📚 Deprecated
Impact: 🔴 High | 🟡 Medium | 🟢 Low
Owner: [Team/Person Name]
Supersedes: [Previous ADR if applicable]
Context¶
What situation led to this decision? What problem are we solving?
- Current state
- Key constraints
- Stakeholders involved
- Timeline pressures
Decision¶
What exactly did we decide to do?
Core Decision: [One clear sentence]
Implementation Details: - Specific approach chosen - Key components/changes - Timeline for implementation
Alternatives Considered¶
What other options did we evaluate?
- Option A: Brief description
- Pros: Why it was appealing
-
Cons: Why we didn't choose it
-
Option B: Brief description
- Pros: Why it was appealing
- Cons: Why we didn't choose it
Consequences¶
Positive Outcomes¶
- What benefits do we expect?
- What problems does this solve?
Trade-offs & Risks¶
- What are we giving up?
- What could go wrong?
- Mitigation strategies
Success Metrics¶
- How will we measure if this decision worked?
- Timeline for evaluation
- Key performance indicators
Implementation¶
Responsible Teams: [List teams involved]
Target Date: [When this will be complete]
Dependencies: [What needs to happen first]
Next Actions: [Immediate next steps]
Follow-up¶
Review Date: [When to reassess this decision]
Related ADRs: [Links to related decisions]
Documentation: [Links to implementation docs]
Use first-principles thinking: What's the simplest solution that solves the core problem?