Запись архива

Два ИИ-агента в одной папке — плохая идея. Спасает git worktree

Несколько агентов в одной папке правят одни файлы и конфликтуют. Правило: одна задача — один агент — одна папка. Разбираем git worktree.

Два ИИ-агента конфликтуют в одной папке, решение — раздельные ветки git

Запустить несколько ИИ-агентов параллельно кажется хорошей идеей — быстрее же.
Но если посадить их в одну папку, они начинают мешать друг другу: правят одни и
те же файлы, оба пишут «готово», а человек потом руками разбирает <<<<<<<
и конфликты. Есть простое правило и инструмент, который его реализует.

Два ИИ-агента конфликтуют в одной папке, решение — раздельные ветки git

В чём проблема

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

Правило: одна задача — один агент — одна папка

Формула простая: если агент работает параллельно, он должен работать
изолированно.
У каждого агента — своя задача и своя рабочая копия проекта.

Как это делает git worktree

В git для этого есть механизм worktree — он создаёт отдельную ветку и отдельную
рабочую копию проекта в другой папке:

git worktree add ../app-login-fix -b login-fix

Теперь агент работает в ../app-login-fix на своей ветке login-fix, не пересекаясь
с остальными. Каждому агенту дают короткое ТЗ-карточку:

Цель:    починить логин
Можно:   src/auth/*
Нельзя:  src/payments/*
Проверка: npm test -- auth

Такая карточка задаёт границы — что трогать, что нет, чем проверять результат.

Итог

Несколько агентов — это хорошо, но только в изоляции. git worktree даёт каждому
свою ветку и папку, а карточка ТЗ — чёткие границы. Тогда параллельная работа
ускоряет, а не создаёт хаос.

Источники

  • Документация git worktree: https://git-scm.com/docs/git-worktree
  • Обсуждение хаоса параллельных агентов: r/ClaudeCode; docs Claude Code (worktrees, subagents).