What problem does it solve?
Helps teams detect underspecified areas and decision gaps in a feature specification and prevents downstream rework by eliciting concise clarifications and encoding them back into the spec file.
Core Features & Use Cases
- Detects ambiguity and coverage gaps across functional scope, data model, UX flows, non-functional requirements, integrations, edge cases, constraints, and terminology.
- Generates a prioritized queue of up to five targeted, answer-constrained clarification questions and runs a sequential interactive loop that records accepted answers.
- Integrates answers directly into the FEATURE_SPEC, preserves heading hierarchy, creates a dated Clarifications session, runs pre/post extension hooks when present, and performs validation on each write.
- Use case examples: a product manager refining acceptance criteria before planning, an engineer resolving data-model uncertainties before implementation, or a reviewer ensuring testable success criteria.
Quick Start
Use speckit-clarify to scan the active feature spec, ask up to five targeted clarification questions, and integrate accepted answers back into the feature spec file.