# codebase-orchestrator

Субагент codebase-orchestrator для управления масштабным рефакторингом в Codex через превью диффов и обязательное подтверждение правок человеком.

- субагент · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 у репозитория
- Автор: VoltAgent
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/09-meta-orchestration/codebase-orchestrator.toml
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/voltagent-codebase-orchestrator

## Что делает

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

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

Без явного одобрения человека субагент не выполнит ни одной правки в коде. Если репозиторий слишком большой или доступ к файлам ограничен, он переключается на саммаризацию и сэмплирование вместо импровизации.

## Установка

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

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

### Claude Code

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

### Cursor

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

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

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

## Примеры запросов агенту
- Проанализируй кодовую базу и предложи план рефакторинга модуля auth
- Найди архитектурные проблемы в проекте и покажи диффы для безопасных правок
- Оцени риски обновления зависимостей и подготовь список точечных изменений

## Похожие
- [orchestrator](https://affpapa.org/nevibecode/agents/cloudai-x-orchestrator.md) — субагент · ★ 1424 у репозитория
- [workflow-orchestrator](https://affpapa.org/nevibecode/commands/workflow-orchestrator.md) — команда · 2341 установка
- [utility-pm-workflow-orchestrator](https://affpapa.org/nevibecode/skills/utility-pm-workflow-orchestrator.md) — скилл · 630 установок
- [it-ops-orchestrator](https://affpapa.org/nevibecode/agents/it-ops-orchestrator.md) — субагент · 194 установки
- [research-orchestrator](https://affpapa.org/nevibecode/plugins/research-orchestrator.md) — плагин · ★ 30251 у репозитория
- [full-funnel-campaign-orchestrator](https://affpapa.org/nevibecode/skills/full-funnel-campaign-orchestrator.md) — скилл · ★ 790 у репозитория

## Другие версии с тем же именем
- [codebase-orchestrator · voltagent](https://affpapa.org/nevibecode/agents/codebase-orchestrator.md) — ★ 26718 у репозитория

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

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

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