mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-14 21:16:36 +03:00
37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
# 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.
|