What problem does it solve?
STV Spec helps teams capture the WHY, decision rationale, and architectural direction in a single, repeatable workflow, reducing back-and-forth and misalignment between product, design, and engineering.
Core Features & Use Cases
- Decision Gate (MANDATORY) — Read the decision-gate.md and apply it to every decision to ensure governance and consistency across specs.
- Step 0 to Step 3 workflow: Proposal, Input Analysis, Business Interview, Architecture Interview, and Spec Writing, enabling a coherent progression from intent to implementation.
- Update vs New decision tree: Handles scenarios where an existing spec is extended or replaced with clear rules and changelogs.
- Output generation: Produces a docs/{feature-name}/spec.md with sections for overview, user stories, architecture, and traceability.
- Non-linear flow support: Allows actions to occur outside rigid phase boundaries when appropriate, while preserving auditability.
- Collaboration guidance: Guides interview-style input gathering and autonomous decisions where possible, reducing friction.
Quick Start
Start the STV spec workflow for your feature to generate a complete spec.md with decision gates and traceable steps.