nprbst-speck

Speck

Claude Code-Native Spec-Driven Development

Speck is a specification-driven development framework that brings GitHub's spec-kit methodology to Claude Code. It provides slash commands, a natural language skill, and a CLI to help teams structure feature development through a disciplined three-phase workflow: Specify what you're building, Plan how you'll build it, Implement the plan.

The Workflow

┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│   SPECIFY   │  →   │    PLAN     │  →   │  IMPLEMENT  │
└─────────────┘      └─────────────┘      └─────────────┘
     What?               How?               Execute

Define what you're building (stakeholder-friendly, technology-agnostic), design how you'll build it (architecture, contracts, tech stack), then execute with dependency-ordered tasks.

Features

• Three-phase workflow — Structured specify → plan → implement cycle inherited from spec-kit
• Claude Code plugin — Native slash commands (/speck.specify, /speck.plan, etc.)
• Natural language skill — Ask questions about your specs, plans, and tasks
• Dual-mode CLI — Same commands work in Claude Code and terminal
• Multi-repo support — Share specifications across repositories
• Worktree integration — Work on multiple features in parallel with automatic IDE launch
• spec-kit compatible — 100% file format compatibility, easy migration

Quick Start

Install the Plugin (2 minutes)

1. Open Claude Code in your project:

   claude
   

2. Open plugin manager:

   /plugin
   

3. Add the marketplace:

   • Select "Manage marketplaces" → "Add marketplace"
   • Enter: speck-market

4. Install Speck:

   • Select "speck-market" → "speck" → "Install"

Create Your First Spec

/speck.specify Add user authentication with email and password login

Speck generates a structured specification in specs/001-user-authentication/spec.md with user stories, requirements, and success criteria.

See the Quick Start Guide for detailed setup including optional worktree integration.

Core Commands

Command	Description
/speck.specify	Create or update a feature specification
/speck.clarify	Resolve ambiguities with targeted questions
/speck.plan	Generate implementation plan and design artifacts
/speck.tasks	Break down into dependency-ordered tasks
/speck.implement	Execute tasks automatically
/speck.help	Load the Speck skill for Q&A

See the Commands Reference for all commands and options.

Speck Skill

In addition to slash commands, ask Speck questions naturally:

What user stories are in this spec?
What's the technical approach in the plan?
What tasks are pending?

Rule of thumb: Skill for questions, commands for actions.

Advanced Features

Feature	Description
Speck Reviewer	Cluster-based PR reviews with spec awareness — Learn more
Multi-Repo	Share specs across microservices or frontend/backend splits — Learn more
Worktrees	Work on multiple features simultaneously with IDE auto-launch — Learn more
Monorepos	Manage workspace projects with shared specifications — Learn more
spec-kit	100% file format compatible with GitHub's spec-kit — Learn more

Project Structure

.claude/
├── commands/          # Slash commands (/speck.*)
├── agents/            # Subagents for complex workflows
└── skills/            # Natural language skill