spec-driven-development

Writes structured specifications before coding through a gated four-phase workflow.

5|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/PHenrique07/Sementis-IFSP-Pirituba --skill spec-driven-development-phenrique07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/PHenrique07/Sementis-IFSP-Pirituba/tree/main/.github/skills/spec-driven-development
Command: npx skills add https://github.com/PHenrique07/Sementis-IFSP-Pirituba --skill spec-driven-development-phenrique07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents wasted engineering effort caused by ambiguous requirements by forcing a written, human-approved specification before any code is written, surfacing assumptions and misunderstandings early. ## Core Features & Use Cases - Gated Four-Phase Workflow: Enforces Specify, Plan, Tasks, and Implement phases, each requiring human review before advancing. - Capability Mapping: Decomposes large multi-capability requests into a module map with dependency direction and build order before any spec is written. - Spec Template & Success Criteria: Provides a six-section spec template (Objective, Commands, Structure, Style, Testing, Boundaries) and reframes vague requirements into testable success criteria. - Use Case: When asked to build a new feature like a notification system, draft a spec covering objectives, tech stack, and boundaries, get it approved, then break it into dependency-ordered tasks before implementing. ## Quick Start Ask the AI to write a specification for your new feature using the spec-driven-development workflow before writing any 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 write a specification before coding a new feature?▼

Follow the Specify phase: surface assumptions explicitly, ask clarifying questions, then write a spec covering Objective, Commands, Project Structure, Code Style, Testing Strategy, and Boundaries. Get human approval before moving to planning.

What is spec-driven development workflow?▼

It is a four-phase gated process: Specify, Plan, Tasks, Implement. Each phase requires human review before advancing, and a Phase 0 scope check decomposes multi-capability requests into a capability map first.

When should I not use spec-driven development?▼

Skip it for single-line fixes, typo corrections, or changes where requirements are unambiguous and self-contained. The workflow targets new features, ambiguous requirements, and changes touching multiple files or modules.

How do I handle a requirement that spans multiple modules?▼

Use Phase 0 scope check to create a capability map with stable kebab-case module ids, one-way dependencies, and a build order. Then run the full Specify-to-Implement cycle per module in dependency order.

Does this workflow work with OpenSpec or other spec tools?▼

Yes, the workflow is format-agnostic. If a project already uses OpenSpec or another specification system, keep that tool's artifact format and storage conventions while this skill owns clarification, content, and approval gates.