← ClaudeAtlas

create-adrlisted

Create MADR-format Architecture Decision Record. Use when recording an architectural decision, documenting a technical choice, or creating an ADR.
amak07/acr-automotive · ★ 1 · Data & Documents · score 43
Install: claude install-skill amak07/acr-automotive
# 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