adr-writer — Claude Code plugin: architect your decisions
adr-writer is a Claude Code plugin for creating and maintaining Architecture Decision Records that document architectural choices and their rationale.
Apache-2.0 ★ 2,858 updated 2026-05-12
/plugin marketplace add rohitg00/awesome-claude-code-toolkit
/plugin install adr-writer@claude-code-toolkitWhat adr-writer does
adr-writer streamlines creation and maintenance of Architecture Decision Records directly within Claude Code. ADRs document significant architectural decisions—the context that led to them, consequences, and trade-offs. The plugin handles authoring, editing, and tracking these records alongside your codebase.
This matters when multiple developers work on a project and need clarity on design choices. ADRs live in your repository, get versioned with your code, and form a searchable record of how your architecture evolved. Instead of decisions getting lost in chat logs or one person's memory, they stay documented and accessible.
What it helps with
- Document architectural decisions with full reasoning and context
- Track alternatives you considered and why they didn't work
- Keep the team aligned on design choices without endless meetings
- Build a searchable history of architecture evolution
Example prompts for the agent
- Write an ADR comparing monolithic versus microservices approaches for your system
- Record a decision to migrate to a new database with trade-off analysis
- Update an existing ADR when requirements or constraints change
How to install adr-writer
Plugin marketplace
/plugin marketplace add rohitg00/awesome-claude-code-toolkit/plugin install adr-writer@claude-code-toolkitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about adr-writer
How do I install adr-writer in Claude Code?
Run two commands: first /plugin marketplace add rohitg00/awesome-claude-code-toolkit, then /plugin install adr-writer@claude-code-toolkit.
What are Architecture Decision Records?
ADRs are documents that capture important architectural choices, explain the reasoning, list alternatives considered, and outline consequences. They stay in your repo and serve as living documentation for the team.
Why use adr-writer instead of writing ADRs manually?
The plugin enforces a consistent template, makes it easier to create and edit records within Claude Code, and ensures all ADRs follow the same structure across your project.
Source text
adr-writer · Apache-2.0
Architecture Decision Records authoring and management
© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit