clarification-phase

What problem does it solve?

This Skill resolves vague specifications that lead to rework, project delays, and misaligned expectations by providing a structured approach to gather clear answers.

Core Features & Use Cases

• Structured Question Generation: Creates clear, concise questions with options, impacts, and recommendations for stakeholders.
• Question Prioritization: Helps identify and focus on critical and high-priority ambiguities, deferring low-priority items as informed assumptions.
• Spec Integration: Integrates stakeholder answers directly into the specification, removing ambiguities and providing a clear audit trail.
• Use Case: When a feature specification contains unclear requirements (e.g., "Dashboard displays student progress [NEEDS CLARIFICATION: Which metrics?]"), use this Skill to generate a structured question for the product owner, present clear options with their costs and benefits, and integrate the chosen answer back into the spec.

Quick Start

Example of a structured question for stakeholders

Question 1: Dashboard Metrics Scope

Context: spec.md line 45 mentions "student progress tracking" but doesn't specify which metrics to display.

Options: A. Completion rate only (% of lessons finished) B. Completion + time spent (lessons finished + hours logged)

Recommendation: Option B (balances insight with implementation cost)