spec-driven-workflow

Guide spec-first development with signed specs and acceptance criteria.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/metaarchetech/metaarchetech.github.io --skill spec-driven-workflow-metaarchetech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-workflow
Source: https://github.com/metaarchetech/metaarchetech.github.io/tree/main/content/05%20Claude%20Skills/spec-driven-workflow
Command: npx skills add https://github.com/metaarchetech/metaarchetech.github.io --skill spec-driven-workflow-metaarchetech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps to mitigate scope creep, reduce ambiguity, and enhance collaboration in software development by implementing specifications before coding.

Core Features & Use Cases

  • Spec-first Development: Encourages writing specifications for acceptance criteria before implementing features.
  • Test-Driven Approach: Generates test stubs from specs and ensures test cases pass before coding.
  • Feature Integration: Supports complex projects like VisTwin by providing a structured approach to feature development.

Quick Start

Implement a new feature following the spec-first workflow: write a spec document, generate test stubs, get customer approval, and then implement to make tests pass.

Frequently Asked Questions about spec-driven-workflow

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

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

Spec-first development requires writing a signed specification document with defined acceptance criteria before any code is written. This structured approach prevents scope creep and reduces ambiguity by ensuring all feature development is based on approved, testable requirements.

How do I implement a new feature using a spec-first workflow?

To implement a feature using a spec-first workflow, write a spec document defining acceptance criteria, generate test stubs from the spec, get customer sign-off on the requirements, and then write implementation code to make the tests pass.

Can I use spec-first development for complex internal software projects?

Yes, spec-first development is intended for cross-functional teams working on complex customer-facing features or significant internal projects. It provides a structured approach to ensure requirements are testable and measurable before coding begins.

Does spec-first development work with test-driven development?

Spec-first development integrates directly with test-driven development by generating test stubs from the initial specifications. It enforces a test-driven approach where test cases must pass before the feature implementation coding is completed.

Why should cross-functional teams require a signed spec document before coding?

Requiring a signed spec document before coding ensures cross-functional teams have defined, measurable acceptance criteria. This mitigates scope creep, reduces ambiguity, and enhances collaboration by securing customer approval before development work starts.

When should I not use a spec-first software development process?

A spec-first software development process should be avoided for minor changes lacking complex acceptance criteria. It is designed for complex projects requiring measurable requirements, making it too heavy for rapid prototyping or trivial code modifications.