← ClaudeAtlas

adr-generatorlisted

Generate an Architecture Decision Record (ADR) from a context-decision-consequences brief. Supports the two common formats — MADR (Markdown Any Decision Records) and Michael Nygard's original ADR template. Use whenever the user wants to capture an architectural decision, write an ADR, or document a "we decided X because Y" moment.
sananthanarayan/skilldrop · ★ 2 · AI & Automation · score 73
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. #