← ClaudeAtlas

adrlisted

Draft a structured Architecture Decision Record (ADR) capturing context, alternatives considered, the decision, and consequences in MADR / Nygard format. Use when the user says "write ADR", "record this decision", "document architecture choice", "capture the rationale", "create decision log", or right after committing to a significant technical choice (framework, database, protocol, pattern, migration). Numbering, target path, and the corpus index come from the `adr` MCP tool; drafts always land with status `proposed` — ratification is the separate human-run `/marvin:adr-accept`.
real-case/marvin-toolkit · ★ 0 · AI & Automation · score 68
Install: claude install-skill real-case/marvin-toolkit
Draft an Architecture Decision Record (ADR) documenting a significant technical decision. The deterministic mechanics — next number, target path, corpus discovery, index regeneration — belong to the **`adr` MCP tool** (from the `marvin` server, ADR-0027). This skill owns only the judgement work: gathering context, weighing alternatives, and writing the prose. Never hand-number a record or hand-maintain the index. A draft **always lands with status `proposed`** — never `accepted`. Authority lives at the gates: ratification is `/marvin:adr-accept`, rollback is `/marvin:adr-supersede`, both human-run. ## Argument handling - `/marvin:adr <title>` — use the provided title as the decision topic - `/marvin:adr <title> --context <path>` — use research notes from the given file as additional input - `/marvin:adr` — ask the user what decision they want to document ## Phase 1: Discover the corpus and project conventions 1. Call the `adr` MCP tool with `{"action": "list"}` — it resolves the corpus location (config `adr.dir` → detected `docs/adr/` / `docs/decisions/` / `adr/` → default `docs/adr/`) and returns every existing record with number, title, and status. Note records related to this decision, and any malformed files it reports. 2. If records exist, read 2–3 recent ones to match the corpus's **style, tone, and header format** — marvin-style table headers (`| Status | … |`) and MADR-style sections (`## Status`) both parse; new records should match their neighbo