Проєкти / reviewable-agentic-development

Розробка з агентамигрудень 2025 – вересень 2026

Розробка з агентами як практика, прозора для рев'ю

Я зробив AI-сесії частиною код-рев'ю: зі шкалою оцінювання, названими червоними прапорцями й онбординговим курсом як обов'язковим етапом. Швидкість без прозорості для рев'ю — це борг.

Claude CodeCodexBMADGitHub ActionsNotion APITypeScript

Проблема

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

Що я зробив

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

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

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

Оркестрація. Трекер роботи, у якому кожен пункт проходить через вузли discover, session і resolve, і де агент, що виконує роботу, сам записує свою впевненість, ризик і запропонований наступний крок, замість того щоб їх обчислювала евристика. Будь-який вузол можна запустити на одній моделі, на раді моделей або в порівнянні двох моделей віч-на-віч. Поруч інструмент змагального рев’ю кількома моделями: кілька раундів структурованої незгоди між трьома передовими моделями в ролях архітектора, red team і синтезатора, із суддею. Я провів дев’ять таких рев’ю на реальних проєктних рішеннях.

Чому це важливо

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