spec-kit-clarify

Resolve feature specification ambiguities through a four-agent debate system.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CLOCKWORK-TEMPTATION/plugin_01UphfxAg16yZB4YodKYf1RZ --skill spec-kit-clarify-clockwork-temptation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-kit-clarify
Source: https://github.com/CLOCKWORK-TEMPTATION/plugin_01UphfxAg16yZB4YodKYf1RZ/tree/main/skills/spec-kit-clarify
Command: npx skills add https://github.com/CLOCKWORK-TEMPTATION/plugin_01UphfxAg16yZB4YodKYf1RZ --skill spec-kit-clarify-clockwork-temptation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Identify and resolve ambiguities in feature specifications using a structured, multi-agent debate system to produce precise requirements and reduce rework.

Core Features & Use Cases

  • Four specialized agents (Interrogator, Respondent, Skeptic, Arbiter) collaborate to surface gaps, validate constraints, and reach a final spec decision.
  • Automates structured requirement refinement, enabling teams to refine, document, and agree on unclear requirements before planning.
  • Use Case: when a product spec has unclear acceptance criteria or conflicting constraints, run the debate to surface ambiguities and update the spec accordingly.

Quick Start

Initiate the spec clarification workflow on the current feature specification.

Frequently Asked Questions about spec-kit-clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve ambiguities in feature specifications before development?

To resolve ambiguities in feature specifications, you can use a structured multi-agent debate system that surfaces gaps and finalizes spec amendments. It engages four specialized agents to evaluate conflicting constraints and automatically embeds final decisions back into the spec.

What is a multi-agent debate system for requirement clarification?

A multi-agent debate system for requirement clarification uses four specialized agents—Interrogator, Respondent, Skeptic, and Arbiter—to collaboratively validate constraints, surface gaps, and reach a final spec decision, producing a precise audit trail.

How do I clarify unclear acceptance criteria in a product spec?

To clarify unclear acceptance criteria in a product spec, initiate a structured debate workflow that runs prerequisite checks automatically. The workflow interrogates constraints, finalizes spec decisions, and updates the document with embedded amendments.

Does the specification clarification workflow require manual prerequisite checks?

No, the specification clarification workflow runs prerequisite checks automatically before engaging the four agents. This ensures the feature specification is fully validated and prepared before the clarification debate begins.

Can I use multi-agent debate for conflicting constraints in requirements?

Yes, you can use multi-agent debate for conflicting constraints in requirements. The Skeptic agent evaluates available options while the Arbiter reaches a final decision, effectively resolving the conflict and embedding the outcome into the specification.

What is the best way to document decisions when refining requirements?

The best way to document decisions when refining requirements is using a structured workflow that produces an audit trail. It automatically embeds finalized spec amendments directly back into the original feature specification document.