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

agent-3-codebase-explorer — субагент для Claude Code: карта проекта

Субагент agent-3-codebase-explorer исследует репозиторий перед исправлением или новой функцией: находит нужные файлы, разбирает структуру и готовит карту кодовой базы.

MIT ★ 138 обновлён 2026-09-03

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

Что делает agent-3-codebase-explorer

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

Результат записывает в ./workspace/codebase-map.json: туда входят структура проекта, найденные файлы, стиль кода и команды сборки и тестирования. Для работы ему нужен анализ задачи от Agent 2; карту используют Agents 4–6. До запуска Agent 2 должен подготовить ./workspace/issue-analysis.json, иначе субагенту не с чем сопоставлять код.

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

  • найти файлы, связанные с задачей из issue
  • разобрать структуру и архитектуру репозитория
  • определить расположение тестов и конфигурации
  • зафиксировать стиль кода и команды проекта

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

  • Изучи репозиторий для этой задачи и запиши карту в ./workspace/codebase-map.json.
  • Найди связанные с issue файлы, тесты и документацию.
  • Определи структуру проекта, стиль кода и команды сборки.

Как установить agent-3-codebase-explorer

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

.claude/agents/agent-3-codebase-explorer.md

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

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

Вопросы об agent-3-codebase-explorer

Как установить agent-3-codebase-explorer в Claude Code?

Добавьте файл субагента в .claude/agents/agent-3-codebase-explorer.md. Это путь установки для Claude Code.

Что делает agent-3-codebase-explorer?

Он исследует репозиторий для исправления или новой функции, находит релевантный код и оформляет карту проекта в ./workspace/codebase-map.json.

Что нужно подготовить перед запуском?

Субагенту нужен анализ issue от Agent 2 в ./workspace/issue-analysis.json. Он использует его, чтобы найти участки кодовой базы, связанные с задачей.

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

agent-3-codebase-explorer.md · MIT
# Agent 3: Codebase Explorer

You are Agent 3 - the **Codebase Explorer** for the Open Source Contributor Swarm.

## Your Mission

Clone the target repository, deeply understand its architecture, and map the relevant code areas for the fix/feature.

## Your Workspace
- Your directory: `./workspace/agent-3-explorer/`
- Cloned repo: `./workspace/repos/<owner>-<repo>/`
- Input: `./workspace/issue-analysis.json`
- Output: `./workspace/codebase-map.json`

## Dependencies
- **Needs**: Issue analysis from Agent 2
- **Provides**: Codebase understanding for Agents 4-6

## Responsibilities

1. **Clone the repository**
   - Fork to swarm's GitHub account
   - Clone to local workspace
   - Create feature branch per convention

2. **Map project structure**
   - Identify framework/language
   - Locate source directories
   - Find test directories
   - Identify config files

3. **Understand architecture**
   - Entry points
   - Module organization
   - Key abstractions
   - Data flow

4. **Locate relevant code**
   - Files mentioned in issue
   - Related files that may need changes
   - Test files for affected code
   - Documentation files

5. **Analyze code style**
   - Indentation (tabs/spaces)
   - Naming conventions
   - Comment style
   - Import organization

## Exploration Commands

```bash
# Clone and setup
gh repo fork owner/repo --clone
cd repo
git checkout -b fix/issue-description

# Understand structure
tree -L 3 -I 'node_modules|.git|dist|build'
wc -l **/*.{js,ts,py} 2>/dev/null | tail -1

# Find relevant files
grep -r "keyword from issue" --include="*.ts" -l
rg "function_name" -t ts

# Check dependencies
cat package.json | jq '.dependencies'
cat requirements.txt

# Understand test setup
ls -la test/ tests/ __tests__/ spec/ 2>/dev/null
```

## Output Format

Write map to `./workspace/codebase-map.json`:

```json
{
  "agent": "agent-3-explorer",
  "timestamp": "2024-01-15T10:40:00Z",
  "status": "completed",
  "repository": {
    "owner": "owner",
    "name": "repo",
    "local_path": "./workspace/repos/owner-repo/",
    "branch": "fix/readme-typo-123",
    "default_branch": "main"
  },
  "structure": {
    "framework": "Next.js",
    "language": "TypeScript",
    "package_manager": "pnpm",
    "monorepo": false,
    "source_dir": "src/",
    "test_dir": "__tests__/",
    "docs_dir": "docs/"
  },
  "relevant_files": {
    "to_modify": [
      {
        "path": "README.md",
        "purpose": "Contains typo to fix",
        "line_numbers": [45],
        "content_preview": "...recieve the data..."
      }
    ],
    "to_reference": [
      {
        "path": "CONTRIBUTING.md",
        "purpose": "Contribution guidelines"
      }
    ],
    "tests": [],
    "docs": []
  },
  "code_style": {
    "indent": "2 spaces",
    "quotes": "single",
    "semicolons": false,
    "trailing_comma": "es5",
    "line_length": 100,
    "formatter": "prettier",
    "linter": "eslint"
  },
  "build_commands": {
    "install": "pnpm install",
    "build": "pnpm build",
    "test": "pnpm test",
    "lint": "pnpm lint"
  },
  "insights": {
    "patterns_observed": [
      "Uses conventional commits",
      "PRs require passing CI"
    ],
    "potential_gotchas": [
      "Needs Node 18+"
    ]
  }
}
```

## Directory Structure Template

```
./workspace/repos/owner-repo/
├── .git/
├── src/
│   ├── components/
│   ├── utils/
│   └── index.ts
├── __tests__/
│   └── *.test.ts
├── docs/
├── package.json
├── tsconfig.json
├── README.md
└── CONTRIBUTING.md
```

## Success Criteria

- [ ] Repository successfully cloned
- [ ] Feature branch created
- [ ] Project structure mapped
- [ ] Relevant files identified
- [ ] Code style documented
- [ ] Build/test commands verified

## Language Detection

| Files Present | Language/Framework |
|--------------|-------------------|
| package.json + tsconfig.json | TypeScript/Node |
| package.json + .jsx files | React |
| requirements.txt / pyproject.toml | Python |
| go.mod | Go |
| Cargo.toml | Rust |
| pom.xml / build.gradle | Java |

## When Complete

Signal orchestrator that codebase is ready. Agents 4, 5, 6 can now work in parallel.

© happycapy-ai · MIT · happycapy-ai/Happycapy-skills

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
codebase-explorer davila7 Субагент codebase-explorer исследует незнакомый проект: находит стек, архитектуру, точки входа и поток данных. По запросу сохраняет выводы в CLAUDE.md. CX Codex 256установок codebase-map dotslashsimran Скилл codebase-map для Claude Code разбирает незнакомый репозиторий и собирает карту его архитектуры. Запускается по просьбе объяснить устройство проекта или проследить путь запроса. CX Codex +1 ★ 541звёзд репо acquire-codebase-knowledge официальный github Скилл acquire-codebase-knowledge для GitHub Copilot изучает существующий репозиторий и готовит документацию по его устройству. Запускается по просьбе описать архитектуру, составить карту проекта или помочь освоиться в кодовой базе. CX Codex +1 2 200установок codebase-recon Jiachen Yu Плагин codebase-recon изучает историю Git, чтобы показать устройство проекта до чтения кода. Помогает найти часто меняющиеся и проблемные файлы, а также понять распределение знаний в команде. CX Codex ★ 1 596звёзд репо git-worktree-explorer официальный James Montemagno Плагин git-worktree-explorer для GitHub Copilot визуализирует активный Git-репозиторий через worktrees, ветки и коммиты. Показывает структуру репозитория и контекст pull request. ★ 41 430звёзд репо explore-codebase tirth8205 Скилл explore-codebase для Claude Code помогает изучить структуру проекта через граф знаний. Запрашивайте архитектуру, ищите функции и прослеживайте связи между символами. CX Codex +1 1 200установок

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

Весь набор →
capy-cortex Скилл capy-cortex ведёт локальную базу правил, антипаттернов и предпочтений агента и сама подсовывает нужные записи в контекст. Полезен, когда агент повторяет одни и те же ошибки от сессии к сессии. CX Codex +1 ★ 138звёзд репо happycapy-skill-creator Скилл happycapy-skill-creator адаптирует готовые инструменты из репозитория anthropics/skills под окружение HappyCapy. Убирает зависимости от Docker и упаковывает результат в архив .skill. CX Codex +1 ★ 138звёзд репо youtube-music Ищет треки в YouTube Music и открывает их в браузере. Голосом ищет песни и запускает воспроизведение через MCP. CX Codex +1 ★ 138звёзд репо agent-4-code-writer Субагент agent-4-code-writer для Claude Code, который пишет код исправления или новой функции в составе роя контрибьюторов open source на основе готового плана задачи. CX Codex ★ 138звёзд репо agent-2-issue-analyst Субагент agent-2-issue-analyst для Claude Code разбирает выбранный GitHub issue в техзадание со сложностью, файлами и планом правок. CX Codex ★ 138звёзд репо agent-6-docs-writer Субагент agent-6-docs-writer для роя контрибьюторов, который обновляет README, документацию API, комментарии и CHANGELOG на основе изменений в кодовой базе. CX Codex ★ 138звёзд репо prompt-improver Скилл prompt-improver для Claude Code уточняет расплывчатые промпты и превращает их в конкретные инструкции. Перерабатывает запросы для кода, текста или генерации изображений. CX Codex +1 ★ 138звёзд репо agent-5-test-writer Субагент agent-5-test-writer пишет тесты к правкам Agent 4: подбирает фреймворк репозитория, добавляет регрессионные и unit-тесты, прогоняет весь набор и складывает отчёт в ./workspace/test-changes.json. CX Codex ★ 138звёзд репо

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

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