Как супервизировать AI‑кодинговых агентов и не потерять нить
Один агент в репозитории ведёт себя предсказуемо. Три параллельно на том же коде — уже другая история: правки перетирают друг друга, тесты «забывают» запустить, а задача помечается выполненной при сломанной сборке. В материале на dev.to автор battyterm разбирает типичные сбои и выкладывает практический паттерн супервизии — от изоляции веток до обязательного гейта на тестах и простой доски задач.
Пост вышел 4 апреля 2026 года; время публикации на платформе — 12:42 UTC.
Когда параллельные агенты ломают не код, а процесс
Сценарий из вступления прост: при росте числа агентов на одном репозитории всплывают три класса проблем. Во‑первых, конфликты правок — один перезаписывает файлы другого. Во‑вторых, нет контроля качества: агенты закрывают задачу, не доказав работоспособность. В‑третьих, роль человека превращается в бесконечное переключение между терминалами и контекстами.
Автор подчёркивает: супервизия — это не режим «нажал и забыл». Нужны ревью перед слиянием, внимание к тому, чтобы агенты не ушли в сторону, и декомпозиция задач так, чтобы ими можно было управлять. В тексте сравнение — со управлением командой джунов, а не с одной волшебной кнопкой.
Изоляция: отдельный git worktree на каждого агента
Первый приём — изоляция через git worktrees: у каждого агента своя директория, своя ветка и своё рабочее дерево. После работы ветки по очереди сливаются в main, конфликты разрешаются одним проходом, а не хаотичными перезаписями в общей копии.
В статье приводятся примеры команд вида git worktree add для трёх копий с путями в духе .worktrees/agent-1 и ветками agent-1/task-1 и аналогами для остальных агентов.
Гейт на тестах: «готово» только при нулевом коде выхода
Второй столп — обязательный запуск тестов до принятия результата. Если тесты падают, агенту возвращают вывод; тезис автора: exit 0 означает, что итерацию можно считать успешной, иначе нужна следующая попытка.
В примере из поста — переход в .worktrees/agent-1, затем cargo test; явно сказано, что вместо этого подойдут npm test, pytest и т.п. Проверка кода выхода делается через echo $?.
Автор сам оценивает, что такой гейт по его наблюдению снизил частоту сценария «агент что-то сломал» примерно на 80%, а оставшиеся около 20% относит к случаям, когда тесты не покрывают затронутое поведение. Это личная оценка в статье, а не независимая метрика платформы.
Диспетчеринг: Markdown‑канбан и одна задача на агента
Третий приём — структурированный диспетчинг: единая доска задач. В примере — Markdown kanban с секциями Todo / In Progress / Done и чекбоксами. Правило: одна задача на агента и видимое состояние «кто что делает», чтобы не тонуть в переключениях.
Паттерн целиком и практический потолок параллелизма
В оригинале full supervision pattern сведён к пяти шагам (нумерованный список в посте):
- Декомпозиция на независимые задачи на канбане.
- Одна задача на агента.
- Изоляция в отдельном git worktree.
- Завершение только при прохождении тестов.
- Поочерёдное слияние проверенных веток в
main.
Практический предел числа параллельных агентов автор называет порядка 3–5: дальше, по его словам, узким местом становится сама кодовая база и этап слияний.
Инструменты из поста: ассистенты, Batty и ссылки
В материале явно фигурируют ассистенты, с которыми автор работал: Claude Code, Codex, Aider. Для автоматизации описанного цикла упоминается Batty как Rust CLI: по описанию в посте он запускает цикл супервизии (агенты в панелях tmux, задачи из Markdown kanban, worktrees, гейт на тестах). В конце статьи приведена команда установки cargo install batty-cli.
В посте на dev.to также указаны https://github.com/battysh/batty и https://youtube.com/watch?v=2wmBcUnq0vw с подписью в духе «2-min demo» (формулировка из оригинала). Содержимое репозитория и ролика здесь не описывается шире, чем в тексте того поста.
Источники
- battyterm, «How to Supervise AI Coding Agents Without Losing Your Mind» — https://dev.to/battyterm/how-to-supervise-ai-coding-agents-without-losing-your-mind-53m4 (дата доступа: 2026-04-04, 22:00 UTC). Дата публикации на dev.to: 2026-04-04, 12:42 UTC.
- Репозиторий Batty, указанный в тексте того же поста: https://github.com/battysh/batty (дата доступа к странице поста на dev.to: 2026-04-04, 22:00 UTC).
- Демонстрационное видео, указанное в тексте того же поста: https://youtube.com/watch?v=2wmBcUnq0vw (дата доступа к странице поста на dev.to: 2026-04-04, 22:00 UTC).