
from tmdgusya
Iterative Q&A + code exploration pattern to resolve vague user requests into a clear Context Brief.
Narrows vague user requests into well-scoped work by running an iterative one-question-per-message Q&A loop while dispatching parallel code-exploration subagents. Produces a Context Brief containing Goal, Scope, Technical Context, Constraints, Success Criteria, Open Questions, and a Complexity Assessment to route next steps.
Core rules:
Example triggers:
Repository: https://github.com/tmdgusya/roach-pi
Agentic Clarification is a pure-instruction skill (no scripts) that guides an agent through iterative Q&A and optional codebase exploration to resolve vague user requests into a structured Goal Contract. Well-documented with clear triggers, anti-patterns, red flags, and a minimal checklist. Assumes a specific runtime ecosystem (Goal Contract, clarification_state tool) that may not be universally available. No security concerns — no code execution, no network calls, no credentials.
Clean instructional skill with no executable code. Tightly coupled to the roach-pi agentic ecosystem (Goal Contract runtime, clarification_state tool, explorer subagent). Useful within that ecosystem but less portable as a standalone skill.