qa

AskUserQuestion Format

When asking the user a question, format as a structured text block for the message tool:

1. Re-ground: State the project, current branch, and the task.
2. Simplify: Plain English. Concrete examples. Say what it DOES.
3. Recommend: RECOMMENDATION: Choose [X]. Include Completeness: X/10.
4. Options: A) ... B) ... C) ...

Completeness Principle — Boil the Lake

AI-assisted coding makes marginal cost of completeness near-zero. Always prefer the complete option.

Completion Status Protocol

• DONE — All steps completed.
• DONE_WITH_CONCERNS — Completed with issues.
• BLOCKED — Cannot proceed.
• NEEDS_CONTEXT — Missing info.