Scout - Fast Codebase File Discovery Skill

Scout - Fast Codebase File Discovery

Fast codebase search to locate files needed for a task. Token-efficient, parallel execution.

KEY PRINCIPLE: Speed over depth. Return file paths only - no content analysis.

Summary

Goal: Quickly locate all files related to a task across the codebase using parallel search agents.

| Step | Action | Key Notes | |------|--------|-----------| | 1 | Analyze search request | Extract entity names, feature keywords, file types | | 2 | Execute parallel search | Spawn SCALE agents across Backend Core, Backend Infra, Frontend | | 3 | Synthesize results | Numbered, prioritized file list with suggested starting points |

Key Principles:

Speed over depth -- return file paths only, no content analysis
Parallel execution across backend and frontend directories
NOT for deep analysis (use investigate), debugging (use debug), or implementation (use feature)

When to Use

Quickly locating relevant files across a large codebase
Beginning work on features spanning multiple directories
Before making changes that might affect multiple parts
Mapping file landscape before investigation or implementation
Finding all files related to an entity, feature, or keyword

NOT for: Deep code analysis (use investigate), debugging (use debug), or implementation (use feature).

Quick Reference

| Input | Description | | ------------------- | --------------------------------------------------- | | USER_PROMPT | What to search for (entity names, feature keywords) | | SCALE | Number of parallel agents (default: 3) |

Workflow

Step 1: Analyze Search Request

Extract keywords from USER_PROMPT to identify:

Entity names (e.g., TextSnippet, Employee)
Feature names (e.g., authentication, notification)
File types needed (backend, frontend, or both)

Step 2: Execute Parallel Search

Spawn SCALE number of Explore subagents in parallel using Task tool.

Agent Distribution Strategy

Agent 1 - Backend Core: src/Backend/*/Domain/, src/Backend/*/Application/UseCaseCommands/, src/Backend/*/Application/UseCaseQueries/
Agent 2 - Backend Infra: src/Backend/*/Application/UseCaseEvents/, src/Backend/*/Api/Controllers/, src/Backend/*/Application/BackgroundJobs/
Agent 3 - Frontend: src/Frontend/apps/, src/Frontend/libs/apps-domains/, src/Frontend/libs/platform-core/

Step 3: Synthesize Results

Combine results into a numbered, prioritized file list.

Search Patterns by Priority

# HIGH PRIORITY - Core Logic
**/Domain/Entities/**/*{keyword}*.cs
**/UseCaseCommands/**/*{keyword}*.cs
**/UseCaseQueries/**/*{keyword}*.cs
**/UseCaseEvents/**/*{keyword}*.cs
**/*{keyword}*.component.ts
**/*{keyword}*.store.ts

# MEDIUM PRIORITY - Infrastructure
**/Controllers/**/*{keyword}*.cs
**/BackgroundJobs/**/*{keyword}*.cs
**/*Consumer*{keyword}*.cs
**/*{keyword}*-api.service.ts

# LOW PRIORITY - Supporting
**/*{keyword}*Helper*.cs
**/*{keyword}*Service*.cs
**/*{keyword}*.html

Results Format

## Scout Results: {USER_PROMPT}

### High Priority - Core Logic
1. `src/Backend/.../Domain/Entities/{Entity}.cs`
2. `src/Backend/.../UseCaseCommands/{Entity}/Save{Entity}Command.cs`
...

### Medium Priority - Infrastructure
10. `src/Backend/.../Api/Controllers/{Entity}Controller.cs`
...

### Frontend Files
30. `src/Frontend/apps/.../features/{entity}/{entity}-list.component.ts`
...

**Total Files Found:** {count}

### Suggested Starting Points
1. `{most relevant file}` - {reason}
2. `{second most relevant}` - {reason}

Agent Skills: Scout - Fast Codebase File Discovery

Install this agent skill to your local

Skill Files