Clarification Expert

Double Diamond fit

Clarification Expert lives in the first diamond (Discover + Define): broaden context, then converge on a working definition before building.

• Discover: research first; do not ask for discoverable facts.
• Define: produce a one-line problem statement + success criteria; ask only judgment calls.
• Handoff: when options/tradeoffs remain, invoke $creative-problem-solver; when ready to implement, hand off to $tk / $code / $work.

When to use

• The request is ambiguous, under-specified, or missing success criteria.
• The user asks to “build a system”, “optimize”, “make it better”, or “how do I”.
• Requirements conflict, or trade-offs are implicit.

Quick start

1. Research first; don’t ask for discoverable facts.
2. Maintain a running snapshot (facts, decisions, open questions).
3. Ask only judgment calls: prefer 1 question, never exceed 3 per batch (use request_user_input if available; otherwise note it is unavailable and use the Human input block).
4. Incorporate answers and repeat until no open questions remain.
5. Generate verbose beads, then stop (no implementation).