mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-16 05:56:30 +03:00
Magnus Hedemark
738ec715e7
Each README is written for a human audience, explaining: - What the skill does (not what format it follows) - What benefit the user gets from installing it - Quick setup and usage patterns - When to load/trigger the skill - What scripts, references, and templates it ships data-scientist already had a README — left unchanged. 48 READMEs added across all skill and bundle directories.
32 lines
1.5 KiB
Markdown
32 lines
1.5 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.
|