craft-adr
Recording architectural decisions. Why we chose X over Y.
SKILL.mdplugins/kernel/skills/craft-adr/SKILL.md
GitHubSkill: Craft ADR
"Decisions in code are temporary. Decisions in ADRs are permanent."
The Standard
- Location:
docs/{domain}/ADR/ADR-001-title.md. - Status: Proposed → Accepted → Deprecated.
- Structure: Context → Decision → Consequences.
- Rationale: Document what was rejected and why.
When to Record
| Record | Don't Record |
|---|---|
| Package choice | Trivial fixes |
| Pattern choice | Standard CRUD |
| Schema design | Config changes |
| Integration approach | Obvious decisions |
Real-World Examples
See examples.md.