spec-driven

Coordinate subagents through spec-driven development phases with approval gates.

137|20|Updated Jun 13, 2025
One-click install
npx skills add https://github.com/NikiforovAll/claude-code-rules --skill spec-driven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven
Source: https://github.com/NikiforovAll/claude-code-rules/tree/main/plugins/handbook-agent-spec-kit/skills/spec-driven
Command: npx skills add https://github.com/NikiforovAll/claude-code-rules --skill spec-driven

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill acts as an orchestrator for spec-driven development, coordinating subagents across phases (requirements, design, tasks, and optional implementation) instead of performing the work directly.

Core Features & Use Cases

  • Orchestrate phases: Launch the appropriate subagents for requirements, design, tasks, and optional implementation.
  • Approval gates: Manage user feedback and gating between phases.
  • Zero-document creation: Do not write requirements/design/tasks yourself; rely on subagents.

Quick Start

Start spec-driven workflow by launching the requirements-agent for a feature: requirements-agent "Build login flow" with initial input.

Frequently Asked Questions about spec-driven

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate a spec-driven development workflow across multiple phases?

Spec-driven development coordinates requirements, design, tasks, and implementation through sequential phases with approval gates. Launch the requirements-agent to start, then transition through design and task phases with user feedback between each stage, ensuring structured planning before code implementation.

What's the difference between spec-driven development and jumping straight to coding?

Spec-driven development enforces a phased workflow: Phase 1 gathers requirements, Phase 2 designs solutions, Phase 3 breaks work into tasks, and Phase 4 optionally implements—each with mandatory approvals. This prevents rework by validating assumptions early rather than discovering misalignment during development.

How do I manage approval gates between development phases?

The orchestrator manages transitions between phases by waiting for subagent completion, collecting user feedback at each gate, and gating the next phase on approval. This ensures stakeholders validate requirements before design, design before task breakdown, and tasks before implementation begins.

Can I use spec-driven development for feature planning without immediate implementation?

Yes. The workflow covers Phase 1 requirements, Phase 2 design, and Phase 3 task breakdown as mandatory stages, with Phase 4 implementation optional. You can complete structured planning, get approval, and defer coding until later.

Why shouldn't I write requirements or design documents myself in a spec-driven workflow?

The orchestrator forbids direct document creation to enforce subagent specialization—each agent brings focused expertise to its phase. Delegating to specialized subagents produces higher-quality requirements, design, and tasks than a single handler writing all outputs.

What happens if I request structured feature planning—do I need to specify 'spec-driven' explicitly?

The orchestrator launches automatically when you request structured feature planning or explicitly say 'use spec-driven'. Either trigger initiates the full workflow, starting with requirements gathering through the requirements-agent.