create-adrlisted
Install: claude install-skill majiayu000/claude-skill-registry-data
# 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