create-adrlisted
Install: claude install-skill broneq/bdk
# Create ADR
> Relies on BDK foundation (STARTUP_INSTRUCTIONS.md) for project context and MCP tool preference.
!`python3 ${CLAUDE_PLUGIN_ROOT}/scripts/inject-rules.py architecture`
Generate ADR following MADR format.
## Input
$ARGUMENTS
## Process
### 1. Analyze Input
Extract from free-form description:
- Problem statement and context
- Considered options
- Constraints and decision drivers
- Stated preference or chosen option
### 2. Ask Targeted Questions
Use AskUserQuestion to fill gaps — only ask what's genuinely unclear.
**Always ask:**
- ADR status (proposed/accepted/rejected/deprecated)
**Never ask — user adds manually after generation:**
- Decision-makers, consulted, informed (use `{TBD}` placeholder in frontmatter)
### 3. Determine Next ADR Number
Scan `docs/adr/` for existing ADR files matching pattern `NNNN-*.md`. Use next sequential number, zero-padded to 4 digits.
### 4. Generate ADR Document
Write to `docs/adr/NNNN-{slugified-title}.md` following MADR format:
```markdown
---
status: {status}
date: {YYYY-MM-DD}
decision-makers: {TBD}
consulted: {TBD}
informed: {TBD}
---
# ADR-NNNN: {Title}
## Context and Problem Statement
{2-3 sentences describing the problem}
## Decision Drivers
- {driver 1}
- {driver 2}
## Considered Options
1. **{Option A}** — {one-line summary}
2. **{Option B}** — {one-line summary}
## Decision Outcome
**Chosen option: {Option}**, because {justification}.
### Consequences
- ✅ {positive consequence}
- ❌ {negative consequen