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

56 lines
797 B
Markdown

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