What problem does it solve?
Underspecified or ambiguous feature specifications lead to misalignment between stakeholders, wasted engineering effort, and deliverables that fail to meet acceptance criteria. This Skill eliminates that risk by systematically identifying gaps in your feature spec before planning begins.
Core Features & Use Cases
- Structured Ambiguity Scanning: Evaluates your feature spec across 10+ taxonomy categories (functional scope, data model, UX flows, non-functional requirements, integrations, edge cases, and more) to flag partial or missing information.
- Prioritized Clarification Workflow: Generates up to 5 high-impact, answerable questions per session, targeting gaps that most affect architecture, task decomposition, and test design to maximize rework reduction.
- Automatic Spec Integration: Records accepted answers directly into your feature spec file, updates relevant sections to resolve ambiguities, and validates the final document for consistency, no contradictory text, and complete coverage.
- Use Case: A product manager building a new user notification feature can use this Skill to identify missing details like notification delivery retry rules or accessibility requirements, record stakeholder answers in the spec, and ensure engineering has a clear, unambiguous blueprint for planning.
Quick Start
Invoke the speckit-clarify skill to identify and resolve all critical ambiguities in your active feature specification before proceeding to implementation planning.