Slash Command

/write-adr

Interactively creates an Architecture Decision Record (ADR) in docs/adr/ using Michael Nygard format, gathering context, options, decision, consequences, and status; auto-numbers sequentially.

documentation

From adr-writer

Install

Run in your terminal

npx claudepluginhub rohitg00/awesome-claude-code-toolkit --plugin adr-writer

Command Content

Other plugins with /write-adr

/write-adr

Capture an architectural decision from the current conversation as an ADR

ago

/write-adr

Full Architecture Decision Record with alternatives, consequences, and review trigger

sde-architecture

/write-adr

Create an Architecture Decision Record (ADR) through an interactive process with the Architect sub-agent. ADRs capture important technical decisions with their context, alternatives considered, and consequences — ensuring institutional memory persists beyond any individual's involvement.

synthex

Stats

Parent Repo Stars1012

Parent Repo Forks275

Last CommitFeb 4, 2026

Actions

View Source View Plugin View on GitHub View README

/write-adr - Write Architecture Decision Record

Create a new Architecture Decision Record documenting a technical decision.

Steps

Ask the user for the decision title and context
Determine the next ADR number by scanning existing ADRs in the docs/adr directory
Ask about the decision context: what problem is being solved and why now
Gather the options considered with pros and cons for each
Document the chosen option and the reasoning behind the decision
Identify consequences: what changes, what trade-offs are accepted
Note the decision status: proposed, accepted, deprecated, or superseded
Link to related ADRs if this decision supersedes or relates to previous ones
Format the ADR using the standard template: Title, Status, Context, Decision, Consequences
Save the ADR as docs/adr/NNNN-title-slug.md with zero-padded number
Update the ADR index file if one exists
Report the created ADR path and number

Rules

Follow the Michael Nygard ADR format (Title, Status, Context, Decision, Consequences)
Number ADRs sequentially with zero-padded 4-digit numbers (0001, 0002)
Keep the title concise and descriptive of the decision, not the problem
Include at least two alternatives that were considered
Document consequences honestly, including negative trade-offs
Never modify existing accepted ADRs; create a new one that supersedes
Create the docs/adr directory if it does not exist