What problem does it solve? Software specifications often contain vague language, unresolved [NEEDS CLARIFICATION] markers, and conflicting requirements that block planning and implementation. This Skill provides a structured protocol for resolving those ambiguities one question at a time while keeping the spec source consistent. ## Core Features & Use Cases - Marker Resolution: Scans the effective spec for [NEEDS CLARIFICATION] markers and implicit ambiguities such as vague adjectives, conflicting requirements, and untestable acceptance criteria. - Source-Aware Write-Back: Writes accepted answers to the resolved effective source (native .swarm/spec.md, OpenSpec, or Spec-Kit) without shadowing non-native specs. - Critic-Guarded Questioning: Consults a critic sounding board before surfacing each question, with overconfidence guards and always-surface protection for high-risk categories like security and breaking changes. - Use Case: After running /swarm specify, your spec contains six open markers. Invoke this Skill to walk through each ambiguity with multiple-choice options, then receive a clarification summary and a recommendation to proceed to planning. ## Quick Start Ask the assistant to clarify the open markers in the current effective spec by saying "clarify my spec" or invoking /swarm clarify.
