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

  1. Створіть проєкт. Увійдіть, створіть організацію та проєкт, виберіть трекер GitHub Issues і репозиторій. Префікс задач проєкту, <KEY>, підставляється з назви репозиторію. Змінити його можна, поки ви створюєте проєкт, а пізніше вже ні. Issue #N у CRUX має ключ <KEY>-N.
  2. Встановіть CRUX GitHub App. Встановлення починає власник вашої організації в CRUX, а власник організації в GitHub встановлює або схвалює застосунок там. Той самий застосунок дає CRUX доступ до вибраних репозиторіїв: до коду, pull requests, issues і projects організації.
  3. Підключіть свій акаунт GitHub. Кожен учасник підключає власний акаунт GitHub на сторінці «Підключені акаунти». Після цього CRUX діє в GitHub від імені цієї людини.
  4. Статуси. CRUX сам знаходить вашу дошку GitHub Projects, а без неї тримає статуси в мітках. Як саме, пояснює наступний розділ.
  5. Підключіть агента. Кожен учасник відкриває «Підключіть свого кодинг-агента», створює особистий токен і зберігає його в змінній середовища CRUX_MCP_TOKEN.
  6. Налаштуйте воркфлоу. Адмін проєкту встановлює плагін і запускає /crux:crux-config у Claude Code, а для цього потрібне підключення з кроку 5. Агент прочитає ваші статуси, спитає, хто відповідає за кожен, і запропонує папку .crux/ у pull request. Без репозиторію коду CRUX імпортує воркфлоу напряму. Без Claude Code оберіть у дашборді «Почати із шаблону» або «Зібрати з моєї дошки».
  7. Запустіть крок. Виконайте /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 DoPMrefinerкритерії приймання
In ProgressDeveloperplannerплан реалізації
In ReviewDeveloperreviewerзвіт рев'ю
DonePMнемаєнемає

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

Що агент читає і що може змінювати

Агент читає задачу, її батьківський 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.