Як працює CRUX: ваш трекер, воркфлоу та агенти, яких запускає людина

Команда CRUX · · Оновлено · 5 хв читання
Проблема: трекер і агенти без спільних правил
Більшість команд, що працюють з AI, уже мають дві речі. Трекер (Jira Cloud, Linear, Plane чи GitHub Issues), де планується робота, і кодинг-агентів (Claude Code, Codex, Cursor), які виконують дедалі більшу її частину. Бракує їм зазвичай одного: чогось, що поєднує одне з іншим.
Тож кожна сесія агента — імпровізація. Хтось копіює задачу в промпт, з пам'яті вирішує, яких правил агент має дотримуватися, і перевіряє результат так, як згадає того дня. Наступна людина робить це інакше. У трекері задача In progress, але ніхто не бачить, який агент над нею працює, що йому сказали і хто схвалив те, що він зробив.
CRUX — це шар між ними: один набір правил на проєкт, який каже, що відбувається із задачею в кожному статусі, хто за неї відповідає і які агенти допомагають.
Трекер лишається джерелом правди
CRUX не замінює ваш трекер і не копіює дошку в новий інструмент. Задачі, статуси, коментарі й спринти лишаються там, де команда вже працює. CRUX їх читає, а агенти пишуть у ті самі задачі: питання, план, опис зміни. Він не просить змінювати налаштування трекера: підлаштовується під ваші статуси й типи задач такими, як вони є.
Це важливо з двох причин. Люди працюють в інструменті, який знають, а все, що зробив агент, лежить у задачі під ім'ям людини, яка почала крок, і будь-хто з команди може це прочитати згодом.
Воркфлоу: статус → роль → агенти
Воркфлоу — це правила проєкту у вигляді звичайних файлів (тека .crux/, у вашому репозиторії, якщо він у проєкту є). Для кожного статусу трекера, з яким працює CRUX, воркфлоу каже три речі:
- Яка роль ним володіє. Роль — це «капелюх», який вдягає людина: розробник, QA, проєктний менеджер, дизайнер. Людина обирає ролі, в яких працює, і дашборд показує їй саме ці статуси й агентів.
- Які агенти тут допомагають, кожен зі своїми інструкціями і скілами (записаними методами, яких він дотримується, наприклад як провести технічне інтерв'ю чи як переглянути pull request).
- Що лишає по собі кожен крок: артефакт, структурований коментар у задачі, який наступний крок читає замість чужої історії чату.
Наприклад, статус Implementation належить ролі розробника, а його кроки — агент-розробник, що пише код і відкриває pull request, рев'юер, що перевіряє його за правилами проєкту, і куратор вікі, що оновлює документацію проєкту. Докладніше про це — у статті Досить писати промпти: навіщо AI-агентам воркфлоу.

Два види агентів, і обидва чекають на людину
Агенти в статусі бувають двох видів:
- Чат-агенти — помічники, з якими ви розмовляєте: вони розпитують того, хто знає відповідь, готують тест-кейси або підказують, що взяти далі. (Докладніше — у статті Не лише для розробників: AI-агенти для PM, QA і клієнтів.)
- Агенти пайплайна — упорядковані кроки статусу, як-от розробник → рев'юер → куратор вікі вище. Кожен публікує свій артефакт у задачу.
Жоден із них не стартує сам. Жоден агент у CRUX не працює у фоні: чат починається, коли хтось його відкриває, а крок пайплайна — коли його запускає людина. Коли один крок завершився, наступний чекає на вас. Почати крок можна з дашборда або з Claude Code з плагіном crux (/crux:crux-run).
Кожен агент також працює в одному з двох місць:
- Runs on CRUX: на серверах CRUX, з моделлю й ключем, які налаштував проєкт. Він читає трекер, а також код і вікі, якщо проєкт дозволяє, але код не змінює.
- Runs on your machine: у вашому власному кодинг-агенті, у вашому checkout, на тарифі, за який ви вже платите. Саме тут пишеться код.

Контрольні точки погодження і Needs you
Почати кожен крок — це один клік, але люди не стежать за кожним кроком. Вони долучаються в кількох контрольних точках погодження, там, де хибний поворот ще дешево виправити: коли агент зрозумів задачу, коли має план і коли показує результат. У кожній із них агент готує чернетку артефакту в чаті, ви її правите, і він публікує її лише після явного «ок». Між контрольними точками робота йде без вас.
Коли агент чекає на ваше схвалення або сесія завершилася з помилкою, вона з'являється в блоці Needs you на вашій домашній сторінці, поруч із запитами, які чекають на вас. Тож не треба тримати в голові кожну відкриту сесію: те, що потребує вас, приходить до вас саме.
Агенти не переводять задачі між статусами. Це робить людина, у трекері або попросивши агента зробити це за неї. (Чому ми так робимо — у статті Не автономний AI-розробник.)
П'ять кроків до першого запуску пайплайна
Від реєстрації до першого запуску — п'ять кроків:
- Організація. У ній живуть ваша команда, її проєкти та агенти. Людей можна запросити згодом.
- Проєкт. Один проєкт у вашому трекері, під'єднаний до CRUX: проєкт у Jira, команда в Linear, проєкт у Plane або issues GitHub-репозиторію, зі статусами з дошки GitHub Projects чи з міток
S:. Трекер один раз під'єднує адмін вашої організації в CRUX. Jira Cloud і Linear підключаються через OAuth, і застосунок може потребувати схвалення адміна воркспейсу. GitHub Issues підключається через GitHub App у вашій організації на GitHub. Для Plane ви вставляєте персональний токен. Агентам, що працюють на CRUX, ще потрібен ключ моделі для проєкту. - Воркфлоу. Оберіть шаблон або дайте своєму кодинг-агенту розпитати вас про команду й запропонувати воркфлоу у вигляді pull request. Деталі ви налаштовуєте в дашборді.
- Під'єднайте свого кодинг-агента. CRUX працює через MCP, стандартний спосіб, у який кодинг-агенти користуються зовнішніми інструментами. Ви додаєте CRUX у Claude Code, Codex, Cursor чи інший MCP-клієнт з особистим токеном, і ваш агент читає задачі та воркфлоу проєкту й діє від вашого імені. Це займає близько хвилини, один раз на проєкт.
- Перший запуск пайплайна. Оберіть задачу, почніть її перший крок, дайте відповіді на питання агента і схваліть його артефакт на першій контрольній точці.

Якщо ви приєднуєтеся до команди, де вже є організація, проєкт і воркфлоу, ви починаєте з кроку 4: під'єднання власного кодинг-агента.
Коротко
- Трекер зберігає задачі, а CRUX додає правила того, що з ними відбувається.
- Воркфлоу дає кожному статусу роль-власника та її агентів, а кожен крок лишає артефакт у задачі.
- Чат-агенти й агенти пайплайна стартують лише тоді, коли їх запускає людина, на CRUX або на вашій машині.
- Люди схвалюють роботу на контрольних точках, а Needs you показує, що чекає саме на вас.
Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.
Почати безкоштовноДалі: Воркфлоу у CRUX: статуси, ролі й рівні
Див. також: Воркфлоу команди з Claude Code на Jira, Linear чи GitHub
Усі статті