What problem does it solve?
This Skill helps identify and reduce underspecified areas in feature specifications by asking up to 5 highly targeted clarification questions, encoding answers back into the spec, and improving the spec's clarity and completeness.
Core Features & Use Cases
- Identify Underspecified Areas: Detect and reduce ambiguity or missing decision points in the active feature specification.
- Interactive Questioning Loop: Sequentially present questions to the user, allowing for answers that can be short answers or multiple-choice selections.
- Integration into Spec: Record clarifications directly in the spec file, updating sections as needed.
- Spec Quality Checklist: Re-validate the spec quality checklist against the updated spec (if available).
- Completion Report: Provide a report on the number of questions asked & answered, path to the updated spec, and spec quality checklist status.
Quick Start
Use the speckit-clarify skill to clarify a feature specification by running the command: /speckit-clarify [optional areas to clarify in the spec].