playbook/outfitter-agents/plugins/outfitter/skills/architecture/references/adr-template.md

Architecture Decision Record Template

# 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}