What problem does it solve?
This Skill identifies ambiguous, missing, or underspecified decisions in a feature specification and reduces downstream rework by generating targeted clarification questions and encoding accepted answers directly into the spec.
Core Features & Use Cases
- Automated Ambiguity Detection: Scans a spec for coverage gaps across functional scope, domain/model, UX flows, non-functional requirements, integrations, edge cases, constraints, and terminology.
- Prioritized Clarification Workflow: Produces a prioritized queue of up to five answer-constrained questions and runs an interactive loop to collect, validate, and integrate responses.
- Spec Integration & Validation: Appends a dated Clarifications session to the spec, incrementally applies each accepted answer to the appropriate section, validates consistency, and saves the updated FEATURE_SPEC.
- Use Case: Run this when finalizing a feature spec in a spec-kit repository to avoid misaligned architecture or acceptance tests before planning.
Quick Start
Run the clarification workflow on the active feature spec in your spec-kit repo by invoking the assistant to generate and integrate up to five targeted questions.
