# 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.