agentic-clarification

Resolve vague user requests through structured clarification and parallel codebase exploration.

273|26|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/tmdgusya/roach-pi --skill agentic-clarification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentic-clarification
Source: https://github.com/tmdgusya/roach-pi/tree/main/extensions/agentic-harness/skills/agentic-clarification
Command: npx skills add https://github.com/tmdgusya/roach-pi --skill agentic-clarification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ambiguity in user requests leads to vague outcomes, delays, and rework. This skill drives a structured clarification loop that asks focused questions while concurrently exploring the codebase with subagents, producing a concrete context brief that sharpens scope and enables precise planning.

Core Features & Use Cases

  • One-question-per-message discipline to progressively narrow scope.
  • Always-on parallel codebase exploration using subagents to surface constraints and context.
  • Generates a Context Brief that captures goal, scope, technical context, constraints, and success criteria.
  • Stores the final brief to a standardized path for downstream planning tools.
  • Guards against raw exploration noise by summarizing findings and surfacing actionable decisions.

Quick Start

Describe your goal in one line and I will ask a single clarifying question before exploring the codebase with subagents.

Frequently Asked Questions about agentic-clarification

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

FAQPage Schema
How do I resolve ambiguity in a vague software request before planning?

To resolve ambiguity in a vague software request, initiate a structured clarification loop that asks focused questions one at a time while concurrently exploring the codebase. This progressively narrows scope and produces a concrete context brief for precise planning.

How do I explore the codebase while clarifying user requirements?

You can explore the codebase while clarifying requirements by deploying subagents for parallel code exploration during the questioning loop. This surfaces technical constraints and context concurrently, summarizing findings into actionable decisions without raw exploration noise.

What is a context brief and when do I need it for software planning?

A context brief is a consolidated document capturing the goal, scope, technical context, constraints, and success criteria of a request. You need it when vague user inputs require sharpening into a clear scope to enable precise downstream planning.

Does iterative clarification work without prior dependencies or components?

Yes, iterative clarification works without prior dependencies or components. The skill independently coordinates user questioning with parallel codebase exploration to yield a clear scope and context brief, requiring only a one-line goal description to start.

Best way to prevent rework caused by unclear project scope?

The best way to prevent rework from unclear project scope is enforcing one-question-per-message discipline alongside parallel codebase exploration. This approach guards against raw exploration noise and generates a standardized context brief capturing actionable decisions.

Where should I store the context brief for downstream planning tools?

You should store the context brief in the standardized path docs/engineering-discipline/context. Storing the final brief here routes the consolidated goal, scope, and constraints directly to subsequent planning tools.