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

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

Popularity

Parent stars

1,716

Parent forks

535

Invocation

How this command is triggered — by the user, by Claude, or both

Slash command

/adr-writer:write-adr

Model invocable

No pre-commands

Context Preview

The summary Claude sees in its command listing — used to decide when to auto-load this command

# /write-adr - Write Architecture Decision Record

Create a new Architecture Decision Record documenting a technical decision.

## Steps

1. Ask the user for the decision title and context
2. Determine the next ADR number by scanning existing ADRs in the docs/adr directory
3. Ask about the decision context: what problem is being solved and why now
4. Gather the options considered with pros and cons for each
5. Document the chosen option and the reasoning behind the decision
6. Identify consequences: what changes, what trade-offs are accepted
7. Note the decision status: proposed, accepted, ...

Command Content

29 lines · ~363 tokens

Other plugins with /write-adr

/adr

1.7k

Generates a new Architecture Decision Record (ADR) documenting a technical decision, numbers it sequentially from existing ADRs, researches codebase context, and creates the Markdown file in docs/adr/.

claude-code-toolkit

/adr

Interactively creates Architecture Decision Records (ADRs) through guided conversation, documenting context, options, rationale per template, and updates architecture overview.

claude-opus-4-57 tools

ai-toolkit

/adr

faos-enterprise-architect

/adr-new

Creates a new Architecture Decision Record (ADR) in docs/adr/ with formal professional format. Runs team discussion if Billy active, then writes clean ADR.

6 tools

billy-milligan

/generate

Generates final ADR document from prior analysis: prompts for decision details, analyzes consequences, writes MADR-formatted file to docs/adr/ or specified path, cleans session.

adr-assistant

Stats

LanguageJavaScript

Parent stars1,716

Parent forks535

MaintenanceFair

Last CommitFeb 4, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

# /write-adr - Write Architecture Decision Record Create a new Architecture Decision Record documenting a technical decision. ## Steps 1. Ask the user for the decision title and context 2. Determine the next ADR number by scanning existing ADRs in the docs/adr directory 3. Ask about the decision context: what problem is being solved and why now 4. Gather the options considered with pros and cons for each 5. Document the chosen option and the reasoning behind the decision 6. Identify consequences: what changes, what trade-offs are accepted 7. Note the decision status: proposed, accepted, ...

/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

/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

/write-adr

Popularity

Invocation

Context Preview

Command Content

Other plugins with /write-adr

Help us improve

Help us improve

Find plugins for your project

/write-adr

Popularity

Invocation

Context Preview

Command Content

/write-adr - Write Architecture Decision Record

Steps

Rules

Other plugins with /write-adr

Help us improve

/write-adr - Write Architecture Decision Record

Steps

Rules