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

Несколько ИИ-агентов стоит запускать параллельно, если их задачи можно закончить независимо, общий интерфейс уже согласован, а человек успевает проверить результаты. Выдайте каждому исполнителю отдельный рабочий каталог, зафиксируйте исходный коммит и разрешённые файлы. Затем соберите изменения по очереди в отдельной итоговой ветке и проверьте именно её — успешные тесты двух исходных веток ещё не подтверждают работу их сочетания.
Для первого запуска достаточно одного исполнителя и отдельной проверки. Второго исполнителя добавляйте, когда появилась самостоятельная задача. Это предлагаемый способ начать, а не доказанный оптимум по числу агентов. Если оба исполнителя должны одновременно менять один интерфейс, сначала закончите этот интерфейс в одной ветке.
Как выбрать между одним агентом и параллельной работой
Главный вопрос: сможет ли каждый исполнитель вернуть законченный результат, пока другой ещё работает? Если нет, разделение пока существует только на словах.
| Ситуация | Как организовать работу |
|---|---|
| Причина ошибки неизвестна, исправление затрагивает тесно связанные модули | Один агент исследует и исправляет; проверка следует за готовым изменением |
| Реализация готова, нужно проверить сценарии и требования | Передать точный коммит проверяющему; не давать ему одновременно переписывать реализацию |
| Два модуля используют уже согласованный формат данных и не меняют общие файлы | Два исполнителя в разных каталогах, один ответственный за объединение |
| Нужно получить два варианта решения одной проблемы | Сравнить варианты и выбрать один; не сливать их автоматически |
| Несколько независимых задач готовы, но проверяющий занят | Остановить выдачу новых задач и разобрать очередь проверки |
Например, поиск в списке задач и экспорт этого списка в CSV можно разрабатывать независимо, если заранее определены поля записи и правило отбора. А «сделать интерфейс» и «придумать API для интерфейса» обычно требуют последовательной работы: первая задача зависит от решения второй.
Различие между конкурирующими вариантами и дополняющими задачами полезно и при проверке конфликтов. Git обнаруживает пересечение строк, но две правки разных файлов могут противоречить общему правилу. В разборе Фёдора Сергеева это показано на учебном примере. Описанный там калькулятор подготовлен вручную; он не доказывает производительность конкретной среды агентов.
Распределите ответственность до запуска
Небольшой команде нужны понятные обязанности, а не множество названий ролей. Один человек может совмещать постановку задачи, проверку и объединение, если у него хватает времени. Агенту можно поручить дополнительную проверку, но решение о принятии изменения остаётся за назначенным человеком.
| Ответственный | Что должен вернуть или решить |
|---|---|
| Руководитель задачи | Результат, границы работ, общий интерфейс, критерии приёмки и порядок объединения |
| Исполнитель | Изменения в разрешённых файлах, коммит и запись о выполненных проверках |
| Проверяющий | Воспроизведённые проверки, найденные расхождения с требованиями, замечания к конкретному коммиту |
| Ответственный за объединение | Проверенный итоговый коммит, решение о принятии и сохранённые материалы при неудаче |
Роль «проверяющий» сама по себе не запрещает запись на диск. Список разрешённых файлов в задании — договорённость о работе, а не техническое ограничение доступа. В локальном Codex дочерние агенты наследуют действующие разрешения родительской сессии; её текущие переопределения могут применяться поверх настроек роли. Поэтому сначала проверьте фактический режим исполнения, а затем выдавайте задание. Документация Codex о разрешениях подагентов.
Если проверяющий обнаружил ошибку, удобнее вернуть её исполнителю с ожидаемым поведением и воспроизводимым тестом. Когда проверяющему всё же поручают исправление, это становится отдельной задачей: меняются ответственный, разрешённые файлы и коммит, который потребуется проверить.
Запишите общий контракт на конкретном примере
Возьмём вымышленный проект taskboard: он показывает реестр задач и умеет выгружать записи. Команда хочет добавить поиск и CSV-экспорт. Ниже — проектный пример, а не результат запуска реальных агентов.
До разделения работ руководитель записывает правила:
- запись содержит
id,titleиstatus; - допустимые статусы —
open,done,archived; - поиск сравнивает заголовок без учёта регистра;
- поиск и экспорт исключают архивные записи;
- экспорт сохраняет порядок полученного списка и корректно экранирует запятые, кавычки и переносы строк;
- формат записи и набор статусов меняет только руководитель задачи.
Теперь исполнитель поиска отвечает за taskboard/search.py и tests/test_search.py, исполнитель экспорта — за taskboard/export.py и tests/test_export.py. Общий файл taskboard/records.py, зависимости и настройки проекта остаются у одного владельца. Если экспорт требует нового поля, исполнитель сообщает о зависимости и останавливает эту часть работы, вместо того чтобы незаметно менять контракт.
Проверка общего результата должна связывать обе функции. Например: после поиска по слову «релиз» экспортируются только найденные неархивные записи, в том же порядке и с правильным экранированием. Два набора модульных тестов могут пройти, даже если поиск отдаёт один формат, а экспорт ожидает другой. Поэтому этот сквозной сценарий нужен в итоговой ветке.
Задание, которое можно передать исполнителю
Не требуется длинный универсальный шаблон. Достаточно записи, по которой другой участник сможет понять задачу, не перечитывая весь чат:
Задача: поиск по заголовку в taskboard
Результат: search(records, query) возвращает подходящие неархивные записи.
Каталог: ../taskboard-search
Ветка: codex/taskboard-search
Исходный коммит: полный SHA, записанный руководителем перед запуском
Можно менять: taskboard/search.py, tests/test_search.py
Общий контракт: id/title/status; поиск без учёта регистра; порядок сохраняется.
Не менять: records.py, экспорт, зависимости и настройки проекта.
Проверка: python3 -m unittest tests.test_search
Приёмка: пустой запрос, разный регистр, архивная запись и порядок покрыты тестами.
Если нужен другой формат записи: вернуть вопрос руководителю до изменения контракта.
Передать: коммит, список файлов, команды и результаты, оставшиеся проблемы.У задания есть и завершение, и условие остановки. «Улучшить поиск как считаешь нужным» оставляет исполнителю слишком много решений, которые могут затронуть экспорт. Но перечислять каждую строку реализации тоже не нужно: задание определяет поведение и границы, а не диктует код.

Две ветки в одном каталоге не изолируют исполнителей
В одном рабочем каталоге переключение ветки меняет файлы под всеми процессами, которые с ними работают. Для параллельной записи нужны разные каталоги: отдельные Git worktree или самостоятельные копии репозитория с согласованным способом передачи коммитов.
Git worktree даёт каждому каталогу собственные рабочие файлы, индекс и HEAD. База объектов, большинство ссылок и настройки репозитория остаются общими. Поэтому команды, меняющие общие ветки или настройки Git, тоже требуют координации. Обычная защита Git не позволяет одновременно открыть одну ветку в двух worktree. Устройство и ограничения Git worktree.
Для нашего примера ниже предполагается существующий локальный репозиторий taskboard, чистая ветка main, доступный Python 3 и уже настроенные проектные тесты. Имена каталогов и веток должны быть свободны. Команды создают рабочие каталоги; они не запускают агентов и не настраивают их доступ.
cd ~/work/taskboard
# Продолжайте только после проверки, что каталог чистый.
git status --short
git switch main
BASE=$(git rev-parse HEAD)
git worktree add -b codex/taskboard-search ../taskboard-search "$BASE"
git worktree add -b codex/taskboard-export ../taskboard-export "$BASE"
git worktree add -b codex/taskboard-candidate ../taskboard-candidate "$BASE"
git worktree listПередайте исполнителям полученный полный BASE вместе с их заданиями. Явный коммит снимает неоднозначность: оба начинают с одной версии, независимо от того, какая ветка была открыта при создании каталога.
Что остаётся общим за пределами файлов
Worktree не ограничивает доступ процесса к соседним каталогам, домашней папке или сети. Он также не создаёт отдельную базу данных и не резервирует порт. Для taskboard можно начать с вымышленных записей и тестов без внешних сервисов. Если нужны два сервера, назначьте разные порты; если нужна база, используйте отдельные разрешённые тестовые данные и отдельное место хранения.
Изменяемые зависимости, результаты сборки и кеши, в которые пишет сборщик, должны соответствовать конкретному рабочему каталогу. Не делайте общими каталоги, где параллельные команды перезаписывают файлы. Общий кеш скачанных пакетов допустим только там, где используемый инструмент поддерживает такой режим. Перенос секретов и доступ к данным решаются отдельно от создания worktree. Подробности выбора места исполнения разобраны в статье о локальных файлах, Work, Codex и Claude Code.
Что учитывать в Codex и Claude Code
На 7 октября 2026 года эти инструменты предлагают разные механизмы. Отдельный разговор с агентом, отдельный контекст и отдельный рабочий каталог — три разных свойства. Проверяйте каждое из них, вместо того чтобы считать слово «подагент» обещанием полной изоляции.
В приложении Codex новый разговор в режиме Worktree требует Git-репозитория. По документации приложение обычно создаёт его с отсоединённым HEAD; для дальнейшей работы можно выбрать Create branch here или передать разговор через Hand off в Local. Перенос несохранённых изменений зависит от выбранного пути создания и передачи. Ручные команды Git выше не выполняют такой перенос автоматически. .worktreeinclude относится к подходящим игнорируемым файлам в локальных управляемых worktree; он не копирует произвольные неотслеживаемые файлы и не описывает все удалённые сценарии. Текущий порядок работы Codex с worktree.
Подагенты локального Codex доступны в текущих версиях по умолчанию, но делегирование запускается по явной просьбе или применимым правилам проекта. Отдельные контексты не создают отдельные worktree автоматически. Если вы настраиваете собственные роли, текущая документация описывает отдельные TOML-файлы в .codex/agents/ с полями name, description и developer_instructions. Параметр agents.max_concurrent_threads_per_session ограничивает дочерние потоки, исключая основной. Перед переносом старой конфигурации сверяйте схему со своей версией клиента; название роли и лимит потоков не заменяют каталоги и порядок слияния. Настройка подагентов Codex.
В Claude Code команды агентов остаются экспериментальной функцией, выключенной по умолчанию. Участники могут вести самостоятельные разговоры и обмениваться сообщениями, но блокировка назначения задачи не блокирует исходные файлы, порт или базу данных. Документация отдельно описывает ограничения интерактивных команд и обычных подагентов. Agent teams в Claude Code.
Для обычных подагентов Claude Code рабочее дерево можно запросить через isolation: worktree. По текущей документации его база по умолчанию — основная ветка репозитория, а не обязательно HEAD родительской сессии. В интерактивном режиме начиная с версии 2.1.232 fork по умолчанию передаёт подагенту контекст родительского разговора; это отличается от запуска с новым контекстом. В неинтерактивном режиме fork по умолчанию выключен. Поэтому явно выясните базу и способ передачи контекста, если проверка требует независимого взгляда. Контроль рабочего каталога и команд, описанный для конкретных версий, не следует считать изоляцией на уровне операционной системы. Подагенты и worktree в Claude Code.
Для первого опыта собственная конфигурация ролей вообще не обязательна. Достаточно выдать две ограниченные задачи в подтверждённые каталоги и потребовать возвращать коммит с результатами проверок.
Передавайте результат вместе с точным коммитом
Запись о передаче должна сохраниться в доступном команде месте: в описании запроса на слияние или в файле рядом с задачей. Одного сообщения «всё готово, тесты зелёные» недостаточно: неизвестно, что проверялось и изменился ли код после проверки.
Исполнитель поиска возвращает, например:
Задача: поиск по заголовку
База: полный исходный SHA
Результат: полный SHA коммита исполнителя
Файлы: taskboard/search.py, tests/test_search.py
Команда: python3 -m unittest tests.test_search
Результат: код завершения и сохранённый вывод проверки
Поведение: пустой запрос возвращает все неархивные записи в исходном порядке.
Осталось: проверить поиск вместе с CSV-экспортом в итоговой ветке.
Следующий ответственный: человек, собирающий общий результатВ реальной записи вместо описаний SHA и результата должны быть фактические значения. Не пишите, что команда выполнялась, если её только предложили. После исправления обновляйте коммит и результаты проверки: замечания к старой версии не становятся проверкой новой.
Проверяющий сначала сопоставляет изменение с заданием и общим контрактом, затем воспроизводит подходящие проверки. git diff --check полезен для ошибок пробелов, но не проверяет поиск, CSV или совместимость функций. Для них нужны поведенческие тесты и просмотр изменения по смыслу.
Соберите и проверьте итоговую ветку до принятия
Назначьте одного ответственного за эту последовательность. Пока он собирает результат, никто другой не должен одновременно менять целевую ветку или его рабочий каталог. В команде с несколькими людьми, принимающими изменения, используйте согласованную очередь; для удалённого процесса — очередь слияния, которая проверяет кандидата относительно актуальной целевой ветки.
Исполнители сначала сохраняют готовые изменения в коммитах и прекращают правки передаваемой версии. Ответственный записывает их полные SHA. Так перемещение ветки исполнителем не подменит проверяемый результат.
cd ~/work/taskboard
SEARCH_HEAD=$(git rev-parse codex/taskboard-search)
EXPORT_HEAD=$(git rev-parse codex/taskboard-export)
cd ../taskboard-candidate
git merge --no-ff "$SEARCH_HEAD"
# Продолжайте только после успешного слияния.
git merge --no-ff "$EXPORT_HEAD"
# При конфликте остановитесь и сохраните состояние для разбора.
python3 -m unittest discover -s tests
git diff --check "$BASE" HEAD
git status --short
CANDIDATE=$(git rev-parse HEAD)Все шаги выполняются последовательно. Переходите дальше после успешного результата; не превращайте блок в безусловный скрипт, который продолжает работу после ошибки. BASE должен содержать исходный SHA из первого блока, а тесты проекта — включать общий сценарий поиска и экспорта. Дополнительно выполните проверки, требуемые вашим проектом: например, сборку и проверку типов. Изменённые тестом файлы требуют объяснения, а правка исходного кода — нового коммита и повторной проверки.
Внимательно посмотрите общий diff: не появились ли лишние файлы, не изменился ли контракт, не исчезло ли нужное поведение? Конфликт может отсутствовать, а архивные записи всё равно попасть в CSV. Успешный результат здесь означает, что проверенный код соответствует согласованному заданию; это ещё не публикация и не проверка всех свойств продукта.

После проверки чистого итогового каталога можно принять точный кандидат локально:
cd ~/work/taskboard
git switch main
# Каталог должен быть чистым, а main — на согласованной базе.
test "$(git rev-parse HEAD)" = "$BASE" || exit 1
test -z "$(git status --porcelain)" || exit 1
git merge --ff-only "$CANDIDATE"
test "$(git rev-parse HEAD)" = "$CANDIDATE" || exit 1Если main уже изменился, остановите принятие. Соберите новый кандидат от новой базы и повторите проверки общего результата. Проверять одну версию, а принимать другую — ошибка даже при отсутствии конфликта. --ff-only не создаёт незаметно дополнительное объединение: если прямое продвижение невозможно, команда завершится ошибкой. Для отправки и принятия через удалённый репозиторий следуйте правилам команды и проверкам актуального запроса на слияние.
После принятия законченной задачи следующую выдавайте от нового принятого коммита. Незавершённую ветку не обновляйте молча: её владелец сначала сохраняет работу, согласует обновление базы, разрешает возникшие конфликты и заново проверяет результат.
При неудаче сохраните работу, а не удаляйте каталог
Если общий тест упал, оставьте итоговую ветку и запишите команду, ошибку, базовый SHA и оба SHA исполнителей. По ним можно определить, воспроизводится ли проблема в одной ветке или возникает только при сочетании функций. Исправление возвращается назначенному владельцу; следующий кандидат снова проходит общий тест.
При конфликте сначала сохраните вывод git status и назовите спорные файлы. Можно отменить незавершённое слияние через git merge --abort, когда понятно, какие изменения были до него и что сохранено. Не используйте принудительное удаление worktree как способ исправить конфликт.
Перед очисткой отдельно проверьте три вида материалов:
- Коммиты должны оставаться достижимыми через сохранённую ветку или другой согласованный указатель.
- Несохранённые изменения отслеживаемых файлов можно сохранить коммитом либо патчем, после проверки его содержимого.
- Неотслеживаемые и игнорируемые файлы нужно сохранить отдельно, если они нужны: обычный diff их не включает.
Для инвентаризации подходят git status --short, git ls-files --others --exclude-standard и git ls-files --others --ignored --exclude-standard. Это списки, а не резервная копия. Восстанавливаемые отчёты и тестовые данные сохраните в разрешённое место; секреты и частные данные не добавляйте в публичный Git.
Завершённый чистый каталог удаляют обычной командой git worktree remove <путь>, проверив сохранность нужных игнорируемых материалов. git worktree prune очищает устаревшие служебные записи отсутствующих каталогов, а не объединяет или резервирует работу. Если временно недоступный каталог нужно сохранить, Git предоставляет worktree lock. Правила удаления, prune и lock.
Как понять, стоит ли добавлять ещё одного исполнителя
Проведите ограниченный опыт на нескольких сопоставимых задачах. Сначала запишите результат работы с одним исполнителем, затем попробуйте разделение. Не сравнивайте простой экспорт в первом случае с большой переделкой архитектуры во втором.
Считайте законченные принятые задачи, время человека на постановку, проверку и исправления, ожидание в очереди, повторную работу и затраты. Число коммитов и строк кода плохо описывает пользу: много изменений можно быстро сгенерировать и долго разбирать.
| Что наблюдаете | Как изменить процесс |
|---|---|
| Принятых результатов больше, время человека на результат не выросло, очередь управляемая | Попробовать ещё одну независимую задачу с теми же правилами |
| Исполнители часто уточняют один и тот же интерфейс | Сначала закончить общий контракт; сократить параллельную часть |
| Готовые изменения долго ждут проверки | Уменьшить число активных исполнителей или выделить время на проверку |
| Повторяются ошибки только после объединения | Усилить проверку общего сценария и пересмотреть границы задач |
| Результат не улучшился, а координация и расходы выросли | Вернуться к одному исполнителю и отдельной проверке |
Выберите срок опыта по размеру задач; неделя может быть удобной организационной рамкой, но не научно установленным сроком. Расходы при работе через API оценивайте по фактическим запросам и тарифам, отдельно от времени людей. Для этой следующей задачи есть руководство по оценке дневных расходов Codex CLI.
Две ветки и зелёные тесты сами по себе не доказывают ускорения. Оставляйте столько исполнителей, сколько команда может снабдить самостоятельными заданиями и довести до принятого результата.
Часто задаваемые вопросы
Можно ли двум агентам работать в разных ветках одного каталога?
Для одновременного изменения файлов — нет: у каталога один текущий набор рабочих файлов. Переключение ветки затронет оба процесса. Выдайте разные worktree или отдельные копии репозитория. Документация Git worktree.
Нужно ли обязательно запускать отдельного агента для проверки?
Нет. Проверку может выполнить человек. Отдельный агент полезен, когда получает понятное задание и точный коммит, а его замечания экономят время команды. Он не должен незаметно изменять проверяемую реализацию; исправление требует нового коммита и проверки.
Можно ли объединить все предложенные агентами варианты?
Только если они решают дополняющие задачи и совместимы с общим контрактом. Для альтернативных реализаций одной функции выберите вариант. Слияние всех альтернатив обычно не выполняет исходную задачу выбора.
Почему надо повторять тесты, если обе ветки уже прошли проверку?
Потому что итоговый код содержит сочетание изменений, которого не было ни в одной исходной ветке. Проверяйте точный итоговый коммит и связанные сценарии. Если целевая ветка изменилась, кандидат нужно пересобрать на актуальной базе и проверить снова.
Worktree защищает соседние файлы и ключи от агента?
Нет. Git разделяет рабочие деревья, индекс и HEAD, но не задаёт разрешения процесса на диск или сеть. Реальные ограничения определяются средой исполнения и действующим режимом доступа. Роль в задании не заменяет эти ограничения. Git worktree, разрешения подагентов Codex.
Сколько агентов нужно небольшой команде?
Начните с одного исполнителя и проверки, затем добавьте второго на самостоятельную задачу. Это предложение для опыта, а не универсальный предел. Увеличение числа исполнителей оправдано, если растёт число принятых результатов без несоразмерного роста ожидания, исправлений и затрат человека.
Источники6
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 8 окт. 2026 г..
Источники6
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 8 окт. 2026 г..
- 1.разборе Фёдора Сергееваvc.ru/ai/3148777-pochemu-git-worktree-nedostatochen-dlya-rabotyi-s-ii-agentami
- 2.Документация Codex о разрешениях подагентовlearn.chatgpt.com/docs/agent-configuration/subagents
- 3.Устройство и ограничения Git worktreegit-scm.com/docs/git-worktree
- 4.Текущий порядок работы Codex с worktreelearn.chatgpt.com/docs/environments/git-worktrees
- 5.Agent teams в Claude Codecode.claude.com/docs/en/agent-teams
- 6.Подагенты и worktree в Claude Codecode.claude.com/docs/en/sub-agents





