// Generate Architecture Decision Records (ADRs) to document significant architectural decisions. Use when making important technical decisions that need documentation.
| name | doc-generate-adr |
| description | Generate Architecture Decision Records (ADRs) to document significant architectural decisions. Use when making important technical decisions that need documentation. |
| mcp_fallback | none |
| category | doc |
Create Architecture Decision Records for technical decisions.
./scripts/create_adr.sh "Decision Title"
# Creates: docs/adr/ADR-XXX-decision-title.md
All ADRs follow this structure:
# ADR-XXX: Title
**Status**: Proposed | Accepted | Deprecated | Superseded
**Date**: YYYY-MM-DD
**Deciders**: Names/roles
## Context
What is the issue we're facing?
## Decision
What decision are we making?
## Rationale
Why this decision? Key reasons.
## Consequences
### Positive
- Benefit 1
### Negative
- Drawback 1
### Neutral
- Other impact 1
## Alternatives Considered
### Alternative 1
Why not chosen.
docs/adr/
โโโ ADR-001-language-selection.md
โโโ ADR-002-testing-strategy.md
โโโ README.md
| Issue | Fix |
|---|---|
| Missing context | Add background and constraints |
| Unclear decision | Make decision more specific |
| Missing alternatives | Document at least 2 alternatives |
| No consequences | Think through positive and negative impacts |
/docs/adr/ for examplesphase-plan-generate for planning