create-adr

# ADR Creation Skill ## Purpose Create Architecture Decision Records (ADRs) using the **MADR** (Markdown Any Decision Records) format. ADRs capture important architectural decisions and their context for future reference. ## Smart Interaction ### ASK the User When: - **Creating new ADR**: Confirm ADR number (auto-suggest next available) - **Deleting ADR**: Always confirm, suggest "Deprecated" status instead - **Superseding ADR**: Confirm which ADR is being replaced ### PROCEED Autonomously When: - **Updating existing ADR**: Add consequences discovered during implementation - **Linking ADRs**: Add related ADR links - **Fixing typos**: Non-destructive corrections - **Updating status**: Proposed → Accepted after team approval ## Instructions When creating an ADR: 1. **Find the next ADR number** by checking `/docs/architecture/decisions/` 2. **Use the MADR template** at `templates/madr.md` 3. **Output to** `/docs/architecture/decisions/NNNN-[kebab-case-title].md` ## Template Use the template at: `.claude/skills/create-adr/templates/madr.md` ## ADR Naming Convention Format: `NNNN-kebab-case-title.md` Examples: - `0001-use-supabase-for-database.md` - `0002-tanstack-query-for-state.md` - `0003-fumadocs-for-documentation.md` ## Status Definitions | Status | Meaning | | ---------- | --------------------------------------- | | Proposed | Under discussion, not yet decided | | Accepted | Decision has been made and applies ...