speckit.plan — Claude Code command: what it does, how to install
speckit.plan executes implementation planning workflow to produce architectural artifacts and API contracts.
no license ★ 117 updated 2026-10-29
.claude/commands/speckit.plan.mdWhat speckit.plan does
The command triggers an end-to-end planning run using the project implementation template. It runs .specify/scripts/bash/setup-plan.sh --json to extract workspace paths, loads requirements from the feature specification, and inspects constraints in .specify/memory/constitution.md.
Execution moves through strict phases. Phase 0 spots unresolved technical questions and logs choices into research.md. Phase 1 pulls domain entities into data-model.md, prepares OpenAPI or GraphQL definitions inside contracts/, and produces quickstart.md. Finally, .specify/scripts/bash/update-agent-context.sh claude refreshes the active agent context.
The command expects helper bash scripts inside .specify/scripts/bash/; missing scripts or unjustified rule violations immediately halt execution with an error.
What it helps with
- create an architectural implementation plan from a feature spec
- generate entity relationships and constraints in
data-model.md - draft REST or GraphQL interface definitions inside
contracts/ - verify design choices against project rules in
constitution.md
Example prompts for the agent
- /speckit.plan design the billing subscription workflow
- /speckit.plan plan the user notification service architecture
How to install speckit.plan
Manually: put the files in place
.claude/commands/speckit.plan.mdCall it with /speckit.plan. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/speckit.plan.mdCall it with /prompts:speckit.plan. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/speckit.plan.prompt.mdManually: put the files in place
.gemini/commands/speckit.plan.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about speckit.plan
How to install speckit.plan in Claude Code?
Place the command file at .claude/commands/speckit.plan.md in your project.
What does speckit.plan do?
It processes feature requirements through research and modeling stages to produce research.md, schema files, and API contracts.
What dependencies does speckit.plan need to run?
It depends on repository bash scripts in .specify/scripts/bash/ to set up paths and update agent context.