spec-driven-workflow

Define approved specifications with Given/When/Then criteria before implementation.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill spec-driven-workflow-veloxia-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-workflow
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/skills/spec-driven-workflow
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill spec-driven-workflow-veloxia-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents teams from starting implementation before the requirements are clear, approved, and testable. It reduces rework, scope creep, and vague feature delivery by making the specification the source of truth.

Core Features & Use Cases

It guides you through a spec-first workflow: gather requirements, write a complete specification, validate it for completeness, derive tests from acceptance criteria, implement only what is approved, and self-review against the spec. It is especially useful for feature planning, acceptance-criteria authoring, API and data-model definition, edge-case coverage, and turning product intent into deterministic test cases. For example, when a new login or CRUD feature is requested, it helps you define the behavior, boundary cases, and contract details before any code is written.

Quick Start

Ask the skill to help you write a complete approved spec for your feature, then use that spec to generate acceptance criteria and test stubs before implementation begins.

Frequently Asked Questions about spec-driven-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a spec-first development workflow and how does it prevent scope creep?

A spec-first development workflow turns feature ideas into approved specifications before any code is written. By making the specification the source of truth and defining acceptance criteria upfront, it prevents scope creep, reduces rework, and keeps feature delivery deterministic.

How do I write complete acceptance criteria for a new software feature?

To write acceptance criteria for a software feature, you define traceable Given/When/Then criteria that cover structured requirements and edge cases. This ensures the behavior, boundary cases, and contract details are fully validated before implementation begins.

How do I generate test stubs from feature requirements before coding?

You can generate test stubs by deriving tests directly from the approved specification and its acceptance criteria. Once the feature behavior and boundary cases are defined, the workflow helps produce deterministic test cases to guide implementation.

Does defining API contracts before implementation reduce rework?

Defining API contracts before implementation reduces rework by validating data-model details and edge-case coverage early. Establishing a complete, approved specification ensures development remains scope-safe and deterministic rather than based on guesses.

What is the best way to turn product intent into deterministic test cases?

The best way to turn product intent into deterministic test cases is through a spec-first workflow that requires structured requirements, validation checks, and traceable Given/When/Then criteria. This ensures the generated tests accurately reflect the approved feature behavior.

When should I not use a spec-driven approach for feature planning?

You should avoid a spec-driven approach for feature planning if your project cannot afford the upfront time to gather structured requirements, author complete specifications, and define validation checks before writing code, as skipping these steps breaks the deterministic workflow.