craft-adrlisted

Recording architectural decisions. Why we chose X over Y.
attac-t/the-foundry · ★ 1 · AI & Automation · score 55

Install: claude install-skill attac-t/the-foundry

# Skill: Craft ADR > "Decisions in code are temporary. Decisions in ADRs are permanent." ## The Standard 1. **Location**: `docs/{domain}/ADR/ADR-001-title.md`. 2. **Status**: Proposed → Accepted → Deprecated. 3. **Structure**: Context → Decision → Consequences. 4. **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](examples.md).