clarification

Resolve vague requests through iterative Q&A and parallel codebase exploration.

124|22|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/tmdgusya/engineering-discipline --skill clarification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarification
Source: https://github.com/tmdgusya/engineering-discipline/tree/main/skills/clarification
Command: npx skills add https://github.com/tmdgusya/engineering-discipline --skill clarification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill narrows vague user requests into well-defined work scopes by running an iterative Q&A loop and coordinating subagents to explore the codebase in parallel, producing a clear context brief for planning.

Core Features & Use Cases

  • Iterative Q&A to resolve ambiguity with one-question-per-message discipline.
  • Parallel codebase exploration via subagents to map context while questions are asked.
  • Output a saved Context Brief that guides planning and can drive downstream plan-crafting.

Quick Start

Start the clarification workflow and answer one focused question at a time to generate a context brief.

Frequently Asked Questions about clarification

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

FAQPage Schema
How do I clarify vague requirements before starting software development?

Iterative Q&A resolves ambiguity in vague requirements by enforcing one-question-per-message discipline and orchestrating parallel subagent exploration to produce a concrete context brief. This narrows underspecified user requests into well-defined work scopes.

What is the best way to resolve ambiguity in a codebase during product discovery?

Resolving ambiguity during product discovery is handled by coordinating subagents to explore the codebase in parallel while asking iterative questions. This maps existing context and aligns goals with the current state before planning begins.

How do I generate a context brief for scoping a new feature?

To generate a context brief for scoping, start the clarification workflow and answer focused questions one at a time. The process automatically outputs a saved brief that guides planning and drives downstream plan-crafting.

Does this clarification workflow support parallel codebase exploration?

Yes, parallel codebase exploration is supported via subagents that map context while questions are asked. This allows simultaneous requirement gathering and code exploration to efficiently produce a context brief.

When should I use an iterative Q&A loop for software requirements?

An iterative Q&A loop should be used for software requirements during initial scoping, product discovery, and codebase analysis when requests are vague or underspecified. It enforces structured questioning to align goals with existing state.