Installs into .claude/skills of the current project.
Are you the author of Decide?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/chaitanya299-decide)
---
name: decide
description: Record an architectural decision as a numbered ADR and update architecture.md to match. Use right after a decision is made in conversation.
---
# /orient:decide
Record one architectural decision as a numbered, append-only ADR.
Resolve the docs directory from `CLAUDE_PLUGIN_OPTION_DOCS_DIR` (default `docs`).
1. Find the highest existing ADR number in `<docs_dir>/decisions/` and add one.
Filenames are `NNNN-kebab-title.md`, numbered from 0001.
2. Fill `templates/adr.md`. Interview the user **only** for what can't be inferred
from the session — the alternatives that were considered and the trade-off
accepted are the parts worth asking about. Infer the rest.
3. Show the drafted ADR and write it on approval.
Supersede rule: if this decision supersedes an earlier ADR, set `Supersedes:` in the
new file and update **only** the `Superseded by:` line of the old one. No other edit
to a past ADR is permitted — decisions are append-only.
## Keep architecture and the shape diagram in sync
After the ADR is written, check whether this decision changes structure — entry points,
module boundaries, or critical paths. If so, update two things, each shown as a
before/after preview and written **only after a separate approval** (the user can accept
the ADR but decline these):
- `<docs_dir>/architecture.md` — touch only the affected lines, refresh the `updated:` marker.
- the `## Shape` mermaid diagram in `<docs_dir>/STATE.md` — only if the decision adds,
removes, or reconnects a major component. Keep it to 6 nodes.
Skip whichever target doesn't exist, and skip the whole step for a non-structural decision.
