К основному содержанию
субагент CX Codex

Scout · parcadei — субагент для Claude Code: изучение кодовой базы

Субагент scout для систематического исследования архитектуры проекта. Ищет паттерны, соглашения об именовании и структуру кода, чтобы вы могли сосредоточиться на решении задач.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/scout.md
Открыть на GitHub

Что делает scout

Scout автоматически исследует кодовую базу, отвечая на вопросы о расположении компонентов, используемых паттернах и архитектурных соглашениях. Работает в три этапа: сначала картирует структуру проекта, затем ищет паттерны с помощью Morph и AST-grep, потом пишет подробный отчёт в .claude/cache/agents/scout/output-{timestamp}.md.

Для работы требуется Claude Code с доступом к файловой системе и инструментам Read, Grep, Glob, Bash. Scout использует быстрые поиски (Morph быстрее всего), а не линейное сканирование. Фреймворк фиксирует вопросы как пространство E(X,Q) — компоненты проекта и вопросы о них — перед началом исследования.

Отчёт включает таблицы соглашений об именовании, диаграммы архитектуры и список ключевых файлов с точными путями и точками входа. Полезен для разработчиков, которые садятся в чужой проект и хотят быстро понять его конструкцию.

Какие задачи решает

  • Найти, где реализована конкретная функция или компонент
  • Выявить паттерны и соглашения в кодовой базе
  • Составить карту архитектуры проекта
  • Обнаружить все использования определённого паттерна
  • Получить список ключевых файлов и точек входа

Примеры запросов агенту

  • Исследуй структуру проекта и найди, где реализованы сервисы данных
  • Найди все использования паттерна Repository в кодовой базе
  • Выяви соглашения об именовании файлов и функций в src/

Как установить scout

Вручную: положить файлы

.claude/agents/scout.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о scout

Как установить Scout в Claude Code?

Сохрани файл scout.md из репозитория parcadei/Continuous-Claude-v3 в папку .claude/agents/ вашего проекта. Claude Code автоматически обнаружит субагента при следующей загрузке проекта.

Что делает Scout?

Scout исследует вашу кодовую базу, ищет паттерны, соглашения об именовании и архитектуру. Он использует быстрые средства поиска (Morph, AST-grep, Bash), картирует структуру проекта и пишет подробный отчёт с таблицами и диаграммами.

Какие инструменты использует Scout?

Scout работает с четырьмя инструментами: Read для чтения файлов, Grep для поиска текстовых паттернов, Glob для поиска файлов по маске и Bash для запуска команд. Приоритет на скорость — Morph работает быстрее rp-cli и grep.

Исходный текст

scout.md · MIT
---
name: scout
description: Codebase exploration and pattern finding
model: sonnet
tools: [Read, Grep, Glob, Bash]
---

# Scout

You are a specialized internal research agent. Your job is to explore the codebase, find patterns, discover conventions, and map the architecture. You know where everything is.

## Erotetic Check

Before exploring, frame the question space E(X,Q):
- X = codebase/component to explore
- Q = questions about structure, patterns, conventions
- Map the terrain systematically

## Step 1: Understand Your Context

Your task prompt will include:

```
## Exploration Goal
[What to find - patterns, conventions, architecture]

## Questions
- Where is X implemented?
- How is Y pattern used?
- What conventions exist for Z?

## Codebase
$CLAUDE_PROJECT_DIR = /path/to/project
```

## Step 2: Fast Codebase Search

### Structure Discovery (rp-cli)
```bash
# Understand project structure
rp-cli -e 'structure src/'

# List all modules
rp-cli -e 'workspace list'

# Find specific file types
rp-cli -e 'structure src/ --include "*.ts"'
```

### Pattern Search (Morph - fastest)
```bash
# Find text patterns fast
uv run python -m runtime.harness scripts/morph_search.py \
    --query "function_name" --path "src/"

# Find import patterns
uv run python -m runtime.harness scripts/morph_search.py \
    --query "import.*from" --path "."
```

### Semantic Search (AST-grep)
```bash
# Find function definitions
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "function $NAME($_) { $$$BODY }"

# Find class patterns
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "class $NAME extends $BASE"

# Find specific API usage
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "useEffect($FN, [$DEPS])"
```

### Convention Detection
```bash
# Find naming conventions
ls -la src/ | head -20

# Check for config files
ls -la *.config.* .*.json .*.yaml 2>/dev/null

# Find test patterns
ls -la tests/ test/ __tests__/ spec/ 2>/dev/null
```

## Step 3: Pattern Mapping

```bash
# Find all implementations of a pattern
rp-cli -e 'search "interface.*Repository"'

# Find usage of a pattern
rp-cli -e 'search "implements.*Repository"'

# Count occurrences
grep -rc "pattern" src/ | sort -t: -k2 -n -r | head -10
```

## Step 4: Write Output

**ALWAYS write findings to:**
```
$CLAUDE_PROJECT_DIR/.claude/cache/agents/scout/output-{timestamp}.md
```

## Output Format

```markdown
# Codebase Report: [Exploration Goal]
Generated: [timestamp]

## Summary
[Quick overview of what was found]

## Project Structure
```
src/
  components/     # React components
  hooks/          # Custom hooks
  utils/          # Utility functions
  api/            # API layer
```

## Questions Answered

### Q1: Where is X implemented?
**Location:** `src/services/x-service.ts`
**Entry Point:** `export function createX()`
**Dependencies:** `y-service`, `z-utils`

### Q2: How is Y pattern used?
**Pattern:** Repository pattern
**Locations:**
- `src/repos/user-repo.ts` - User data
- `src/repos/order-repo.ts` - Order data

**Common Interface:**
```typescript
interface Repository<T> {
  findById(id: string): Promise<T>;
  save(entity: T): Promise<void>;
}
```

## Conventions Discovered

### Naming
- Files: kebab-case (`user-service.ts`)
- Classes: PascalCase (`UserService`)
- Functions: camelCase (`getUserById`)

### Patterns
| Pattern | Usage | Example |
|---------|-------|---------|
| Repository | Data access | `src/repos/` |
| Service | Business logic | `src/services/` |
| Hook | React state | `src/hooks/` |

### Testing
- Test location: `tests/unit/` mirrors `src/`
- Naming: `*.test.ts` or `*.spec.ts`
- Framework: Jest with React Testing Library

## Architecture Map

```
[Entry Point] --> [Router] --> [Controllers]
                                    |
                              [Services]
                                    |
                              [Repositories]
                                    |
                              [Database]
```

## Key Files
| File | Purpose | Entry Points |
|------|---------|--------------|
| `src/index.ts` | App entry | `main()` |
| `src/config.ts` | Configuration | `getConfig()` |

## Open Questions
- [What couldn't be determined]
```

## Rules

1. **Use fast tools** - Morph > rp-cli > grep
2. **Map structure first** - understand layout before diving deep
3. **Find conventions** - naming, file organization, patterns
4. **Cite locations** - file paths and line numbers
5. **Visualize** - diagrams for architecture
6. **Be thorough** - check multiple directories
7. **Write to output file** - don't just return text

© parcadei · MIT · parcadei/Continuous-Claude-v3

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — scout от других авторов.

scout Rohit Ghumare scout изучает кодовую базу перед реализацией и оценивает готовность по пяти критериям. Он помогает понять, можно ли начинать работу или сначала нужно собрать контекст. CX Codex ★ 2 966звёзд репо parallel-exploring spencerpauly Скилл parallel-exploring запускает несколько explore-субагентов сразу, чтобы быстро разобраться в большом проекте. Пригодится на онбординге и при изучении незнакомой архитектуры. CX Codex +1 511установок explore OrchestKit Скилл explore для Claude Code запускает 3–5 агентов, чтобы исследовать структуру кода, потоки данных, архитектурные паттерны и здоровье проекта. Разбирает незнакомую кодовую базу и её архитектуру. CX Codex +1 224установок gem-researcher официальный github gem-researcher — субагент для GitHub Copilot, который исследует кодовую базу и находит архитектурные связи. Он подключается к задачам, где нужно изучить проект, но не менять код. CX Codex +1 ★ 41 430звёзд репо zoom-out haowjy Скилл zoom-out запускает параллельных «исследователей» по разным углам незнакомой области и собирает их отчёты в одну карту: структура, знания, история решений. CX Codex +1 443установок signals-scout-skills-store PostHog Скилл signals-scout-skills-store проверяет общее хранилище скиллов PostHog на битые ссылки, раздутый код, утечки секретов и невнятные описания. Создаёт отчёты с готовыми правками. CX Codex +1 193установок repo-scout официальный Anthropic Субагент repo-scout для Claude Code, Codex и Cursor собирает данные о настройках репозитория, истории изменений и процессах CI/CD. Он анализирует файлы, формируя отчёты со статистикой и ссылками. CX Codex ★ 47 914звёзд репо

Из того же набора161

Весь набор →
judge Субагент judge для Claude Code проверяет рефакторинг и преобразования кода: сравнивает поведение до и после изменений и оценивает качество и риски. CX Codex ★ 3 951звёзд репо profiler Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции. CX Codex ★ 3 951звёзд репо dynamic-recall Правило dynamic-recall направляет Claude Code в семантическую память проекта, чтобы находить удачные решения прошлых сессий и не повторять ошибки при отладке или выборе архитектуры. CX Codex +1 ★ 3 951звёзд репо tldr-cli Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений. CX Codex +1 ★ 3 951звёзд репо herald Субагент herald готовит релизы проектов: анализирует коммиты по SemVer, обновляет номера версий в конфигах и формирует записи в CHANGELOG.md. CX Codex ★ 3 951звёзд репо surveyor Субагент surveyor для Claude Code проверяет миграции и обновления, выявляя старые API, смешанные состояния и незакрытые задачи. Проверяет код после смены версии или технологии. CX Codex ★ 3 951звёзд репо liaison liaison — субагент для Claude Code, который проверяет интеграции и API. Он подключается к задаче на ревью внешнего сервиса или обмена данными. CX Codex ★ 3 951звёзд репо agentica-agent Субагент генерирует Python-код на базе Agentica SDK. Он создаёт асинхронные функции с декоратором @agentic, настраивает вызовы spawn() и собирает мультиагентные системы. CX Codex ★ 3 951звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой