What problem does it solve?
Vague operator requests for new features, bug fixes, or backlog ticket promotions often lack clear requirements, leading to misaligned implementation, rework, scope creep, and wasted development effort.
Core Features & Use Cases
- Versioned Spec Generation: Drafts formal, versioned requirement specifications with explicit acceptance criteria, in-scope/out-of-scope definitions, and risk notes from raw operator intent or backlog tickets.
- Ambiguity Resolution: Runs a structured clarify phase to surface hidden ambiguities with multiple choice questions and recommendations before any code is written, preventing wrong-direction work.
- Lane Classification: Automatically classifies small, reversible changes as Lightweight to skip over-documentation, routing them to a streamlined change-note workflow instead of a full spec.
- Use Case: When a product owner says "let's add a user notification feature", this skill drafts a full spec with acceptance criteria, asks clarify questions about notification triggers and channels, and routes trivial typo fixes to the lightweight lane to save time.
Quick Start
Use the requirements-specification skill to turn the operator's request to "add a user export feature" into a versioned spec with acceptance criteria and clarify questions.