What problem does it solve?
Converts an approved Gate 1 brief into a precise, internal specification of acceptance scenarios so downstream agents (plan, build, test) have clear, testable requirements and do not rely on assumptions.
Core Features & Use Cases
- Transforms brief capabilities into 1-3 user-focused acceptance scenarios per capability, including empty state, error/edge cases, and boundary conditions.
- Enforces product constitution rules and workflow transitions by updating workflow-state.json to advance the project to the planning phase.
- Use case: After discovery approves a brief for a new feature, run this Skill to produce spec.md that the build and test pipelines use to generate tasks and automated checks.
Quick Start
Convert the approved brief at .pi/specs/<feature>/brief.md into .pi/specs/<feature>/spec.md containing clear, independently testable acceptance scenarios and update the workflow state to proceed to planning.