Spec-Driven Development for AI Software Factories

A methodology where structured specifications are the executable input to an AI code generation pipeline. Quality gates enforce correctness at each phase.

Why Install This Skill

When your agent loads this skill, it becomes a software factory designer who can:

Design an SDD pipeline — 5-phase pipeline from SPECIFY to DELIVER with 4 phase gates
Write great specs — 7 spec quality gates that separate precise specs from vague ones
Choose spec methodologies — BDD, OpenAPI, AsyncAPI, DbC, TLA+, ADRs, C4 — matched to your context
Encode NFRs — performance, security, observability requirements in machine-readable format
Translate between formats — PRD → SPEC.md → Gherkin → OpenAPI
Handle gate recovery — revision workflows when specs fail review

What You Get

Directory	Purpose
`SKILL.md`	Pipeline overview, loading guide, methodology quick-pick
`references/`	9 reference files: overview, pipeline, quality gates, phase gates, methodology matrix, NFR encoding, format translation, critiques, example spec
`templates/`	4 spec templates
`scripts/`	2 validation scripts

Triggers

Load this when designing a spec-driven pipeline, writing an AI-ready specification, or setting up quality gates for AI code generation.

Requirements

Tool-agnostic — works with Claude Code, Cursor, Hermes Agent, Devin, OpenHands, droid, or any AI coding agent.

Quick Start

Start with the setup and first workflow in SKILL.md, then use the linked resources for the specific task you need to complete.

1.6 KiB Raw Permalink Blame History