mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-11 19:47:12 +03:00
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.