quick-plan — Claude Code command: what it does, how to install
quick-plan turns requirements into structured implementation blueprints stored in the specs/ folder. Useful before starting complex refactoring or new feature work.
no license ★ 1,573 updated 2026-02-08
.claude/commands/quick-plan.mdWhat quick-plan does
The command processes raw user requirements, evaluates technical decisions, and drafts an engineering specification. It creates a markdown blueprint. The file gets a descriptive kebab-case name and lands directly in the specs/ directory. Each spec outlines problem goals, architecture choices, sequential rollout steps, edge cases, and a verification plan.
Execution relies on filesystem capabilities, specifically Read, Write, Edit, Glob, Grep, and MultiEdit. Without file write permissions, the assistant cannot persist the plan. Once the file is written, the command prints a brief checklist of the core components.
What it helps with
- draft an engineering blueprint before writing production code
- document architecture decisions and testing criteria in
specs/ - break complex features into sequential implementation steps
Example prompts for the agent
- /quick-plan design a migration workflow from session auth to JWT tokens
- /quick-plan outline the architecture for a Redis caching layer
How to install quick-plan
Manually: put the files in place
.claude/commands/quick-plan.mdCall it with /quick-plan. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/quick-plan.mdCall it with /prompts:quick-plan. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/quick-plan.prompt.mdManually: put the files in place
.gemini/commands/quick-plan.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about quick-plan
How do I install quick-plan in Claude Code?
Place the command definition inside .claude/commands/quick-plan.md. The /quick-plan command will then register immediately in your sessions.
Where does quick-plan write its output?
All specifications are written to the specs/ folder. It picks a descriptive kebab-case filename ending with .md.
Which tools does quick-plan require?
It needs access to Read, Write, Edit, Glob, Grep, and MultiEdit. These allow the assistant to inspect existing code and output the markdown file.