Skill: 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.