Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/quick-plan.md
Open on GitHub

What 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.md

Call it with /quick-plan. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Notes, tasks and projects →

From the same set20

The whole set →
load_ai_docs load_ai_docs — a command that downloads documentation from AI platforms and saves it as markdown files for agents to reference locally. Use it when you want your sub-agents to have current docs without needing web access. CX Codex +1 ★ 1,573repo stars find_and_summarize find_and_summarize locates source files across target directories and creates concise two-sentence summaries in a YAML file. Useful for documenting modules without subagents. CX Codex +1 ★ 1,573repo stars create-worktree-subagent The create-worktree-subagent subagent creates isolated git worktrees for parallel development. Use it when the request explicitly delegates worktree creation to a subagent. CX Codex ★ 1,573repo stars docs-scraper docs-scraper — a subagent that fetches a documentation page by URL and saves it as a markdown file in ai_docs/. Handy when your agent needs a local copy of the docs. CX Codex ★ 1,573repo stars plan_new_feature plan_new_feature is a Claude Code command that turns a feature request into a development plan saved under specs/. It maps the work before coding starts. CX Codex +1 ★ 1,573repo stars load_ai_docs load_ai_docs — a command that downloads documentation from specified URLs and saves it as markdown files via model-specific subagents. Designed for documentation benchmarking and testing AI model capabilities. CX Codex +1 ★ 1,573repo stars t_metaprompt_workflow t_metaprompt_workflow generates structured Claude Code slash commands from a high-level task description while checking Anthropic docs. CX Codex +1 ★ 1,573repo stars scout-report-suggest-fast scout-report-suggest-fast hunts a described problem through a codebase and returns file paths, line numbers and a fix plan. It only reads. CX Codex ★ 1,573repo stars

Project sponsors

Companies that keep this analytics open