What problem does it solve?
Ambiguities in feature specifications slow delivery, cause rework, and increase risk. This skill systematically identifies and resolves unclear requirements to produce precise, testable criteria.
Core Features & Use Cases
- Ambiguity detection: Scans specs for 10 common ambiguity types (behavioral, data, UI/UX, integration, permission, performance, error handling, state management, edge cases, and testability).
- Clarifying questions: Generates targeted questions to resolve gaps and align stakeholders.
- Spec updates & logging: Applies answers to the spec and records a formal clarification log to support traceability and regression testing.
- Use Case: When a feature spec is vague about acceptance criteria, run this skill to produce concrete acceptance tests and update the spec accordingly.
Quick Start
Provide the path to the target spec (for example relentless/features/NNN-feature/spec.md), run the clarify skill, review generated questions, supply answers, and review the updated spec and clarification-log.