# agent-3-codebase-explorer

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 138 у репозитория
- Автор: happycapy-ai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/agents/agent-3-codebase-explorer.md
- Обновлён: 2026-09-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/agent-3-codebase-explorer

## Что делает

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

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

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/agent-3-codebase-explorer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/agent-3-codebase-explorer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/agent-3-codebase-explorer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/agents/agent-3-codebase-explorer.md

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

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

## Похожие
- [codebase-explorer](https://affpapa.org/nevibecode/agents/codebase-explorer.md) — субагент · 256 установок
- [codebase-map](https://affpapa.org/nevibecode/skills/codebase-map.md) — скилл · ★ 541 у репозитория
- [acquire-codebase-knowledge](https://affpapa.org/nevibecode/skills/acquire-codebase-knowledge.md) — скилл · 2200 установок
- [codebase-recon](https://affpapa.org/nevibecode/plugins/codebase-recon.md) — плагин · ★ 1596 у репозитория
- [git-worktree-explorer](https://affpapa.org/nevibecode/plugins/git-worktree-explorer.md) — плагин · ★ 41430 у репозитория
- [explore-codebase](https://affpapa.org/nevibecode/skills/explore-codebase.md) — скилл · 1200 установок

Из того же набора: [happycapy-ai/happycapy-skills](https://affpapa.org/nevibecode/by/happycapy-ai/happycapy-skills.md) — 41 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
