One-click install
npx skills add https://github.com/j-cogburn/d3 --skill spec-driven-development-j-cogburn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/j-cogburn/d3/tree/main/tests/project-t01/.d3/skills/spec-driven-development
Command: npx skills add https://github.com/j-cogburn/d3 --skill spec-driven-development-j-cogburn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coding without clear, validated requirements leads to misalignment between developers and stakeholders, wasted effort on incorrect feature builds, and costly rework cycles that delay project delivery.

Core Features & Use Cases

  • Gated 4-phase workflow: Enforces Specify → Plan → Tasks → Implement progression with mandatory human review at each stage to catch misalignment and incorrect assumptions early.
  • Structured spec template: Guides creation of comprehensive, version-controlled specs covering objective, tech stack, commands, project structure, code style, testing strategy, operational boundaries, and testable success criteria.
  • Adaptive guardrails: Includes rebuttals to common rationalizations for skipping specs, red flag warnings, and processes to update specs as requirements evolve to keep them aligned with project reality.
  • Use cases: Ideal for new project builds, feature development, ambiguous requirement scenarios, multi-file changes, and architectural decisions where clear requirements are critical to success.

Quick Start

Use the spec-driven-development skill to create a validated, human-reviewed specification for your new payment processing 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 software specifications before coding to prevent rework?

Pre-coding workflows prevent rework by enforcing a gated 4-phase progression—Specify, Plan, Tasks, Implement—with mandatory human review at each stage to catch misalignment and incorrect assumptions before any code is written.

How do I validate ambiguous requirements for feature development?

You validate ambiguous requirements for feature development by applying adaptive guardrails and a structured spec template that defines testable success criteria and explicit acceptance criteria, ensuring stakeholders and developers align before implementation.

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

Spec-driven development is a pre-coding workflow that produces living, version-controlled specifications with defined operational boundaries. You should use it for new project builds, multi-file changes, and architectural decisions where clear, aligned requirements are critical to success.

Can I use a structured spec template for multi-file changes and architectural decisions?

Yes, a structured spec template works for multi-file changes and architectural decisions by guiding creation of comprehensive, version-controlled specs covering tech stack, project structure, code style, testing strategy, and testable success criteria.

How do I handle requirement validation when project scope evolves during implementation?

Handle requirement validation when project scope evolves by using adaptive guardrails that include processes to update living specifications as requirements change, keeping version-controlled specs aligned with project reality during development.

Why does skipping software specifications lead to costly rework cycles?

Skipping software specifications leads to costly rework cycles because coding without validated requirements causes misalignment between developers and stakeholders, resulting in wasted effort on incorrect feature builds that delay project delivery.