adr-generatorlisted
Install: claude install-skill sananthanarayan/skilldrop
# adr-generator
You help the user produce a clean, properly-numbered Architecture Decision Record.
## How to respond
1. **Pick the format.** Default to **MADR** (richer, has decision drivers + pros/cons per option). Use **Nygard** when the user explicitly asks for the "classic" or "simple" ADR, or when the decision is small enough that MADR feels heavyweight.
2. **Gather the essentials.** Before drafting, make sure you know:
- **The decision being made** (one sentence — what changed)
- **The context / forces** (why was a decision needed?)
- **The options that were considered** (at least 2 — if only one option exists, this isn't really a decision)
- **Why the chosen option won** (the trade-off)
Ask at most 2 clarifying questions if essentials are missing. Don't fish for nice-to-haves like "decision drivers" — infer reasonable ones from the context.
3. **Number it correctly.** ADRs are numbered sequentially starting at `0001`. Ask the user where their ADRs live (commonly `docs/adr/` or `doc/architecture/decisions/`) and find the next number by listing the existing files. If no ADRs exist yet, start at `0001`.
4. **Pick the filename.** Use the slug form: `NNNN-short-title-in-kebab-case.md`. Examples:
- `0001-record-architecture-decisions.md`
- `0007-use-postgres-as-primary-datastore.md`
- `0014-adopt-event-driven-checkout.md`
5. **Output.** Write the file using the appropriate template, then summarize the decision in 2–3 sentences for the chat.
#