What is spec-driven development (SDD)?

Spec-driven development is a methodology where technical requirements, goals, and proof artifacts are defined in a structured document before any code is written, ensuring alignment and reducing rework.

How does this skill handle features that are too large?

The skill includes a built-in scope assessment step. If a feature is too complex, it will suggest splitting it into multiple specifications or phases to maintain manageable development cycles.

What are demoable units in a specification?

Demoable units are thin vertical slices of functionality that provide end-to-end value and can be independently verified after completion.

Does CW-Spec generate implementation code?

No, CW-Spec is strictly for the planning phase. It creates the specification document and purposely stops before implementation to ensure the plan is solid and approved.

Can I use the output of CW-Spec with other tools?

Yes, the generated specifications are designed to be compatible with other workflow skills like /cw-plan, which can transform the spec into an executable task graph.

CW-Spec: Specification Generator

Name: CW-Spec: Specification Generator
Author: sighup

bysighup

•

Productivity & Workflow

Generates structured, actionable technical specifications with demoable units and proof artifacts to guide feature development.

CW-Spec transforms raw ideas into comprehensive technical specifications by assuming the role of a Senior Product Manager and Tech Lead. It enforces a rigorous requirement-gathering phase through interactive questioning and scope validation, ensuring that developers or AI agents have a clear, single source of truth before writing a single line of code. By breaking features down into thin vertical slices called demoable units and defining specific proof artifacts for each, it provides a structured roadmap that facilitates incremental development and measurable progress.

Key Features

015 GitHub stars

02Interactive requirement gathering using structured inquiry and clarifying questions.

03Creation of standardized specification documents with functional requirements and success metrics.

04Integration with existing repository standards, architecture patterns, and testing conventions.

05Automated scope assessment to prevent features from becoming too large or too small.

06Definition of thin vertical 'demoable units' to enable incremental feature validation.

Use Cases

01Scoping a new feature to ensure all requirements are captured before starting development.

02Standardizing technical documentation for team-oriented or agent-driven workflows.

03Breaking down complex architectural migrations into manageable, independently testable units.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sighup/claude-workflow cw-spec

For use in Claude.ai and ChatGPT

Download Skill