scout-ext

[IMPORTANT] Use TaskCreate to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ask user whether to skip.

Prerequisites: MUST READ .claude/skills/shared/evidence-based-reasoning-protocol.md before executing.

Quick Summary

Goal: Use external agentic tools (Gemini, OpenCode) to quickly locate relevant files across the codebase.

Workflow:

1. Scope — Define search area and file patterns
2. Search — Use external tools for broad file discovery
3. Report — Return list of relevant files with context

Key Rules:

• Use for broad file discovery across large codebases
• Complements /scout with external tool capabilities
• Report file paths with brief context for each match

Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).

Purpose

Utilize external agentic tools to scout given directories or explore the codebase for files needed to complete the task using a fast, token efficient agent.

Variables

USER_PROMPT: $1 SCALE: $2 (defaults to 3) RELEVANT_FILE_OUTPUT_DIR: Use Report: from ## Naming section

Workflow:

• Write a prompt for 'SCALE' number of agents to the Task tool that will immediately call the Bash tool to run these commands to kick off your agents to conduct the search:
  • gemini -p "[prompt]" --model gemini-2.5-flash-preview-09-2025 (if count <= 3)
  • opencode run "[prompt]" --model opencode/grok-code (if count > 3 and count < 6)
  • if count >= 6, spawn Explore subagents to search the codebase in parallel

Why use external agentic tools?

• External agentic tools are faster and more efficient when using LLMs with large context windows (1M+ tokens).

How to prompt the agents:

• If gemini or opencode is not available, ask the user if they want to install it:
  • If yes, install it (if there are permission issues, instruct the user to install it manually, including authentication steps)
  • If no, use the default Explore subagents.
• IMPORTANT: Kick these agents off in parallel using the Task tool, analyze and divide folders for each agent to scout intelligently and quickly.
• IMPORTANT: These agents are calling OTHER agentic coding tools to search the codebase. DO NOT call any search tools yourself.
• IMPORTANT: That means with the Task tool, you'll immediately call the Bash tool to run the respective agentic coding tool (gemini, opencode, claude, etc.)
• IMPORTANT: Instruct the agents to quickly search the codebase for files needed to complete the task. This isn't about a full blown search, just a quick search to find the files needed to complete the task.
• Instruct the subagent to use a timeout of 3 minutes for each agent's bash call. Skip any agents that don't return within the timeout, don't restart them.
• IMPORTANT: Sacrifice grammar for the sake of concision when writing reports.
• IMPORTANT: In reports, list any unresolved questions at the end, if any.

IMPORTANT Task Planning Notes (MUST FOLLOW)

• Always plan and break work into many small todo tasks
• Always add a final review todo task to verify work quality and identify fixes/enhancements