Appendix A: Command Reference
Quick-reference for all 33 Draft commands. Syntax shown is for Claude Code; Copilot uses draft command (no slash), Cursor uses @draft command.
Command map: Draft's 33 commands organized by workflow category, reflecting the natural development lifecycle from context setup through quality assurance and external integration.
| Command | Purpose | Key Flags / Modifiers | Prerequisite | Chapters | |
|---|---|---|---|---|---|
/draft |
Show overview, available commands, and intent mapping | — | None | 0, 2 | |
/draft:init |
Analyze codebase and generate context files, architecture docs, and state tracking | refresh — re-analyze and update existing context |
None (run once per project) | 3, 4, 5 | |
/draft:index |
Aggregate monorepo service contexts into root-level knowledge | --init-missing — initialize uninitialized services; bughunt [dirs] — run bughunt across services |
/draft:init at root and at least one service |
18 | |
/draft:discover |
Discover features and patterns across the codebase | [path] — specific directory to scan |
/draft:init |
12 | |
/draft:plan |
Canonical parent planning command. Routes planning intent to specialist commands based on context | new-track, decompose, change, adr — route directly; <description> — initial feature description |
/draft:init |
4, 7, 8, 9 | |
/draft:new-track |
Create a feature/fix track with spec and phased plan through collaborative dialogue | --quick — streamlined mode with fewer questions; <description> — initial feature description |
/draft:init (or routed from /draft:plan) |
4 | |
/draft:implement |
Execute tasks from plan with TDD workflow and architecture checkpoints | Resumes in-progress tasks automatically | /draft:plan (requires plan.md) |
5 | |
/draft:status |
Show progress overview: active tracks, phase/task counts, blocked items | — | /draft:init |
7 | |
/draft:review |
Three-stage code review: automated validation, spec compliance, code quality | --track <id> — specific track; --full — full review; with-bughunt — add bughunt pass |
/draft:init |
6 | |
/draft:deep-review |
Module lifecycle audit covering ACID properties and production robustness | [module] — specific module to audit |
/draft:init |
14 | |
/draft:bughunt |
14-dimension exhaustive bug discovery with taint tracking and evidence | --track <id> — scope to a specific track |
/draft:init |
15 | |
/draft:coverage |
Code coverage analysis targeting 95%+ with gap identification | — | /draft:init, tests exist |
16 | |
/draft:learn |
Discover coding patterns in the codebase and update guardrails | promote — promote pattern to guardrail; migrate — migrate patterns; path — specific path |
/draft:init |
17 | |
/draft:decompose |
Module decomposition with dependency mapping and implementation ordering | project — project-wide; <track-id> — track-scoped |
/draft:init |
8 | |
/draft:adr |
Create and manage Architecture Decision Records | "title" — create with title; list — list all; supersede <n> — supersede existing ADR |
/draft:init |
9 | |
/draft:change |
Handle mid-track requirement changes with impact analysis | <description> — description of the change |
Active track | 7 | |
/draft:revert |
Git-aware rollback at task, phase, or track level | Interactive — prompts for revert level and target | Active track with commits | 7 | |
/draft:ops |
Canonical parent operations command. Routes intent to specialist commands based on context | debug, deploy-checklist, incident-response, standup — route directly |
/draft:init |
7, 15 | |
/draft:debug |
Structured debugging: reproduce, isolate, diagnose, fix | track <id>, <JIRA-KEY> |
init (optional) | — | |
/draft:quick-review |
Lightweight 4-dimension code review for a PR, diff, or file | <file>, <PR-URL>, <commit-range> |
None | 6 | |
/draft:deploy-checklist |
Pre-deployment verification checklist with rollback triggers | <service>, track <id> |
init (optional) | — | |
/draft:testing-strategy |
Design test strategies with coverage targets | track <id>, module <name> |
init (optional) | 14 | |
/draft:tech-debt |
Technical debt analysis across 6 dimensions with prioritization | module <name>, category <type> |
init (optional) | — | |
/draft:standup |
Generate standup summary from git history and track progress | <days>, weekly |
None | — | |
/draft:incident-response |
Incident management: triage, communicate, mitigate, postmortem | new, update, postmortem |
None | — | |
/draft:docs |
Canonical parent documentation command. Routes intent to specialist commands based on context | documentation, testing-strategy, tech-debt, tour — route directly |
/draft:init |
0, 14, 17 | |
/draft:documentation |
Technical documentation: readme, runbook, api, onboarding | readme, runbook <service>, api <module>, onboarding |
init (optional) | — | |
/draft:jira preview |
=======
/draft:integrations |
Canonical parent integrations command. Routes intent to specialist commands based on context | jira-preview, jira-create — route directly |
/draft:init |
19 |
/draft:jira-preview |
>>>>>>> a79c14023e16774c77463870ac3510b728e8a91c
Generate Jira export file from track plan for review before creating issues | [track-id] — specific track |
/draft:new-track (requires plan.md) |
19 | |
/draft:jira create |
Create Jira issues from export file via MCP | [track-id] — specific track; auto-generates export if missing |
/draft:jira preview (or auto-generates), MCP-Jira configured |
19 | |
/draft:tour |
Interactive architecture mentorship and codebase walk-through | — | /draft:init |
0 | |
/draft:impact |
Generate ROI analytics mapping track friction and timeline metrics | — | /draft:init |
0 | |
/draft:assist-review |
Summarize intent and highlight structural PR risks for human reviewers | <PR-URL>, track <id> |
/draft:new-track |
6 |
Intent Mapping
Draft recognizes natural language equivalents for all commands. You do not need to memorize slash syntax — describe what you want and Draft maps it to the right command.
Natural Language to Command Mapping
| What You Say | What Runs |
|---|---|
| "Set up the project" | /draft:init |
| "Start a new feature" | /draft:new-track |
| "Build it" | /draft:implement |
| "Review the code" | /draft:review |
| "Hunt for bugs" | /draft:bughunt |
| "What's the status?" | /draft:status |
| "Break this down" | /draft:decompose |
| "Record this decision" | /draft:adr |
| "Generate a deploy checklist" | /draft:deploy-checklist |
| "Write the docs" | /draft:documentation |
| "Learn the patterns" | /draft:learn |
| "Send to Jira" | /draft:jira create |
| "Send to Jira" | /draft:jira-create |
| "Discover features" | /draft:discover |
| "Tour the codebase" | /draft:tour |
| "Show AI impact metrics" | /draft:impact |
| "Assist PR review" | /draft:assist-review |
Full Intent List
Run /draft (the overview command) to see the complete intent mapping table with all 33 commands and their natural language triggers.