scouting

Map codebase structure and locate feature-related files via globbing and grep searches.

7|3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/brainbrewlabs/brainbrew-devkit --skill scouting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scouting
Source: https://github.com/brainbrewlabs/brainbrew-devkit/tree/main/plugin/config/templates/develop/skills/scouting
Command: npx skills add https://github.com/brainbrewlabs/brainbrew-devkit --skill scouting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineers and contributors rapidly understand an unfamiliar repository by locating entry points, configuration, and related files so they can plan changes or onboard faster.

Core Features & Use Cases

  • Top-level mapping: Enumerates project directories and highlights boundaries like packages and services.
  • Key file discovery: Finds entry points, CI/CD, config, and documentation files relevant to a task.
  • Pattern and dependency tracing: Uses grep-style searches and file reads to trace imports, references, and dependency chains; useful for locating where a feature is implemented or what modules a change will affect.
  • Use Case: When assigned a bug or feature, run this to produce a concise list of relevant files and a short architecture note before editing code.

Quick Start

Ask the scouting skill to explore the repository and produce a concise scout report listing top-level structure, key files, and the most relevant files for the target task.

Frequently Asked Questions about scouting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I quickly map a codebase and understand project structure?

Codebase mapping enumerates top-level directories to identify service boundaries, then locates entry points and configuration files. This project structure mapping highlights key files and architecture boundaries to accelerate onboarding and change planning.

What is the best way to trace dependencies and imports across an unfamiliar repository?

Dependency tracing in an unfamiliar repository uses grep-style pattern searches and file reads to follow import references. This identifies affected modules and locates where specific features are implemented within the dependency chain.

How do I find entry points and configuration files in a codebase?

Discovering entry points and configuration files requires globbing the project layout to find CI/CD pipelines and documentation. Locating these configuration files provides the necessary context for understanding repository setup and task execution.

Can I use file discovery to locate where a feature is implemented before editing code?

Yes, file discovery locates where a feature is implemented by performing pattern searches and reading relevant files. This produces a concise scout report of related files and a short architecture note to review before editing code.

Does this codebase exploration approach work for finding CI/CD and documentation files?

Yes, codebase exploration finds CI/CD and documentation files by enumerating the project layout and highlighting key files. It identifies these configuration boundaries alongside packages and services to clarify the repository structure.