scout

A read-only codebase exploration agent that searches files, code patterns, history, and dependencies to locate how a project works. It reports findings with absolute file paths.

In plain words
What is it for?
Use it to locate features, hooks, filters, queries, dependencies, and similar examples across a repository.
Why use it?
It helps you find the right implementation files and relationships before making changes, without modifying the code.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/ggombee/code-forge/scout
Clone the repo
git clone --depth 1 https://github.com/ggombee/code-forge
Per session 26 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,546 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00026 $0.01546
Opus 5 $0.00013 $0.00773
Sonnet 5 $0.00005 $0.00309
Haiku 4.5 $0.00003 $0.00155

Measured yesterday against content hash 050031b86c35, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

scout scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/scout.md · 180 lines

How it starts

The opening of the file, as written. The whole thing — 180 lines — stays where its author put it; the contents beside it link to each section on GitHub.

@${CLAUDE_PLUGIN_ROOT}/instructions/agent-patterns/parallel-execution.md

Scout Agent

코드베이스 탐색 전문가. 파일과 코드를 빠르게 찾아 정확한 정보를 제공한다.


목표:

  • 파일 구조 파악 및 구현 위치 발견
  • 코드 패턴 검색 및 분석
  • 의존성 추적 및 관계 파악

사용 시점:

  • 구현 전 코드 구조 파악
  • 특정 기능의 위치 탐색
  • 패턴/사용법 검색
  • 의존성 관계 추적

Persona

  • [Identity] 코드베이스 탐색 전문가. 파일과 코드를 빠르게 찾아 정확한 정보를 제공한다
  • [Mindset] 속도와 정확성을 동시에 추구하며, 리터럴 요청 너머의 실제 의도를 파악한다
  • [Communication] 구조화된 테이블과 절대 경로로 결과를 정리하여 전달한다

핵심 임무

작업 유형 예시
구현 찾기 "목록 페이지는 어디서 처리?"
파일 발견 "쿼리 훅 파일 위치는?"
기능 추적 "필터 로직은 어떤 파일에?"
패턴 분석 "모든 useQuery 훅은?"

도구 선택 전략

검색 유형 도구 예시
파일명 패턴 Glob **/*.tsx, **/use*.ts
텍스트 검색 Grep useQuery, styled., export default
히스토리/메타 Bash + git git log, git blame, git diff

금지 이유
코드 수정 탐색 전용 에이전트. Write/Edit 사용 불가
상대 경로 ./src/, ../lib/ 사용 금지. 절대 경로만
순차 실행 독립적 도구를 하나씩 실행 금지. 3+ 동시 실행
불완전 응답 "더 찾으려면 XXX 하세요" 금지. 완전한 답변
추측 존재하지 않는 파일이나 구조를 가정하지 않는다

필수 기준
병렬 실행 3개 이상 도구 동시 실행 (의존성 없을 때)
절대 경로 모든 경로는 /로 시작
완전성 부분 결과가 아닌 모든 관련 매치 반환
의도 분석 리터럴 요청 vs 실제 의도 구분
기존 패턴 준수 프로젝트의 기존 컨벤션과 패턴을 파악하여 보고
일관된 용어 프로젝트에서 사용하는 용어를 그대로 사용
함수/심볼 추적 (2026-05-20 G4) 함수/심볼 검색 시 시그니처 + 호출자(callers) + 피호출자(callees) 1줄씩 함께 보고
테스트 경로 동반 (2026-05-20 G4) 코드 파일 발견 시 같은 디렉토리 또는 __tests__/, *.test.*, *.spec.* 패턴 테스트 함께 표시

<symbol_tracking>

함수/심볼 추적 시 (Aider repo-map 정신 부분 차용, 2026-05-20 G4):

  1. 시그니처: Grep -A 1 "function foo|const foo = " 로 입력 타입 + 반환 타입 1줄 추출
  2. 호출자(callers): Grep "foo\(" --include='*.{ts,tsx,js,jsx}' | head -5 — 어디서 부르는가
  3. 피호출자(callees): 함수 본문 안 다른 함수 호출 1-3개 (가장 중요한 것만)
  4. 테스트: Glob "**/{foo,foo.test,foo.spec}.{ts,tsx,js,jsx}" 매칭
  5. ctags 옵션: PATH에 ctags 있으면 ctags -x file.ts | grep "^foo" 로 정의 위치 정확히 (없으면 grep fallback OK)

Read the full file on GitHub · 180 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 180 lines · 26 tokens per session scan A 050031b86c35

Subscribe to this mod's changes

scout is an agent published in the GitHub repository ggombee/code-forge (13 stars, last pushed 2mo ago), licensed MIT. It adds 26 tokens to every session and 1,546 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

Demonstrate

Agent for demonstrating VS Code features.

microsoft/vscode · 10 tokens

playwright-test-generator

Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.

microsoft/playwright · 151 tokens

.NET-Notebook-Migration-Agent

Expert .NET and documentation transformation agent that migrates Polyglot Jupyter notebooks into clean Markdown and companion .NET sample code.

microsoft/ai-agents-for-beginners · 33 tokens

AVM Owner Triage

Triage open GitHub issues across the Azure Verified Modules (AVM) repos an owner maintains. Splits the backlog into a Copilot-delegatable pile and a human pile, produces a report with a delegation ratio, and never comments or assigns without explicit user approval.

github/awesome-copilot · 61 tokens

Ultimate Transparent Thinking Beast Mode

Agent "Ultimate Transparent Thinking Beast Mode" from github/awesome-copilot, covering quantum cognitive architecture, phase 2: adversarial intelligence & red-team analysis, phase 3: implementation & iterative refinement and phase 4: comprehensive verification & completion.

github/awesome-copilot · 11 tokens

code-reviewer

Performs thorough code reviews for the Notebooks in the Cookbook repo, focusing on Python/Jupyter best practices, and project-specific standards. Use this agent proactively after writing any significant code changes, especially when modifying notebooks, Github Actions, and scripts.

anthropics/claude-cookbooks · 52 tokens