spec-driven-development

Generate structured specs with six core sections and eval assertions.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/az9713/dark-code-skills --skill spec-driven-development-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/az9713/dark-code-skills/tree/main/skills/spec-driven-development
Command: npx skills add https://github.com/az9713/dark-code-skills --skill spec-driven-development-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that every software effort starts from a precise, testable specification rather than guesswork, aligning teams around a shared objective and reducing rework.

Core Features & Use Cases

  • Spec-first planning: Define objectives, acceptance criteria, and constraints before writing code.
  • Phase-gated workflow: Guides the project through Specify, Plan, Tasks, Implement, and Comprehension Gate to prevent scope creep.
  • Eval harness & governance: Generates eval assertions and a spec-as-eval plan so implementation can be tested against explicit criteria.
  • Open collaboration: Enables multiple stakeholders to align on requirements and validation criteria before committing changes.

Quick Start

Write a complete spec document for your upcoming feature following the six sections and include explicit eval assertions.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
What is spec-driven development and when should I use it for my software project?

Spec-driven development starts software efforts from a precise, testable specification instead of guesswork. Use it to align teams around shared objectives and reduce rework when starting new projects or changes with ambiguity.

How do I write a software specification before coding to prevent scope creep?

To write a software specification, define objectives, acceptance criteria, and constraints across six core sections. Guide your project through phase-gated workflows from Specify to Comprehension Gate to prevent scope creep.

How does a phase-gated workflow enforce documentation requirements for new features?

A phase-gated workflow enforces documentation by guiding projects through Specify, Plan, Tasks, Implement, and Comprehension Gate stages. It requires recording a version-controlled spec artifact with six core areas and boundaries in the repository.

Can I generate eval assertions from a project specification to test implementation?

Yes, you can generate eval assertions from a project specification. The process creates a spec-as-eval plan so implementation can be tested against explicit criteria and validation rules defined during the planning phase.

Does spec-first planning work for managing ambiguity in existing software changes?

Spec-first planning works for managing ambiguity in existing software changes by requiring a structured spec with six core sections before coding. It aligns multiple stakeholders on validation criteria and boundaries to prevent scope creep.

What is the best way to transition from a specification to a task workflow?

The best way to transition from a specification to a task workflow is using a plan-to-task workflow process. It moves the project through the Plan and Tasks phases to ensure implementation follows the version-controlled spec artifact.