Skip to main content

ADR-XXX: [Title of Decision]

Date: YYYY-MM-DD Status: [Proposed | Accepted | Deprecated | Superseded] Implements: [Version or feature if applicable] Related: [Links to related ADRs, lessons, KG entries]

Context​

[Describe the situation that requires a decision]

Problem:

  • [What needs to be decided]
  • [Why it matters]
  • [Who is affected]

Scope:

  • [What's in scope]
  • [What's out of scope]
  • [Constraints or limitations]

Decision​

[State the decision clearly and concisely]

Core Components​

  1. [Component 1]: [Description]
  2. [Component 2]: [Description]
  3. [Component 3]: [Description]

Implementation Approach​

[How this decision will be implemented]

Rationale​

[Explain why this decision was made]

Why This Approach​

  1. [Reason 1]: [Explanation]
  2. [Reason 2]: [Explanation]
  3. [Reason 3]: [Explanation]

Alternatives Considered​

Option A: [Name]

  • Pros: [List]
  • Cons: [List]
  • Rejected because: [Reason]

Option B: [Name]

  • Pros: [List]
  • Cons: [List]
  • Rejected because: [Reason]

Trade-offs​

Benefits:

  • ✅ [Benefit 1]
  • ✅ [Benefit 2]

Costs:

  • ❌ [Cost 1]
  • ❌ [Cost 2]

Mitigation:

  • [How costs are mitigated]

Consequences​

[Describe the impact of this decision]

Positive​

  1. [Impact 1]: [Description]
  2. [Impact 2]: [Description]

Negative​

  1. [Impact 1]: [Description]
  2. [Impact 2]: [Description]

Neutral​

  1. [Change 1]: [Description]

Implementation​

Timeline: [When this was/will be implemented]

Affected Components:

  • [Component 1]
  • [Component 2]

Migration Path: [If applicable, how to transition from old approach]

Validation​

Success Criteria:

  • [Criterion 1]
  • [Criterion 2]

Metrics:

  • [Metric 1]: [Target value]
  • [Metric 2]: [Target value]

Review Date: [Date to reassess this decision]

Knowledge Graph:

Lessons Learned:

Implementation:

  • [Link to code, config, or documentation]

Future Considerations​

  1. [Consideration 1]: [What might change this decision]
  2. [Consideration 2]: [Monitoring needed]

Decision Made: YYYY-MM-DD Last Updated: YYYY-MM-DD Status: [Current status]