Write architecture decision records in Claude Code
Capture an important technical choice as a proposed ADR with its trigger, alternatives, benefits, and costs.
中文Install in Claude Code
A Claude Code project with an existing ADR directory. Check its numbering and leave final acceptance to a human reviewer.
- Review `.claude/skills/plan-adr/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/plan-adr/` in your project and save the reviewed file as `.claude/skills/plan-adr/SKILL.md`.
- Start Claude Code from that project's root, then select `/plan-adr` in the slash menu.
Example task
A rehearsal sheet will create its print view in the browser. The latest record is ADR-0007. The brief says `{decision:'browser print',alternative:'server PDF',reason:'work offline'}`. Browser printing works offline but layout may vary by browser.What to check
Create `0008-browser-print.md` as Proposed. Explain the offline requirement, the browser-print decision, why server PDF was declined, and the layout tradeoff. Change the status to Accepted only after human approval.
Original SKILL.md on GitHub · Updated
Frequently asked question
When can an architecture decision record become Accepted?
Assign its number from existing records, then document context, decision, alternatives, and consequences as Proposed. Change status after a human approves the content.