Help us improve
Share bugs, ideas, or general feedback.
From billy-milligan
Updates ADR status to PROPOSED, ACCEPTED, DEPRECATED, or SUPERSEDED. Finds ADR file, confirms current/new status, edits markdown, and refreshes README index via bash script.
npx claudepluginhub rnavarych/alpha-engineer --plugin billy-milliganHow this command is triggered — by the user, by Claude, or both
Slash command
/billy-milligan:adr-statusThis command is limited to the following tools:
The summary Claude sees in its command listing — used to decide when to auto-load this command
# /billy:adr-status — Update ADR Status ## Usage ## Valid Statuses | Status | Meaning | |--------|---------| | `PROPOSED` | Under discussion, not finalized | | `ACCEPTED` | Decision is in effect | | `DEPRECATED` | No longer applies, not replaced | | `SUPERSEDED by ADR-NNN` | Use `/billy:adr-supersede` for this — it handles the full flow | ## Instructions ### Step 1: Find the ADR Use Glob to find `docs/adr/<number>*.md`. If not found: ### Step 2: Read Current Status Show current ADR title and status. ### Step 3: Confirm Change ### Step 4: Apply Update Use Edit to update the S...
/update-docsAnalyzes project context and existing docs/code-convention.yaml or docs/adr.yaml, proposes MUST/RECOMMENDED additions/modifications/deletions, and applies user-approved changes. Supports 'convention', 'adr', or both.
/adrGenerates 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/.
/write-adrInteractively creates an Architecture Decision Record (ADR) in docs/adr/ using Michael Nygard format, gathering context, options, decision, consequences, and status; auto-numbers sequentially.
Share bugs, ideas, or general feedback.
/billy:adr-status 004 ACCEPTED
/billy:adr-status 002 DEPRECATED
/billy:adr-status 003 PROPOSED
| Status | Meaning |
|---|---|
PROPOSED | Under discussion, not finalized |
ACCEPTED | Decision is in effect |
DEPRECATED | No longer applies, not replaced |
SUPERSEDED by ADR-NNN | Use /billy:adr-supersede for this — it handles the full flow |
Use Glob to find docs/adr/<number>*.md.
If not found:
ADR-<number> not found. Run /billy:adr-list to see available ADRs.
Show current ADR title and status.
ADR-NNN: <title>
Current status: <current>
New status: <new>
Update status? (y/n)
Use Edit to update the Status section in the ADR file:
From:
## Status
<current status>
To:
## Status
<new status>
Confirm: ADR-NNN status updated to <new status>.
Run: bash ./plugins/billy-milligan/scripts/adr-list.sh --update-readme
If the user tries to set status to SUPERSEDED, remind them:
To supersede an ADR properly (mark old + create replacement), use:
/billy:adr-supersede <number> "<new title>"
Or if you just want to mark it superseded without creating a replacement:
/billy:adr-status <number> "SUPERSEDED by ADR-NNN"
(include the ADR number that supersedes it)