speckit-clarify

Analyze feature documentation against a taxonomy and resolve ambiguities interactively.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/Asharf30/Brainwave --skill speckit-clarify-asharf30
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/Asharf30/Brainwave/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/Asharf30/Brainwave --skill speckit-clarify-asharf30

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the common issue of underspecified feature requirements by identifying gaps in logic, scope, and edge cases before development begins.

Core Features & Use Cases

  • Ambiguity Detection: Scans feature specifications against a comprehensive taxonomy to pinpoint missing decision points.
  • Interactive Clarification: Engages the user with up to 5 high-impact questions to resolve uncertainties.
  • Automated Integration: Directly records answers into the specification file and updates project checklists to ensure alignment.

Quick Start

Invoke the speckit-clarify skill to analyze the current feature specification and resolve any outstanding ambiguities.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I eliminate ambiguity in feature documentation before development?

To eliminate ambiguity in feature documentation, you can use a structured taxonomy to scan specifications for gaps in logic and scope, then resolve missing decision points through interactive questioning. This ensures requirements are consistent, testable, and unambiguous.

How does taxonomy-based analysis detect missing decision points in software requirements?

Taxonomy-based analysis detects missing decision points by scanning feature specifications against a comprehensive category framework. It identifies underspecified areas in logic, scope, and edge cases before implementation planning begins.

What's the best way to clarify underspecified feature requirements interactively?

The best way to clarify underspecified feature requirements is engaging with up to five high-impact interactive questions. This targeted approach resolves uncertainties efficiently while maintaining focus on critical specification gaps.

Can I automatically record clarification answers directly into a specification file?

Yes, you can automatically record clarification answers directly into a specification file. Automated integration updates the source documentation and project checklists to ensure development alignment without manual copy-pasting.

Does this clarification process work for quality assurance workflows in software engineering?

Yes, this clarification process works for quality assurance workflows. It satisfies the need for high-fidelity, testable feature specifications by resolving unspecified edge cases before the implementation phase begins.

When should I not use interactive questioning for feature specification gaps?

You should avoid interactive questioning when feature documentation is completely missing rather than underspecified, as this process targets existing specifications to resolve specific ambiguities rather than generating initial requirements from scratch.