ДокументацияРуководстваСравненияТарифВопросы English
← Все руководства

Несколько ИИ-агентов над одним проектом без конфликтов

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

Почему агенты мешают друг другу

Агент читает файл, думает минуту и пишет правку. Если за эту минуту второй агент поменял тот же файл, одна из правок пропадет или ляжет поверх чужой. Хуже, когда агент запускает тесты, а они падают из-за недописанного кода соседа: он начинает «чинить» то, что не ломал.

Отсюда два правила параллельной работы:

  • у каждого агента своя рабочая папка;
  • части задачи не правят одни и те же файлы.

Для разработчика первое обычно значит git worktree: вторая рабочая копия того же репозитория на своей ветке. Это надежно, но требует помнить команды и потом сливать ветки руками.

Дайте каждой сессии свою копию проекта

В Hedoq копия заводится галочкой, без слов «ветка» и «коммит»:

  1. «Новая сессия» (⌘N), выберите агента и проект.
  2. Включите «Отдельная копия проекта».
  3. Сессия стартует в своей копии. В боковом меню у нее значок ветки справа от названия.

Пункт есть, если проект уже под git и в нем есть хотя бы один коммит. Копия лежит вне папки проекта, файлы .env из корня переносятся в нее сами. Две сессии без копии в одной папке видят одни и те же изменения: это не ошибка, просто одна папка на двоих.

Проверяйте результат перед тем, как взять его

Работа агента в копии не трогает ваш проект, пока вы не решите. Посмотреть, что он сделал:

  • правый клик по сессии в меню, пункт «Изменения»;
  • или кнопка Git в шапке окна, на ней число измененных файлов.

Слева список файлов, справа разница. Дальше одно из двух:

  • «Применить к проекту»: изменения копии вливаются в проект;
  • «Отменить все»: копия выбрасывается, проект как был.

Если изменения не ложатся на проект без конфликта, Hedoq ничего не трогает и показывает ошибку. Тогда проще попросить агента подтянуть свежий проект и решить конфликт у себя в копии.

Делите большую задачу на независимые части

Свои копии решают конфликт файлов, но не конфликт решений: два агента могут по-разному назвать одно поле API. Поэтому до старта нужен общий контракт.

В Hedoq для этого есть команда ⚡ «Разделить задачу на части». Сессия, где вы ее вызвали, становится ведущей и код задачи сама не пишет:

  1. Делит задачу на части, от двух до четырех, так, чтобы части не правили одни и те же файлы. Если так разделить нельзя, говорит вам и делает задачу одна.
  2. Фиксирует общее: контракты API, имена, структуру папок. Записывает это файлом в репозиторий.
  3. Заводит на каждую часть новую сессию в своей копии проекта и дает задачу: что сделать, какие файлы можно трогать, где контракт, когда работа считается готовой.
  4. Не ждет в цикле. Каждая часть один раз присылает ответ: что сделано, какие файлы, что проверено.
  5. Проверяет результат и говорит вам, что готово, а где расхождения.

Применяете части вы сами, в окне «Изменения». Если исполнитель застрял или ответил, но его работу долго никто не взял, Hedoq один раз будит ведущую сессию, потом еще раз через пять минут и дальше молчит: напоминания тоже стоят токенов.

Связывайте сессии вместо копирования

Иногда параллельные сессии просто должны поговорить. Например, сессия фронтенда хочет знать, что решила сессия бэкенда. В Hedoq это делается через ⚡:

  • «Узнать, чем занята другая сессия»: та пришлет краткую сводку;
  • «Поручить задачу другой сессии»: она сделает и пришлет ответ сюда;
  • «Показать экран другой сессии»: эта сессия прочитает экран соседки и перескажет;
  • «Разорвать связь с сессией»: сессии перестанут писать друг другу.

Ответ приходит один раз, а не постоянными докладами, чтобы не тратить лимит.

Помощники внутри одной сессии

Claude Code умеет сам запускать помощников (субагентов) для поиска по коду или проверки. Это тоже параллельная работа, только внутри одного разговора. В ленте Hedoq такая пачка видна одной строкой «Помощники: работают N из M», у каждого крутилка, галочка или крестик. После завершения строка остается в истории с итогом.

Когда что брать:

  • быстрый поиск и проверка, без правок: помощники внутри сессии;
  • независимые части с правками: отдельные сессии в своих копиях;
  • спорное решение: совет моделей.