GitHub Issues і Claude Code, Codex чи Cursor: воркфлоу для команди
Оновлено
CRUX з'єднує GitHub Issues з агентом, яким ви вже користуєтеся, з дошкою GitHub Projects або без неї. Сторінка для невеликої команди або мейнтейнера open-source проєкту, якому потрібно, щоб кожен крок запускала людина, а агент знав історію задачі.
Чому самого тексту issue мало
До CRUX ми давали агентові текст одного GitHub issue і більше нічого. Далі на цій сторінці це задача. Агент не знав, чому попередній код написано саме так, тож переписував його і ламав поведінку, яка працювала.
Що CRUX додає до GitHub Issues
Задачі, коментарі й статуси лишаються в GitHub. CRUX дає кожному статусу роль-власника, агентів і артефакт, який лишає кожен крок. Через CRUX агент читає задачу й попередні задачі з погодженими артефактами. Код і вікі агент на вашій машині читає з локальної копії репозиторію, а не через MCP.
Як підключити GitHub Issues
- Створіть проєкт. Увійдіть, створіть організацію та проєкт, виберіть трекер GitHub Issues і репозиторій. Префікс задач проєкту,
<KEY>, підставляється з назви репозиторію. Змінити його можна, поки ви створюєте проєкт, а пізніше вже ні. Issue#Nу CRUX має ключ<KEY>-N. - Встановіть CRUX GitHub App. Встановлення починає власник вашої організації в CRUX, а власник організації в GitHub встановлює або схвалює застосунок там. Той самий застосунок дає CRUX доступ до вибраних репозиторіїв: до коду, pull requests, issues і projects організації.
- Підключіть свій акаунт GitHub. Кожен учасник підключає власний акаунт GitHub на сторінці «Підключені акаунти». Після цього CRUX діє в GitHub від імені цієї людини.
- Статуси. CRUX сам знаходить вашу дошку GitHub Projects, а без неї тримає статуси в мітках. Як саме, пояснює наступний розділ.
- Підключіть агента. Кожен учасник відкриває «Підключіть свого кодинг-агента», створює особистий токен і зберігає його в змінній середовища
CRUX_MCP_TOKEN. - Налаштуйте воркфлоу. Адмін проєкту встановлює плагін і запускає
/crux:crux-configу Claude Code, а для цього потрібне підключення з кроку 5. Агент прочитає ваші статуси, спитає, хто відповідає за кожен, і запропонує папку.crux/у pull request. Без репозиторію коду CRUX імпортує воркфлоу напряму. Без Claude Code оберіть у дашборді «Почати із шаблону» або «Зібрати з моєї дошки». - Запустіть крок. Виконайте
/crux:crux-run <KEY>-N plannerу Claude Code.
Встановлення плагіна в Claude Code:
claude plugin marketplace add cruxteam/skills
claude plugin install crux@cruxteamЯк статуси GitHub Projects працюють із Claude Code?
У GitHub Projects статуси живуть у полі Status дошки Projects v2, а без дошки CRUX тримає їх у мітках S:<NAME>. Якщо у вас є дошка, CRUX сам її знаходить, бере статуси з її поля Status і записує зміни статусу туди ж. Вибирати дошку доведеться, лише коли ви можете писати в кілька. Без дошки CRUX сам створює мітки S:<NAME>. Особистий репозиторій завжди працює на мітках. Issue, якого немає на дошці, не має статусу, тож не потрапляє в чергу жодної ролі, доки CRUX не задасть йому статус і не додасть на дошку.
Як статуси стають кроками воркфлоу
Так виглядає шаблон, з якого починає новий проєкт. Під час налаштування ви зіставляєте його статуси з вашою дошкою або мітками і змінюєте ролі та агентів.
| Статус | Роль-власник | Агент | Артефакт |
|---|---|---|---|
| To Do | PM | refiner | критерії приймання |
| In Progress | Developer | planner | план реалізації |
| In Review | Developer | reviewer | звіт рев'ю |
| Done | PM | немає | немає |
Крок запускає людина в ролі власника статусу. На контрольних точках погоджує людина. Зазвичай це розуміння задачі агентом, його план і результат. У наступний статус задачу теж переводить людина.
Що агент читає і що може змінювати
Агент читає задачу, її батьківський issue, її sub-issues, коментарі та зв'язки. Зв'язок у GitHub буває blocks або blocked by. Агент шукає задачі, зокрема за мітками.
Він може створювати й оновлювати задачі, додавати коментарі та зв'язки. Статус або оцінку він має змінювати лише тоді, коли про це просить людина. Оцінку CRUX зберігає міткою EST:. У GitHub агент не може прикріплювати файли, додавати URL-посилання чи видаляти задачу.
Ніхто не діє від імені бот-акаунта. Текст, який написав агент, починається з емодзі робота 🤖.
Кожен крок лишає артефакт структурованим коментарем у задачі. На контрольній точці агент публікує його лише після того, як ви погодили чернетку. Наступний крок читає цей коментар, а не історію чату.
Чим CRUX відрізняється від власного агента GitHub
Хмарний агент GitHub Copilot бере issue, який ви йому призначили, працює в хмарній пісочниці GitHub і відкриває pull request. У CRUX кожен крок запускає людина. Контрольні точки для розуміння задачі та плану стоять до коду. Призначити задачу агентові в Jira чи делегувати issue в coding sessions Linear працює так само, як із Copilot; ці продукти порівнює сторінка Агенти «задача в PR».
Обмеження
- CRUX підтримує лише дошки Projects v2. Класичні дошки не працюють.
- Проєкт у CRUX відповідає одному репозиторію і щонайбільше одній дошці.
- GitHub Enterprise Server як трекер не підтримується.
- CRUX працює лише як хостований сервіс. Версії для власного сервера немає.
- CRUX у беті.
Наступний крок
Почати безкоштовно. Точні налаштування для Codex, Cursor та інших агентів є в статті Підключіть свого кодинг-агента до CRUX.
Часті запитання
Чи потрібен GitHub Projects, чи досить самих issues?
Самих issues досить. Без дошки Projects v2 CRUX тримає статуси в мітках S:<NAME>, які створює сам.
Чи можна працювати з Codex або Cursor замість Claude Code?
Так. Claude Code потрібен лише для команди налаштування /crux:crux-config, а без неї воркфлоу налаштовують у дашборді.
Скільки це коштує?
Одна людина користується CRUX безкоштовно. Команда з 2 до 10 людей платить $49 за активний проєкт на місяць, а 11 і більше людей платять $120. Перший місяць кожного проєкту безкоштовний. Поки триває бета, білінг не ввімкнено, тож нічого не списується. Подробиці на сторінці цін.
Інші трекери
CRUX також працює з Jira Cloud, Linear і Plane.