Amend an architecture decision record in Claude Code
Record context, decision, alternatives, and consequences, then document approved changes in an amendment to the existing ADR.
中文Install in Claude Code
A Claude Code workspace with an existing ADR. Supply the approved change request when revising a finalized specification.
- Review `.claude/skills/adr-writing/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/adr-writing/` in your project and save the reviewed file as `.claude/skills/adr-writing/SKILL.md`.
- Start Claude Code from that project's root, then select `/adr-writing` in the slash menu.
Example task
ADR-12 originally specified a text-only export. Approved request CR-5 adds a print view. The brief is `{adr:'ADR-12',request:'CR-5',change:'add print view',reason:'request from editors',impact:'rehearsal list'}`, approved on 2026-08-11.What to check
Add `Amendment (CR-5, 2026-08-11)` to ADR-12. State the print view change, the editors' request as the reason, and the rehearsal-list scope. Keep the original decision and alternatives as history.
Original SKILL.md on GitHub · Updated
Frequently asked question
How do I record an approved change after finalizing a specification?
Add an amendment to the existing ADR with the request ID and date, then record the change, reason, and impact scope.