speckit-clarify

Scan feature specs for ambiguity and write up to five clarifications back.

Updated Dec 20, 2023
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill speckit-clarify-thiago-cruz-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/Thiago-Cruz-eng/Hibrygame/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill speckit-clarify-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces ambiguity in a feature specification by guiding you through up to five focused clarifications and then writing the answers back into the spec.

Core Features & Use Cases

  • Underspecification detection: Scans the active feature spec across functional, data model, UX, quality attributes, dependencies, edge cases, constraints, terminology, and acceptance criteria.
  • Guided clarification loop: Asks exactly one question at a time (up to 5 total), using either multiple-choice options or tightly constrained short answers to minimize ambiguity.
  • Spec self-updating: Creates a session-based clarifications section (if needed) and applies each accepted answer to the most relevant parts of the spec, saving the updated spec after each integration.

Quick Start

Run the speckit-clarify command in your speckit project (with the current feature spec present) and answer the up to five questions to update your spec before planning.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I reduce ambiguity in a feature specification before planning?

To clarify feature specs, the scan checks functional requirements, data models, UX, quality attributes, dependencies, edge cases, constraints, terminology, and acceptance criteria to detect missing details.

How do I write clarifications back into a spec file automatically?

The guided clarification loop asks exactly one question at a time, up to five total, using multiple-choice options or tightly constrained short answers to minimize ambiguity before updating the spec.

Does speckit-clarify work with any product planning document?

Before clarifying specs, you must check prerequisites via a Powershell script and honor optional or middle extension hooks to ensure the project structure supports the interactive clarification process.

What is the best way to detect underspecification in a feature spec?

After clarifying specs, the updated feature specification with integrated clarifications serves as input for downstream product planning, task breakdown, and development workflow execution.

Can I use speckit-clarify to add custom pre-clarification behavior to my spec workflow?

Complementary speckit tools manage the project structure, current spec file tracking, and feature spec creation, working in synergy to provide the baseline document for the ambiguity scan.

Are there limitations to how many questions speckit-clarify asks to update a spec?

Alternative product planning tools offer manual review processes or general AI brainstorming to identify missing requirements, yielding less structured spec updates without interactive constrained Q&A.