Skip to main content
command CX Codex

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

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

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

Call it with /speckit.specify. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Writing and docs →

From the same set9

speckit.taskstoissues speckit.taskstoissues converts a list of tasks into dependency-ordered GitHub issues using design artifacts and project context. Works only with GitHub repositories. CX Codex +1 ★ 117repo stars speckit.plan speckit.plan executes implementation planning workflow to produce architectural artifacts and API contracts. CX Codex +1 ★ 117repo stars speckit.constitution The speckit.constitution command edits a project’s constitution and checks related templates and guidance for alignment. Use it when development principles or governance rules change. CX Codex +1 ★ 117repo stars speckit.tasks speckit.tasks builds a tasks.md file for a feature from plan.md and spec.md, splitting work into phases by user story priority. CX Codex +1 ★ 117repo stars speckit.analyze speckit.analyze inspects spec.md, plan.md, and tasks.md for conflicts, gaps, and constitution violations before code generation. Runs in read-only mode. CX Codex +1 ★ 117repo stars speckit.implement The speckit.implement command works through the tasks in tasks.md using the project plan and related documents. Use it to carry out an implementation plan in a defined order. CX Codex +1 ★ 117repo stars speckit.clarify speckit.clarify — a command that scans a feature spec for underspecified areas and asks up to 5 targeted questions to fill gaps before planning begins. CX Codex +1 ★ 117repo stars speckit.checklist speckit.checklist builds a checklist for reviewing feature requirements, including unclear statements and missing scenarios. Use it before implementing a feature or reviewing its spec. CX Codex +1 ★ 117repo stars

Project sponsors

Companies that keep this analytics open