A structured approach to transform vague ideas into detailed specifications through dialogue with Claude Code.
This work is provided under CC-BY-NC-4.0 (Creative Commons Attribution-NonCommercial 4.0).
- ✅ Free for educational and non-commercial use
- ✅ Share, adapt, and build upon it (with attribution)
- ❌ Not permitted for commercial purposes without explicit permission
See LICENSE and NOTICE for full details.
For commercial use, contact: Simone Leonelli (https://w230.net)
The SPEC Workflow is a three-step process that forces clarity before implementation:
- Create — Write a minimal SPEC.md (2–5 paragraphs)
- Interview — Dialogue with Claude Code to refine assumptions
- Finalize — Claude writes the detailed specification
Building without a specification is building with hope. Hidden assumptions only reveal themselves during rework.
The SPEC workflow ensures:
- Precision in intent before writing code
- Explicit assumptions that are challenged early
- Blueprint clarity that prevents costly rework
- Create a
SPEC.mdfile for your next project (minimal draft, 2–5 paragraphs) - Share it with Claude Code using the interview prompt from the guide
- Let the dialogue reveal what you truly need to build
This repository: The polished, documented SPEC methodology that anyone can learn from and apply.
Your process: Keep your personal notes, iterations, implementation details, and project-specific contexts private.
The guide teaches the pattern. Your specific use cases, learnings, and refinements stay with you—giving you unique advantage while you publicly establish thought leadership on the methodology itself.
Result: You share the blueprint everyone can use, while keeping your competitive advantage in how you apply it.
~30 minutes of structured dialogue. Saves weeks of rework.
Inspired by @trq212's insights on spec-driven development.
By Simone Leonelli • December 2025