What problem does it solve?
Detects and reduces ambiguity in underspecified feature specifications so planning and implementation proceed with clear, testable acceptance criteria and minimal rework.
Core Features & Use Cases
- Structured ambiguity scanning: Performs a coverage-based taxonomy scan across functional scope, data model, UX flows, non-functional attributes, integrations, edge cases, constraints, and terminology.
- Prerequisite discovery: Runs the specified check-prerequisites script to locate FEATURE_DIR and FEATURE_SPEC and captures context needed for targeted questions.
- Interactive, prioritized questioning: Produces a prioritized queue of concise, answerable clarification questions (limited quota), recommends answers, accepts user input, and records each accepted answer.
- In-place spec integration & validation: Creates a Clarifications session in the spec, appends one bullet per accepted answer, updates relevant sections, validates structure, and saves the FEATURE_SPEC atomically after each integration.
- Use case: Run before planning to convert vague requirements into actionable, measurable acceptance criteria and data model changes.
Quick Start
Clarify the active feature spec by generating prioritized questions, capturing answers, and appending them under a new Clarifications session in FEATURE_SPEC.
