Сплановані задачі паралельно: хвилі агентських сесій у git worktree

Беклог задач зі стрілками залежностей; задачі, що правлять різні файли, складають хвилю, кожна йде у своєму worktree через код, рев'ю й документацію і зливається в dev у запланованому порядку.

Команда CRUX · · Оновлено · 9 хв читання

Щоб запустити кілька сесій Claude Code паралельно, дайте кожній задачі свій git worktree і беріть лише задачі, які правлять різні файли. Worktree не пускає правки одного агента в чекаут іншого, а план не дає задачам зіткнутися на злитті. Ми просимо агента прочитати беклог і запропонувати таку порцію, хвилю, а людина погоджує її, перш ніж щось почнеться.

Повільно тоді, коли агент працює сам

Кодинг-агент закриває задачу за годину-дві. Більшу частину цього часу ви йому не потрібні: агент читає код, пише його, запускає тести. Якщо вести по одній задачі, день іде на очікування наступної контрольної точки погодження.

Очевидне рішення — запускати кілька задач одночасно. На перший погляд десять сесій мали б закрити десять задач за час однієї. На практиці дві речі йдуть не так:

  • Сесії заважають одна одній. Два агенти в одному чекауті правлять ті самі файли, недороблена зміна одного ламає тести іншого, і вже не розбереш, чия це зміна.
  • Задачі стикаються на злитті. Навіть в окремих чекаутах дві задачі, які змінюють той самий файл, ту саму таблицю в базі чи той самий згенерований код, наприкінці дають конфлікт злиття або зламану збірку, коли зіллються обидві.

Першу проблему знімає git worktree, другу — планування. Ця стаття про те, як поєднати обидва, коли більшу частину планування бере на себе агент.

Вперше чуєте про CRUX? Почніть зі статті Як працює CRUX. Про паралельні сесії з боку воркфлоу ми писали в Досить писати промпти: навіщо AI-агентам воркфлоу.

Окремий worktree на кожну задачу

Git worktree — це ще одна робоча директорія того самого репозиторію на власній гілці. Історія в нього спільна з основним чекаутом, а файли окремі: те, що там править один агент, інші не бачать, доки зміну не зіллють.

У CRUX кожна задача отримує свій worktree з її назвою: .claude/worktrees/CR-1729 на гілці CR-1729. Його створює скіл crux-worktree (або бере вже наявний) і переносить туди сесію. Проєкт може підключити власну команду налаштування. Наша підтягує локальний .env, ставить залежності й дає гілці окрему тестову базу, тож тести одного worktree ніколи не пишуть у базу іншого.

Усі агенти задачі працюють в одному worktree. Розробник пише там код, рев'юер читає ту саму гілку й комітить туди свої виправлення, а крок документації бере звідти фінальний diff. Шукати гілку нікому не доводиться.

Worktree розводить файли, але не каже, які задачі можна вести паралельно. Це питання планування.

Спершу план, тоді видно, що можна паралелити

Паралельна робота безпечна лише тоді, коли ще до старту відомо, що кожна задача зачепить і на що чекає. Це дає планування наперед, а не агенти посеред роботи.

Сам CRUX зазвичай починає фічу з короткої специфікації. Її розбивають на задачі, і кожна задача каже три речі:

  • Що вона змінює: кілька рядків із назвою частини коду, наприклад «адаптер Jira», «спільний UI-фільтр» або «таблиця token_usage».
  • На що вона чекає: зв'язок «blocked by» у трекері, наприклад «спершу зливається задача з API-контрактом».
  • Нотатки про злиття, якщо задача ділить файл із сусідньою: «зливати після задачі зі схемою», «після rebase перезапустити генератор коду».

На старті це забирає трохи часу, а окупається щоразу, коли плануєте хвилю. Задачі, описані так, можна порівнювати одна з одною.

Попросіть агента знайти задачі, які йдуть разом

Збирати хвилю вручну означає прочитати кожну готову задачу, перевірити кожен блокер, пам'ятати, які файли зачіпає кожна і де вони перетинаються. Коли в беклозі сорок задач, на це йде пів дня. Агент робить це за кілька хвилин.

Ми відкриваємо чат-сесію і просимо приблизно так: «Проаналізуй беклог і знайди задачі, які можна запустити зараз однією паралельною хвилею». Агент працює за скілом queue-advice і проходить дошку:

  1. Читає чергу. Кожну задачу, готову до реалізації, з її рівнем, пріоритетом, оцінкою та зв'язками.
  2. Перевіряє кожен блокер. Задача, яку блокує щось ще в роботі, не підходить, навіть якщо стоїть у колонці готових. Блокер у групі «done» вже нічого не блокує.
  3. Перевіряє, що вже зроблено. Дошка відстає від коду. Наші коміти називаються CR-N: …, тож агент шукає їх в історії й знаходить задачі, які злили, але не перенесли. За один прохід він знайшов таких 36.
  4. Роздає задачі субагентам. Коли беклог великий, основна сесія віддає групи задач субагентам, які лише читають. Кожен звітує по кожній задачі: чи готовий опис до реалізації, які файли й частини коду вона зачепить, чи потрібні живі акаунти або чиєсь рішення і які пари задач перетинаються.
  5. Збирає хвилю. Задачі без відкритих блокерів і без небезпечних перетинів ідуть у хвилю. Решту агент розкладає на «наступну хвилю» і «поза хвилею», кожну з причиною.

queue-advice — це наш внутрішній скіл, у публічному плагіні його поки немає. Щоб спробувати ідею, досить промпту вище.

Відповідь — план у чаті. Скорочений приклад:

ХВИЛЯ: можна запускати зараз (8 задач)
- WA-01  спільний UI: підказка, бічна навігація секцій. Розблоковує WA-07 і решту епіку.
- WA-03  API: список прив'язок
- WA-05  колонки дошки Jira
- TL-01  схема бази. Єдина міграція в цій хвилі.
- TL-03  зведення задач у всіх 4 адаптерах трекерів
- TL-06  спільний UI: панель фільтрів
- PS-01  публічний DTO статусу. Розблоковує PS-02 і PS-04.
- MT-01  прибрати stdio-транспорт. Розблоковує MT-02.

ПОРЯДОК ЗЛИТТЯ там, де задачі ділять файли
- індекс спільного UI: WA-01, TL-06. Дрібні текстові конфлікти, зливати по черзі.
- адаптер Jira: TL-03 і WA-05, одна за одною.

ВІДКЛАДЕНО НА ХВИЛЮ 2
- SP-01 змінює ту саму таблицю, що й TL-01. Дві міграції однієї таблиці
  конфліктують у файлі схеми. Затримки немає: SP-05 однаково чекає на TL-07.

ПОЗА ХВИЛЕЮ
- CL-10 навантажувальний бенчмарк: потрібна вільна машина, запускати окремо.
- SG-08 розширює CI: потрібне ваше рішення.

Агент радить, а не вирішує. Ви читаєте план, додаєте чи прибираєте задачу, відповідаєте на відкриті питання й кажете «запускай».

Правила, які не дають хвилі зіткнутися

За понад два десятки хвиль у нас склався короткий список правил. Агент застосовує їх, коли збирає хвилю, а задачі згадують їх у нотатках про злиття.

  • Одна міграція на хвилю або по одній за раз. Дві задачі, які змінюють схему бази, конфліктують у файлі схеми й у порядку міграцій. Або лишайте одну на хвилю, або зливайте по черзі й перегенеровуйте після кожного rebase.
  • Одна задача на весь репозиторій за хвилю, і зливається вона останньою. Перейменування, кодмод чи перенесення пакета зачіпає майже кожен файл. Запускайте таку задачу поруч із задачами з інших частин коду, спершу зливайте все інше, потім робіть rebase і перезапускайте кодмод на фінальному дереві.
  • Для спільних файлів — порядок злиття. Індексні файли, згенерований код, спільний API-контракт: задачі, що їх зачіпають, можна вести паралельно, але план каже, хто зливається першим і хто перегенеровує після.
  • Спільний хелпер називайте заздалегідь. Коли чотири сусідні задачі будують частини однієї сторінки, кожна охоче напише власну копію того самого хелпера. Пропишіть у задачах, яка з них володіє спільним модулем, а які його використовують.
  • Зважайте на машину. Кожна сесія запускає свої тести, перевірку типів і pre-push перевірку. Одного разу ми запустили хвилю з 30 задач. Навантаження ноутбука перевалило за 100, перевірки стояли в черзі по двадцять хвилин, а тести падали за таймаутом у файлах, яких ніхто не чіпав. Тепер ми тримаємо хвилю в межах десяти задач.

Запуск хвилі

Коли план погоджено, сесія-координатор запускає хвилю командою crux-dispatch developer з нашого плагіна для Claude Code. Для кожної задачі вона робить дві речі:

  1. Закріплює крок за вами, щоб цю задачу більше нікому в команді не пропонувало.
  2. Готує картку сесії в Claude Code desktop. У термінальних клієнтах натомість друкує по одній команді на задачу.

Сам по собі нічого не запускається: сесія стартує, коли ви клікаєте на її картку. Нова сесія отримує від CRUX інструкції агента-розробника, переходить у worktree задачі й рухається контрольними точками вашого воркфлоу: погоджує з вами підхід, пише код, відкриває pull request. Закінчивши, вона готує наступний крок тієї самої задачі — рев'юера, а після нього оновлення документації.

Тепер у вас вісім чи десять задач пліч-о-пліч проходять той самий пайплайн. Ваша робота — відповідати на контрольні точки, коли вони надходять: тут погодити план, там підтвердити зауваження рев'ю.

Як не загубити, яка сесія що робить

Десять сесій одночасно легко переплутати. Розрізнити їх допомагають дві речі.

Усе називається за задачею. Сесія має назву CR-1729 · developer, її worktree — .claude/worktrees/CR-1729, гілка — CR-1729, наші коміти починаються з CR-1729, а pull request прив'язаний до задачі. Рев'юер тієї самої задачі — CR-1729 · reviewer. Коли приходить питання, з назви одразу видно, про яку задачу і який крок ідеться.

CRUX показує стан кожного кроку. Сторінка Workspace у дашборді CRUX показує задачі за статусами. На картці кожної задачі видно її пронумерований пайплайн, наприклад 1 Developer, 2 Reviewer, 3 Wiki curator, зі станом і тривалістю кожного кроку та лічильником готових кроків (3/3). Відкрийте крок, і бічна панель покаже його сесію: який агент, де він працював (сесію у вашому власному Claude Code позначено External), коли почав і закінчив і що зробив, наприклад pull request і звіт рев'ю. Фільтри Needs you і Running лишають тільки сесії, які чекають на вас або ще працюють, а дзвіночок у шапці рахує ті, що чекають на вас, у всіх проєктах. Не треба відкривати десять сесій, щоб знайти ту, що застрягла.

Сторінка Workspace у CRUX: дві задачі в Implementation, у кожної пайплайн із трьох кроків (Developer, Reviewer, Wiki curator), усі виконані, з тривалістю; бічна панель показує сесію рев'юера, що працювала в Claude Code з позначкою External, її час початку й кінця, задачу і результати: pull request і звіт рев'ю.
Сторінка WorkspaceПронумерований пайплайн кожної задачі зі станом і тривалістю кожного кроку; бічна панель показує сесію відкритого кроку, її задачу і те, що вона зробила.

Поки хвиля йде

Сесія-координатор лишається відкритою й тримає хвилю в порядку:

  • Зливає в запланованому порядку. Коли перша задача на спільному файлі злита, координатор просить сесії, що йдуть після неї, підтягнути свіжий dev і зробити rebase.
  • Передає рішення. На питання, яке стосується кількох задач, ви відповідаєте один раз, а координатор розсилає відповідь кожній сесії, якій вона потрібна.
  • Може поставити хвилю на паузу. Коли машині бракує CPU, координатор зупиняє активні сесії, просить кожну не перезапускати тести, а потім відновлює їх по кілька за раз.

Після хвилі

Коли всі pull request-и хвилі злиті, координатор прибирає, перш ніж планувати наступну:

  • перевіряє, що кожен pull request, і з кодом, і з документацією, справді злитий;
  • переносить злиті задачі в потрібний статус на дошці;
  • архівує сесії хвилі;
  • видаляє чисті worktree, а про ті, де лишилася незакомічена робота, повідомляє замість видаляти.

Тоді він знову читає беклог. Задачі, які годину тому були заблоковані, тепер вільні, і наступна хвиля часто вже готова.

Як виглядали два тижні такої роботи

Ми будуємо CRUX за допомогою CRUX. З 22 жовтня по 5 листопада в dev злили понад 300 pull request-ів, це понад 250 задач, і кожну хвилю спланувала й запустила одна сесія-координатор. Пораховано за змердженими pull request-ами і ключами задач у нашій git-історії.

Саме план тримав це під контролем. Кожну хвилю перевіряли на перетини ще до старту, тож конфлікт був тим, на що план чекав, із готовим порядком злиття і кроком rebase, а не несподіванкою наприкінці.

Де лишаються люди

Десять агентів одночасно не означає, що вони працюють самі. Людина вирішує в кожній точці, де хибний поворот коштував би дорого:

  • специфікація й розбиття на задачі;
  • хвиля: які задачі, в якому порядку і що чекає;
  • контрольні точки кожної задачі: підхід, рев'ю, документація;
  • злиття.

Читання й облік між цими точками бере на себе агент.

Спробуйте

Плагін CRUX для Claude Code публічний: github.com/cruxteam/skills. crux-dispatch запускає хвилю, crux-run — один крок на одній задачі, а crux-worktree переносить сесію у worktree її задачі. Встановлення:

claude plugin marketplace add cruxteam/skills
claude plugin install crux@cruxteam

Навіть без CRUX спробуйте ідею на наступній порції роботи: запишіть кожну задачу з файлами, які вона зачепить, і тим, на що вона чекає, а потім спитайте свого агента, які з них можна вести паралельно.

Часті запитання

Чим git worktree відрізняється від гілки?

Гілка — це лінія комітів, а worktree — тека, де викачано одну гілку. Дві сесії на двох гілках в одній теці весь час перемикають одна одній файли. Два worktree дають кожній сесії власну теку й власну гілку над спільною історією.

Скільки сесій Claude Code можна запускати паралельно?

Стільки, скільки ваша машина може одночасно тестувати. Кожна сесія запускає власні тести й перевірки типів. Понад десяток на одному ноутбуці в нас почали ставати в чергу й падати за таймаутом, тож ми тримаємо хвилю на рівні десятка задач.

Як обрати задачі, які не зіткнуться?

Беріть задачі без відкритих блокерів, які змінюють різні файли. Якщо двом задачам доводиться ділити файл, дайте їм порядок злиття, а міграції бази і зміни на весь репозиторій тримайте по одній на хвилю.

Як побачити, яка сесія чекає на мене?

Власний Agent View у Claude Code (claude agents) показує сесії, які чекають на відповідь. Називайте все за задачею, тоді назва сесії одразу каже, про яку задачу і який крок ідеться. У CRUX сторінка Workspace показує стан кожного кроку, а Needs you — сесії, які чекають на вашу відповідь.

Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.

Почати безкоштовно

Далі: Вікі проєкту: пам'ять, яку AI-агенти вміють читати й писати

Усі статті