# codebase-orchestrator

Субагент ведёт крупный рефакторинг по шагам: карта репозитория, приоритеты рисков, превью диффов и ожидание вашего одобрения перед правками.

- субагент · `type=agent` · Claude Code · ★ 26065
- Автор: VoltAgent Community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/09-meta-orchestration/codebase-orchestrator.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/agents/codebase-orchestrator

## Что делает

codebase-orchestrator работает по Safe Refactor Protocol: сначала разбирает структуру репозитория, потом предлагает действия, показывает диффы «до и после» и ждёт явного подтверждения. По умолчанию он не меняет ничего. Приоритеты расставлены жёстко: сначала дыры в безопасности, затем ломающие баги, архитектура, производительность и в самом конце стиль.

Внутри четыре шага: карта репозитория, поиск архитектурных рисков, предложение безопасных действий, выполнение одобренных диффов. Границы сканирования заданы заранее — исключаются сгенерированные файлы и virtualenv, проверяется синхронизация lockfile, читается editorconfig, размечаются git-сабмодули и docker-контексты. Отчёт приходит структурированным: сводка по карте, критичные проблемы, предлагаемые правки, безопасные действия и уровень риска.

Когда что-то мешает — большой файл, отказ в правах, отсутствующий инструмент, лимит контекста — агент переключается на детерминированные обходные пути вместо импровизации: суммирует крупные файлы, сэмплирует огромные репозитории, обрезает контекст, повторяет сетевые запросы. Для работы нужны инструменты из его набора, включая `airis-mcp-gateway`, `context-manager`, `error-coordinator`, `pied-piper` и `subagent-catalog:search`. Если этих MCP-серверов и субагентов в проекте нет, часть интеграций просто не сработает — это повод проверить окружение до запуска.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add VoltAgent/awesome-claude-code-subagents
```
В чате агента (не в терминале):
```text
/plugin install voltagent-meta@voltagent-subagents
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/09-meta-orchestration/codebase-orchestrator.md

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

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

## Похожие
- [codebase-analysis](https://affpapa.org/nevibecode/skills/codebase-analysis.md) — скилл · 580 установок
- [codebase-architecture](https://affpapa.org/nevibecode/skills/codebase-architecture.md) — скилл · 441 установка
- [generate-custom-instructions-from-codebase](https://affpapa.org/nevibecode/skills/generate-custom-instructions-from-codebase.md) — скилл · 8900 установок
- [codebase-cleanup](https://affpapa.org/nevibecode/plugins/codebase-cleanup.md) — плагин · ★ 41729
- [explore-codebase](https://affpapa.org/nevibecode/skills/explore-codebase.md) — скилл · 1100 установок
- [ac-reviewing-codebase](https://affpapa.org/nevibecode/skills/ac-reviewing-codebase.md) — скилл · 556 установок

Из того же набора: [voltagent/awesome-claude-code-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-claude-code-subagents.md) — 143 карточки

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

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