// Enforces structured decision-making by creating Agent Decision Records (AgDR). Use when comparing libraries, choosing patterns, making architecture choices, or any "should I use X or Y" moment.
| name | decide |
| description | Enforces structured decision-making by creating Agent Decision Records (AgDR). Use when comparing libraries, choosing patterns, making architecture choices, or any "should I use X or Y" moment. |
Forces structured decision-making and creates an auditable Agent Decision Record (AgDR).
/decide "what you're deciding"
/decide which state management library to use
/decide how to implement caching
Extract the decision topic from input. If unclear, ask:
What technical decision do you need to make?
Identify decision-relevant context only:
Present 2-4 options in a table:
| Option | Pros | Cons |
|--------|------|------|
| Option A | ... | ... |
| Option B | ... | ... |
State the chosen option with justification.
Create file at {project-root}/docs/agdr/AgDR-{NNNN}-{slug}.md:
---
id: AgDR-{NNNN}
timestamp: {ISO-8601: YYYY-MM-DDTHH:MM:SSZ}
agent: claude-code
model: {model-id from environment}
session: {session-id if available}
trigger: user-prompt
status: executed
---
# {short title}
> In the context of {context}, facing {concern}, I decided {decision} to achieve {goal}, accepting {tradeoff}.
## Context
{Decision-relevant context only - 2-4 bullets}
## Options Considered
| Option | Pros | Cons |
|--------|------|------|
| ... | ... | ... |
## Decision
Chosen: **{option}**, because {justification}.
## Consequences
- {consequence 1}
- {consequence 2}
## Artifacts
- {commit/PR links when available}
# Find highest existing AgDR number
ls docs/agdr/AgDR-*.md 2>/dev/null | sort -V | tail -1 | grep -oP 'AgDR-\K\d+'
# Increment by 1, or start at 0001
Output the decision so work can continue:
Decision: {chosen option}
AgDR-{NNNN} created at docs/agdr/AgDR-{NNNN}-{slug}.md
Proceeding with: {brief action}