Параллельные агенты не делают общий проект автоматически быстрее. Если все меняют один файл или ждут одного неготового решения, добавляются конфликты и повторные исследования. Польза появляется там, где можно заранее разделить ответственность и независимо проверить части результата.
Параллельность начинается с границ владения и заканчивается проверкой соединённых частей.
Возьмём учебную функцию списка заметок. Один исполнитель отвечает за API, второй за интерфейс, третий за проверку сценариев. Их общая цель - пользователь видит только свои записи, может открыть заметку и понимает ошибку загрузки. Количество исполнителей вторично по отношению к этому проверяемому поведению.
Начните с одной короткой договорённости
До параллельной работы зафиксируйте маршрут, поля и ошибки. Например, GET /api/notes возвращает объект с массивом items, каждая запись содержит id, title, updated_at. При отсутствии сессии сервер отдаёт заранее выбранный статус, а интерфейс показывает вход. Пустой массив - нормальное пустое состояние, не ошибка сети.
Добавьте пример ответа на вымышленных данных. Укажите формат даты и правило сортировки. Если интерфейс рассчитывает на updatedAt, а сервер отдаёт updated_at, оба фрагмента могут выглядеть правильными по отдельности и всё равно не работать вместе.
Контракт не обязан быть длинным документом. Важно, чтобы он был доступен всем исполнителям и изменения сообщались сразу. До согласования новой схемы не стоит одновременно переписывать клиента и сервер на разные догадки.
Назначьте владельцев файлов
API-исполнитель меняет серверный модуль и связанные проверки. Исполнитель интерфейса владеет компонентом списка и состояниями загрузки. Проверяющий описывает независимые сценарии и не переписывает оба модуля параллельно с авторами. Общий файл схемы имеет одного владельца или меняется последовательно.
В поручении явно напишите: «Ты не один в проекте; не откатывай чужие изменения». Укажите границы и ожидаемый результат. «Сделай фронт» слишком широко, если соседний исполнитель меняет общий роутер и компоненты. Более точное владение уменьшает случайные пересечения.
Не выдавайте всем одинаковую задачу «исследуй весь проект», если достаточно одного подтверждённого ответа об API. Результат исследования можно передать остальным с точными путями и ограничениями. Это экономит время и снижает расхождение трактовок.
Разделите рабочие копии
Git worktree позволяет иметь несколько рабочих деревьев одного репозитория. Каждому исполнителю можно выделить отдельную ветку и каталог. Пример команд ниже создаёт новые рабочие деревья от текущего HEAD учебного репозитория; выполняйте их только после проверки состояния и выбранной исходной версии.
git status --short
git rev-parse --show-toplevel
git worktree add -b feature/notes-api ../notes-api HEAD
git worktree add -b feature/notes-ui ../notes-ui HEAD
git worktree list
Отдельный каталог не изолирует общую базу, порты или внешние сервисы. Для локальных процессов задайте разные порты и тестовые данные. Если оба исполнителя запускают миграции в одной базе, конфликт возможен даже при идеально разделённых файлах.
Не создавайте worktree ради одноразового чтения файла. Используйте разделение там, где оно помогает независимым изменениям. В некоторых средах все агенты намеренно работают в одном каталоге; тогда особенно важны файловое владение и последовательные изменения общего слоя.
Принимайте результат по поведению
API-часть должна показать чтение только своих записей, пустой список, отказ гостю и понятный сбой. Интерфейс должен показать загрузку, нормальный список, пустоту и ошибку. Затем требуется совместный путь: реальный клиент обращается к реальному тестовому API с согласованной схемой.
Успешная проверка компонента на подставных данных не подтверждает правильность подключения. И наоборот, ответ сервера 200 не означает, что интерфейс показал список и сохранил навигацию. Общая приёмка соединяет эти наблюдения в один пользовательский сценарий.
Проверяющему полезно дать задачу искать расхождения с исходным требованием. Если он только повторяет проверки автора, может остаться незамеченной общая ошибочная предпосылка. Например, оба автора решили, что достаточно скрыть чужую заметку в интерфейсе, хотя сервер выдаёт её всем.
Как собирать изменения
Координатор сначала читает краткий отчёт каждой части: что изменено, какие проверки выполнены, что осталось неизвестным. Затем смотрит разницу с исходной версией, совмещает изменения и выполняет необходимые совместные проверки. Не нужно повторять каждый успешный тест без причины, но объединение может создать новые связи, которые требуют проверки.
Если возник конфликт, выясните смысл обеих правок. Автоматически выбрать «нашу» версию целого файла значит потенциально выбросить работающую часть соседа. После разрешения проверьте общий контракт и затронутый сценарий.
Не называйте код опубликованным после локального объединения. Ветка, проверка, merge, сборка и работа у пользователей - разные состояния. Публикация требует отдельного поручения в пределах процесса проекта и подтверждения фактического результата.
Когда параллельность лучше сократить
Если один исполнитель постоянно ждёт изменения схемы, завершите схему последовательно. Если две части делят один сложный модуль, передайте владение одному автору, а второму поручите проверку. Если задача маленькая, расходы на передачу контекста могут превысить пользу.
Полезно спрашивать: какой результат может быть завершён независимо? Параллельное написание двух несвязанных тестовых случаев часто разумнее, чем совместное редактирование одной функции. Не нужно увеличивать число агентов ради самого числа.
Упражнения и ответы
- Сервер меняет схему ответа, интерфейс об этом не знает. Что сделать сначала? Обновить общий контракт и сообщить изменение, затем править клиента.
- Worktree разные, база одна. Есть ли полная изоляция? Нет; общие процессы и данные нужно учитывать отдельно.
- Оба автора прошли собственные проверки. Нужен ли совместный путь? Да, он проверяет связь частей и пользовательский результат.
Частые вопросы
Нужен ли отдельный агент на каждую мелочь? Нет. Выделяйте независимый результат, который оправдывает передачу контекста.
Можно ли всем менять один файл? Можно только с очень аккуратной последовательностью. Для параллельной работы лучше определить единого владельца.
Координатор должен писать весь код заново? Нет. Его задача - проверить согласованность, соединить части и подтвердить общий сценарий.
Откройте Кодик, чтобы посмотреть доступные учебные направления и выбрать подходящий маршрут. Умение сформулировать контракт и проверить объединённый результат полезно и при работе с людьми, и при работе с ИИ.