Skip to main content
plugin

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/awesome-claude-code-toolkit
/plugin install adr-writer@claude-code-toolkit
Open on GitHub

What 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-toolkit

Step 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

Similar plugins

All plugins for Backend and APIs →

From the same set178

The whole set →
api-reference This plugin generates API reference documentation from source code. Use it when you need a reference based on a project’s code. ★ 2,858repo stars api-benchmarker api-benchmarker — a Claude Code plugin that runs performance benchmarks against API endpoints and generates reports. Measure response times and load behavior directly in your editor. ★ 2,858repo stars api-architect api-architect designs APIs, writes documentation, creates tests, and generates OpenAPI specs. Runs during backend interface planning and contract validation. ★ 2,858repo stars android-developer android-developer — a Claude Code plugin for Kotlin and Jetpack Compose development. Runs when you need to build UI or logic for an Android app. ★ 2,858repo stars analytics-reporter analytics-reporter — a Claude Code plugin that turns your project's data into analytics reports and dashboard configurations. ★ 2,858repo stars ai-prompt-lab ai-prompt-lab is a Claude Code plugin for refining and testing prompts for precise interactions. It supports work on agent instructions and workflows. ★ 2,858repo stars accessibility-checker The accessibility-checker plugin scans web applications for accessibility issues and adjusts ARIA attributes. Use it if you build interfaces and want to ensure they work for people with disabilities. ★ 2,858repo stars a11y-audit a11y-audit runs accessibility audits with WCAG compliance verification. Analyzes frontend code and markup directly in Claude Code sessions. ★ 2,858repo stars

Project sponsors

Companies that keep this analytics open