What problem does it solve? Specifications often contain ambiguous requirements, vague adjectives, and unresolved [NEEDS CLARIFICATION] markers that block planning and implementation. This Skill provides a disciplined protocol for resolving those ambiguities while keeping the spec and downstream planning aligned. ## Core Features & Use Cases - Marker Resolution: Scans .swarm/spec.md for [NEEDS CLARIFICATION] markers and implicit ambiguities such as vague adjectives, conflicting requirements, and untestable acceptance criteria. - Structured Questioning: Presents questions one at a time (max 8 per session) with 2-4 multiple-choice options, a recommended choice with reasoning, and free-form input support. - Critic Safeguards: Consults a critic sounding board before surfacing each question, applies an overconfidence guard against unsupported self-resolution, and enforces always-surface protection for scope, security, and breaking-change categories. - Delta-Based Updates: Writes accepted answers back to spec.md immediately using ADDED/MODIFIED/REMOVED requirement sections with strict FR-ID increment rules. - Use Case: After generating a spec with open markers, run the clarify flow to resolve each ambiguity interactively, then receive a Clarification Summary recommending whether to proceed to PLAN. ## Quick Start Ask the agent to clarify the open markers in .swarm/spec.md and answer each question as it is presented.
