Не лише для розробників: AI-агенти для PM, QA і клієнтів

PM і агент-радник разом пишуть опис задачі: агент ставить запитання, а артефакт опубліковано.

Не всі в команді пишуть код

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

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

Тому в CRUX є два види агентів:

  • Агенти-виконавці (worker) працюють на машині розробника в Claude Code і пишуть код.
  • Агенти-радники (advisor) працюють на нашому сервері як чати в дашборді CRUX. Вони для тих, хто здебільшого працює з текстом задач.

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

Ця стаття про радників. Ще не знайомі з CRUX? Почніть зі статті Досить писати промпти: навіщо AI-агентам робочий процес.

Лише читання, і це навмисно

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

А от працювати із задачею радник може, і лише так, як потрібно для його роботи:

  • Більшість радників читають задачу і публікують один артефакт: коментар з результатом свого кроку, наприклад уточнення, вимоги чи тест-кейси.
  • Деякі мають ще одну-дві дії в трекері. Агент оцінювання може поставити оцінку. Агент проєктного менеджера може створити підзадачі. Агент прийому багів може створити баг і прикріпити скриншот.
  • У наших шаблонах ніщо не потрапляє в задачу без вашого схвалення. Агент показує чернетку в чаті, ви її виправляєте, і він публікує лише після явного «ок». Усе руйнівне, як-от видалення, або чекає вашого підтвердження кліком, або заборонене.
  • Агенти не переводять задачі між статусами. Це робить людина.

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

Розібратися в проєкті, який писали не ви

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

Новий QA-інженер може спитати: «Як зараз працює відновлення пароля і що буде, якщо посилання вже прострочене?» У відповідь він отримає короткий зрозумілий опис: які кроки проходить користувач, скільки діє посилання, яке повідомлення з'являється, коли строк минув. Агент назве сторінку вікі й файл коду, звідки це взяв, і скаже, якщо вони одне одному суперечать. Агент лише читає й пояснює.

Невеликий набір інструментів — теж навмисно

Ми могли б дати кожному раднику всі інструменти, які маємо. Але не даємо.

Коли агент бачить сорок інструментів, він витрачає зусилля на вибір і часом помиляється: шукає, коли треба прочитати, або редагує, коли треба прокоментувати. З коротким списком правильний вибір зазвичай очевидний.

Тож радник отримує невеликий сталий набір: прочитати файл, пошукати, подивитися історію, пройти посиланнями у вікі, пошукати в інтернеті, завантажити skill. Понад це — лише ті дії в трекері, які потрібні для його роботи.

Свої skills і MCP-сервери

Кожен радник може мати власний набір skills і MCP-серверів.

  • Skill — це записаний метод, за яким працює агент: як провести інтерв'ю, як написати тест-кейси, як оцінити задачу. Це тека з файлом SKILL.md у вашому репозиторії. Можна написати свій або додати публічний з GitHub.
  • MCP-сервер підключає агента до іншої системи: інструмента дизайну для агента-дизайнера, вашої аналітики для аналітика, сайту документації для QA.

Агент бачить лише те, що підключено саме до нього.

Приклад: PM, розмита задача і grill-me

grill-me — публічний skill від Метта Покока. Він розпитує вас про ідею, доки ви обидва не дійдете спільного розуміння, і до кожного запитання пропонує свою відповідь, тож можна просто сказати «так». Це тонка обгортка над skill під назвою grilling, тому додавати треба обидва. За замовчуванням він питає короткими раундами; один рядок у промпті агента змушує його питати по одному запитанню, і для швидкого чату це зручніше.

Підключіть його до PM-радника й відкрийте задачу, у якій написано лише: «Дати клієнтам експортувати звіти. Кілька людей просили».

Агент: Я прочитав задачу і вікі. У вікі описано три звіти: «Підсумок продажів», «Журнал активності» та «Рахунки». Усі три запити клієнтів, на які посилається задача, згадують «Підсумок продажів». Пропоную почати лише з нього. Так?

PM: Так, поки лише «Підсумок продажів».

Агент: Який формат? У коді вже є завантаження CSV для «Рахунків», його можна перевикористати. Пропоную спершу CSV — він відкривається в Excel, — а справжній файл Excel згодом, якщо клієнти й далі проситимуть. Гаразд?

PM: Вони казали «Excel», але якщо CSV там відкривається, то підходить.

Агент: Хто може експортувати? За вікі, «Підсумок продажів» бачать адміністратори й менеджери. Пропоную: хто бачить звіт, той може його й експортувати.

PM: Ні, лише адміністратори. Менеджерам не треба виносити ці дані.

Агент: Експорт має враховувати фільтри на екрані (період, команду) чи завжди містити все? Пропоную враховувати фільтри.

PM: Враховувати фільтри, і період — не більше 12 місяців.

Агент: Ось чернетка для задачі. Публікувати?

PM: ок

Агент: Опубліковано в задачі.

Артефакт у задачі:

ARTIFACT: уточнення v1 (схвалено PM у чаті)
- Обсяг: експорт лише звіту «Підсумок продажів»; інші звіти поза обсягом.
- Формат: CSV (відкривається в Excel), перевикористати наявне завантаження CSV.
- Доступ: лише адміністратори; менеджери бачать звіт, але не експортують.
- Дані: враховують фільтри на екрані; період не більше 12 місяців.
- Відкрите питання: чи логувати експорт для аудиту? Відповіді поки немає.

Десять хвилин у чаті — і наступна людина, будь то розробник, QA чи інший агент, починає з чіткої задачі, а не з припущень. (Як ми тримаємо цю вікі актуальною, описано в статті Вікі проєкту: пам'ять, яку AI-агенти вміють читати й писати.)

Жодної комісії з токенів

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

Коротко

  • Радники — для тих, хто працює із задачами, а не з кодом: PM, QA, клієнтів.
  • Вони читають вікі й код за вас і ніколи їх не змінюють.
  • Невеликий набір інструментів, а до нього — власні skills і MCP-сервери кожного агента.
  • Вони готують чернетку, ви схвалюєте, і лише тоді результат іде в задачу.
Усі статті