Claude Code adr for durable architecture decisions
Determine the next ADR number from the existing set, then record the context, decision, and consequences and link the related change.
中文Install in Claude Code
Open agtmux or a repository using the same conventions in Claude Code. Have the decisions directory, confirmed architecture decision, and existing numbers.
- Review `.claude/skills/adr/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/adr/` in your project and save the reviewed file as `.claude/skills/adr/SKILL.md`.
- Start Claude Code from that project's root, then select `/adr` in the slash menu.
Example task
The fixture is {existingAdrs: [8, 9], proposed: 'stable plugin configuration'}. The team has chosen a stable plugin configuration structure for future releases.What to check
Record {adrNumber: 10, decision: 'stable plugin configuration'} under docs/decisions/. Explain the context, choice, and ongoing compatibility cost.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should I write an ADR for a small reversible change?
Use ADRs for decisions that are difficult to reverse or define long-lived contracts. Keep smaller details in the change material.