# Architecture Decision Record Template ```markdown # ADR-XXX: {TITLE} **Status**: [Proposed | Accepted | Deprecated | Superseded] **Date**: YYYY-MM-DD **Deciders**: {WHO} **Context**: {PROBLEM} ## Decision {WHAT_WE_DECIDED} ## Alternatives Considered ### Option 1: {NAME} - **Pros**: {BENEFITS} - **Cons**: {DRAWBACKS} - **Why not chosen**: {REASON} ### Option 2: {NAME} - **Pros**: {BENEFITS} - **Cons**: {DRAWBACKS} - **Why not chosen**: {REASON} ## Consequences **Positive**: - {BENEFIT_1} - {BENEFIT_2} **Negative**: - {TRADEOFF_1} - {TRADEOFF_2} **Neutral**: - {IMPACT_1} - {IMPACT_2} ## Implementation Notes - {TECHNICAL_DETAIL_1} - {TECHNICAL_DETAIL_2} - {MIGRATION_PATH} ## Success Metrics - {HOW_MEASURE_SUCCESS} - {WHAT_METRICS_TRACK} ## Review Date {WHEN_REVISIT} ```