What problem does it solve? Feature specifications often contain ambiguous requirements, missing edge cases, and vague non-functional criteria that cause rework during planning and implementation. This Skill systematically scans a spec-kit feature spec, asks up to five high-impact clarification questions, and writes the answers directly back into the spec file. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec against a taxonomy covering functional scope, data model, UX flows, non-functional attributes, integrations, edge cases, constraints, and terminology. - Interactive Questioning Loop: Presents one question at a time with a recommended multiple-choice option or suggested short answer, capped at five questions per session. - Incremental Spec Updates: Appends each accepted answer to a ## Clarifications session section and applies it to the relevant spec section, saving after every write. - Use Case: Before running /speckit-plan on a new feature branch, run this Skill to resolve open questions about security posture, scale assumptions, and acceptance criteria so the implementation plan is built on confirmed decisions. ## Quick Start Ask the assistant to run the speckit-clarify workflow on the current feature spec to identify and resolve its most critical ambiguities.
