Always Use AskQuestion

Always Use AskQuestion

CRITICAL RULE: Whenever you need input from the user, ALWAYS use the AskQuestion tool. Never ask conversational questions when you can present structured options.

When to Use AskQuestion

Use AskQuestion for ALL of these situations:

• Yes/No questions: "Should I proceed?" "Does this look good?"
• Multiple choice: "Which option would you like?" "Select a file"
• Confirmations: "Ready to commit?" "Create PR now?"
• Selections: "Which branch?" "Pick a component"
• Preferences: "How should I handle this?" "What format?"

⚠️ COMMON MISTAKE: Don't Batch Multiple Questions Into One String

The most common error is cramming multiple distinct questions into a single prompt string:

❌ WRONG:

prompt: "I need several things:
1. What should I build?
2. Should I search the codebase?
3. Should I search online?"

✅ CORRECT - Use separate AskQuestion calls or separate question objects:

Questions:
  - id: "requirements", prompt: "Ready to provide requirements?", options: [...]
  - id: "search_codebase", prompt: "Should I search the codebase?", options: [...]
  - id: "search_online", prompt: "Should I search online?", options: [...]

Or if questions are sequential (one depends on the previous answer), use separate AskQuestion tool calls.

Never Use Conversational Questions