speckit.specify — Claude Code command: what it does, how to install
speckit.specify builds or updates a feature specification straight from a natural language prompt. Handy for structuring requirements and acceptance criteria before writing code.
no license ★ 117 updated 2026-10-29
.claude/commands/speckit.specify.mdWhat speckit.specify does
The command reads the feature prompt passed directly after /speckit.specify, extracts a short branch slug, and queries Git branches alongside local directories to figure out the next sequential number. It then launches .specify/scripts/bash/create-new-feature.sh to initialize the feature branch.
Next, it applies .specify/templates/spec-template.md to map raw notes into distinct sections: user flows, testable functional rules, and technology-agnostic success metrics. When ambiguous details surface, it allows at most three clarification placeholders to keep the scope manageable.
This setup requires the .specify folder with its templates and bash helper script present in the repository. Once the spec file is drafted, the command generates a dedicated validation checklist at FEATURE_DIR/checklists/requirements.md.
What it helps with
- turn informal feature ideas into structured specification documents
- calculate the next numeric Git branch name based on existing branches
- establish technology-agnostic success metrics and acceptance flows
- compile a quality checklist to verify requirement completeness
Example prompts for the agent
- /speckit.specify Add user authentication with OAuth2 providers
- /speckit.specify Build an analytics dashboard for API metrics
- /speckit.specify Fix payment processing timeout on checkout
How to install speckit.specify
Manually: put the files in place
.claude/commands/speckit.specify.mdCall it with /speckit.specify. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/speckit.specify.mdCall it with /prompts:speckit.specify. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/speckit.specify.prompt.mdManually: put the files in place
.gemini/commands/speckit.specify.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about speckit.specify
How to install speckit.specify in Claude Code?
Save the command definition file into .claude/commands/speckit.specify.md in your project root.
What does speckit.specify do?
It converts raw feature descriptions into standardized Markdown specifications and sets up numbered feature branches.
How does speckit.specify pick the branch number?
It checks remote heads, local branches, and existing specs/ directories for matching short names, picking the highest integer and incrementing it by one.