spec-clarify

Generate targeted questions to clarify ambiguous project scope.

2|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/leanbusqts/agent47 --skill spec-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-clarify
Source: https://github.com/leanbusqts/agent47/tree/main/templates/skills/spec-clarify
Command: npx skills add https://github.com/leanbusqts/agent47 --skill spec-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ambiguity in requirements and scope can derail projects. spec-clarify helps teams surface, document, and resolve uncertainties before coding.

Core Features & Use Cases

  • Restate goal and current understanding
  • List explicit assumptions and open questions
  • Identify edge cases and acceptance criteria
  • Propose minimal viable next steps for clarity

Quick Start

Use this skill at the start of a feature or task with vague requirements. Example input: "Clarify onboarding flow requirements: user questions, data inputs, success criteria."

Frequently Asked Questions about spec-clarify

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

FAQPage Schema
How do I clarify ambiguous project scope before starting development?

To clarify ambiguous project scope, you restate the goal, list explicit assumptions, and generate targeted questions to surface uncertainties before coding begins. This ensures early-stage feature planning captures open questions and edge cases.

What is the best way to gather requirements for a feature with vague specifications?

The best way to gather requirements for vague specifications is to prompt for data shapes, restate current understanding, and outline risks. This approach refines specs by identifying acceptance criteria and proposing minimal viable next steps for clarity.

How do I identify edge cases and assumptions during early-stage planning?

You identify edge cases and assumptions during planning by systematically restating project goals and generating targeted questions. This process documents uncertainties and defines clear acceptance criteria for the implementation phase.

When do I need to use targeted questions for requirements gathering?

You need to use targeted questions for requirements gathering at the start of a feature or task when details are unclear. It helps document open questions, prompt for data inputs, and outline risks before implementation begins.

Can I use this approach to refine specs and define acceptance criteria for onboarding flows?

Yes, you can use this approach to refine specs and define acceptance criteria for onboarding flows. By inputting user questions and success criteria, it restates goals and lists assumptions to resolve scope ambiguities.

What limitations exist when trying to resolve project uncertainties upfront?

A limitation of resolving project uncertainties upfront is that it focuses on early-stage planning rather than implementation. It produces questions, assumptions, and next steps, requiring subsequent manual resolution before development can proceed.