skills sourced live from GitHub · all skills listed are free · each skill is provided under its author's license.
home / Project Management / Spec Driven Workflow Skill by @alirezarezvani
The skill is the engineering/skills/spec-driven-workflow folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.
Enforces writing a specification before code, then validating it and extracting tests from it.
Treats the spec as a contract with required sections and standard requirement keywords, and sets bounded autonomy rules including when to stop and ask. Scripts generate, validate and extract tests from specs.
The original SKILL.md is organised into these sections:
Written and maintained by @alirezarezvani. It is published under the MIT license, which allows reuse with attribution. See the author profile. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.
# Spec-Driven Workflow — POWERFUL ## Overview Spec-driven workflow enforces a single, non-negotiable rule: **write the specification BEFORE you write any code.** Not alongside. Not after. Before. This is not documentation. This is a contract. A spec defines what the system MUST do, what it SHOULD do, and what it explicitly WILL NOT do. Every line of code you write traces back to a requirement in the spec. Every test traces back to an acceptance criterion. If it is not in the spec, it does not get built. ### Why Spec-First Matters 1. **Eliminates rework.** 60-80% of defects originate from requirements, not implementation. Catching ambiguity in a spec costs minutes; catching it in production costs days. 2. **Forces clarity.** If you cannot write what the system should do in plain language, you do not understand the problem well enough to write code. 3. **Enables parallelism.** Once a spec is approved, frontend, backend, QA, and documentation can all start simultaneously. …
Excerpt only, quoted from the author's repository. Open the repository for the complete file.