spec-driven

A workflow for building software from written specifications: requirements, design, tasks, and implementation. It uses approval gates between phases and assigns each phase to a separate agent.

In plain words
What is it for?
Use it to turn a feature idea into approved requirements, a design, an implementation task list, and coordinated coding work.
Why use it?
It gives feature work a clear sequence and prevents planning phases from being skipped or implemented by the wrong agent.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nikiforovall/claude-code-rules/spec-driven
Any agent
npx skills add NikiforovAll/claude-code-rules --skill spec-driven
Clone the repo
git clone --depth 1 https://github.com/NikiforovAll/claude-code-rules

Made for: Claude Code, Codex.

Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,106 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00044 $0.01106
Opus 5 $0.00022 $0.00553
Sonnet 5 $0.00009 $0.00221
Haiku 4.5 $0.00004 $0.00111

Measured 2d ago against content hash d3cad28eeea8, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spec-driven scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/handbook-agent-spec-kit/skills/spec-driven/SKILL.md · 122 lines

How it starts

The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Spec-Driven Development Workflow

You are an orchestrator for spec-driven development. Your ONLY job is to coordinate subagents - you MUST NEVER create documents or implement tasks yourself.

CRITICAL: Orchestrator-Only Rules

ALWAYS:

  • ✅ Launch the appropriate subagent for each phase
  • ✅ Wait for subagent completion before proceeding
  • ✅ Manage approval gates and user feedback
  • ✅ Coordinate workflow transitions

NEVER:

  • ❌ Create requirements.md, design.md, or tasks.md yourself
  • ❌ Implement tasks directly
  • ❌ Skip launching a subagent "to save time"
  • ❌ Write code or documentation yourself

If you find yourself about to create a file or write code, STOP and launch the appropriate subagent instead.

File Structure

All specs go in: specs/{feature_name}/

  • requirements.md - User stories with EARS acceptance criteria
  • design.md - Technical architecture and implementation guidance
  • tasks.md - Incremental coding tasks

Workflow Phases

Phase 1: Requirements

Goal: Transform feature idea into user stories with measurable acceptance criteria.

MANDATORY: You MUST launch requirements-agent - do NOT create requirements yourself.

Process:

  1. Launch requirements-agent with feature description
  2. Review generated requirements with user
  3. Approval Gate: "Do the requirements look good? If so, we can move on to the design."
  4. Iterate based on feedback until approved (re-launch agent with feedback)

Phase 2: Design

Goal: Create technical design addressing all requirements.

Prerequisites: Approved requirements.md

MANDATORY: You MUST launch tech-design-agent - do NOT create design yourself.

Process:

  1. Launch tech-design-agent with feature name and requirements
  2. Review generated design with user
  3. Approval Gate: "Does the design look good? If so, we can move on to the implementation plan."
  4. Iterate based on feedback until approved (re-launch agent with feedback)

Phase 3: Tasks

Goal: Convert design into actionable coding tasks.

Read the full file on GitHub · 122 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 122 lines · 44 tokens per session scan A d3cad28eeea8

Subscribe to this mod's changes

spec-driven is a skill published in the GitHub repository NikiforovAll/claude-code-rules (141 stars, last pushed 3d ago), licensed Apache-2.0. It adds 44 tokens to every session and 1,106 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant.

phuryn/pm-skills · 54 tokens

brainstorm-okrs

Brainstorm team-level OKRs aligned with company objectives — qualitative objectives with measurable key results. Use when setting quarterly OKRs, aligning team goals with company strategy, drafting objectives, or learning how to write effective OKRs.

phuryn/pm-skills · 49 tokens

dummy-dataset

Generate realistic dummy datasets for testing with customizable columns, constraints, and output formats (CSV, JSON, SQL, Python script). Use when creating test data, building mock datasets, or generating sample data for development and demos.

phuryn/pm-skills · 48 tokens

outcome-roadmap

Transform an output-focused roadmap into an outcome-focused one that communicates strategic intent. Rewrites initiatives as outcome statements reflecting user and business impacts. Use when shifting to outcome roadmaps, making a roadmap more strategic, or rewriting feature lists as outcomes.

phuryn/pm-skills · 53 tokens

pre-mortem

Run a pre-mortem risk analysis on a PRD or launch plan. Categorizes risks as Tigers (real problems), Paper Tigers (overblown concerns), and Elephants (unspoken worries), then classifies as launch-blocking, fast-follow, or track. Use when preparing for launch, stress-testing a product plan, or identifying what could go…

phuryn/pm-skills · 79 tokens

retro

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

phuryn/pm-skills · 52 tokens