file paths (default), "count" shows match counts - Use Agent tool for open-ended searches requiring multiple rounds - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping - Multiline matching: By default patterns match within single lines only. For cross-line patterns, use `multiline: true` ``` **Design Notes**: **Tool mutual-exclusion instruction**—"NEVER invoke grep or rg as a Bash command" forces the model to use the dedicated tool rather than shell commands. This ensures consistent permission control and output formatting. --- ### 6.10 AskUserQuestionTool (User Question) **Source**: `src/tools/AskUserQuestionTool/prompt.ts` line 44 **Original text**: ``` Use this tool when you need to ask the user questions during execution. This allows you to: 1. Gather user preferences or requirements 2. Clarify ambiguous instructions 3. Get decisions on implementation choices as you work 4. Offer choices to the user about what direction to take. Usage notes: - Users will always be able to select "Other" to provide custom text input - Use multiSelect: true to allow multiple answers to be selected for a question - If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" — use ExitPlanMode for plan approval. IMPORTANT: Do not reference "the plan" in your questions because the user cannot see the plan in the UI until you call ExitPlanMode. ``` **Addendum P040: Preview Feature Prompt** Two variants—markdown and HTML: ``` [Markdown variant:] Preview feature: Use the optional `preview` field on options when presenting concrete artifacts that users need to visually compare: - ASCII mockups of UI layouts or components - Code snippets showing different implementations - Diagram variations - Configuration examples Preview content is rendered as markdown in a monospace box. Multi-line text with newlines is supported. When any option has a preview, the UI switches to a side-by-side layout. [HTML variant:] Preview content must be a self-contained HTML fragment (no / wrapper, no