spec-driven-development

Create stakeholder-approved specifications through a 4-phase gated workflow.

Updated May 27, 2026
One-click install
npx skills add https://github.com/santanapol/agent-skills --skill spec-driven-development-santanapol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/santanapol/agent-skills/tree/main/.cursor/skills/spec-driven-development
Command: npx skills add https://github.com/santanapol/agent-skills --skill spec-driven-development-santanapol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the high cost of building software based on vague, unvalidated assumptions, which causes misalignment between stakeholders and development teams, costly rework, and wasted effort on features that do not meet actual user or business needs.

Core Features & Use Cases

  • 4-Phase Gated Workflow: Structured process moving from requirement specification to implementation, with mandatory human checkpoints at each phase to validate alignment.
  • Standardized Spec Template: Pre-built template covering 6 core specification areas (objective, commands, project structure, code style, testing strategy, boundaries) to ensure no critical details are missed.
  • Built-in Guardrails: Clear rules for what to always do, ask before doing, and never do, plus red flag warnings to prevent common mistakes like skipping specs or making unrecorded architectural changes.
  • Use Case: When starting a new customer-facing dashboard feature, use this Skill to create a detailed, approved spec with measurable success criteria, break the work into small actionable tasks, and avoid building unnecessary functionality or missing critical performance requirements.

Quick Start

Use the spec-driven-development skill to create a complete, stakeholder-approved specification for your new project or feature before writing any implementation code.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
How do I create validated software requirements before starting development?

To create validated software requirements, use a structured 4-phase gated workflow with standardized spec templates covering objectives, commands, structure, code style, testing, and boundaries to ensure stakeholder alignment before implementation begins.

What is spec-driven development and when should I use it?

Spec-driven development is a process of writing and validating detailed specifications before coding, used for new project kickoffs, large feature development, cross-module changes, and architectural decisions where initial requirements are vague or unconfirmed.

How do I prevent costly rework caused by building features with vague requirements?

Prevent costly rework by applying a gated workflow with mandatory human checkpoints and built-in guardrails that validate requirement completeness and architectural alignment before any implementation code is written.

Can I use a structured spec template for cross-module changes and new project kickoffs?

Yes, a standardized spec template applies to cross-module changes and new project kickoffs by enforcing mandatory validation checkpoints across 6 core specification areas to ensure no critical details are missed.

What is the best way to break down large feature development into actionable tasks?

The best way to break down large feature development is to complete a stakeholder-approved specification first, then use the structured workflow's validation checkpoints to transition validated requirements into small actionable implementation tasks.

Why does skipping software requirements specifications lead to misalignment?

Skipping software requirements specifications leads to misalignment because development teams build based on vague, unvalidated assumptions, resulting in wasted effort on functionality that fails to meet actual user and business needs.