Інженерний плейбук команди Claude Code для автоматизованого ревʼю пулл-реквестів
Команда Claude Code розкрила процес ревʼю для обробки понад 30 000 змін щодня в умовах, коли 90% коду пише ШІ. Завдяки переносу перевірок на етап до створення PR та консенсусу агентів частка відкатів знизилася на 40% при подвоєнні обсягу злитого коду.
Чому це важливо
Ви можете структурувати репозиторій за допомогою файлів CLAUDE.md та REVIEW.md, налаштувавши багаторівневу верифікацію коду ще до відкриття PR.
TL;DR
- 01Надавайте ШІ-агентам можливість запускати тести, білди та перевіряти інтерфейс перед тим, як вважати задачу виконаною.
- 02Додавайте файли REVIEW.md у підпапки проєкту з чітким описом критичних збоїв та обмеженням на другорядні коментарі.
- 03Використовуйте фільтрацію через консенсус кількох агентів, щоб відсікати галюцинації та причіпки до стилю.
Ключові факти
- Щоденні зміни в монорепозиторії
- З 2 500 у травні до >30 000 у вересні
- Частка коду, написана Claude
- ~90% (за даними компанії)
- Частка змістовних коментарів ревʼю
- Зросла з 16% до 54% після запуску превʼю
- Зниження частоти відкатів PR
- >40% при подвоєнні обсягу злитих змін
Перенесення перевірок на ранні етапи
За даними Anthropic, Claude генерує близько 90% власного коду. Коли кількість щоденних змін у монорепозиторії компанії зросла з 2 500 у травні до понад 30 000 у вересні, ручне ревʼю стало вузьким місцем. Команда перенесла читання коду на автономні агенти: з червня по вересень кількість злитих PR зросла вдвічі, а частка відкатів скоротилася більш ніж на 40%.
Борис Черний зазначає, що надання моделі можливості верифікувати результат (через запуск тестів, виконання bash-скриптів або перевірку рендеру в емуляторі) підвищує якість у 2–3 рази. Перед публікацією коду локальні навички Claude Code тестують логіку end-to-end і спрощують diff.
Структура CLAUDE.md та REVIEW.md
Автоматизований аналіз спирається на два ключові файли інструкцій:
CLAUDE.md: Описує стек технологій, архітектурні обмеження та ключові правила. Агент сигналізує, якщо код суперечить правилам або робить інструкції неактуальними.REVIEW.md: Створюється власниками підсистем і фіксує критерії відмови (наприклад, збої маршрутизації), шляхи, які слід ігнорувати, та вимогу надавати прямі посилання на файли й рядки замість припущень.
Консенсус агентів та обовʼязкові гейти
Під час аналізу PR декілька агентів паралельно шукають вразливості та голосують за кожне зауваження. Коментар публікується лише за умови згоди більшості агентів, що усуває суперечки щодо форматування. Функціональність доступна у режимах Quick, Standard та Deep, а локальні перевірки запускаються через команди /code-review та /security-review.
Спробуй за 2 хвилини
# REVIEW.md
## Scope & Rules
- Failures: breaking API changes, state desynchronization, unhandled edge cases.
- Skip: autogenerated client bindings under /src/generated/.
- Formatting: Ignore stylistic nits; require exact filename and line number for defects.
- Verification: Require bash test output confirmation before approving.markdown
✓ Коли використовувати
- Команди з високою швидкістю розробки, які активно застосовують Cursor або Claude Code у спільному репозиторії.
- Проєкти, де ручне вичитування пулл-реквестів стало головним барʼєром для релізів.
✕ Коли НЕ варто
- Невеликі сольні репозиторії, де багаторівневі перевірки агентів уповільнюють роботу без реальної користі.
- Швидке прототипування за повної відсутності тестів у CI або сценаріїв для запуску верифікації.
Що зробити сьогодні
- Створіть файл REVIEW.md у корені проєкту з описом критичних помилок та списком шляхів для пропуску.
- Запускайте локальні команди /code-review та /security-review у Claude Code перед відкриттям великих PR.
- Додайте інструкції для автоматичної верифікації в CLAUDE.md, щоб агенти самостійно запускали тести.
Що каже спільнота
“No one cares about good code. It’s a means to an end... The only thing people care about is performant and error free code.”
“If agents made me 2x faster (they have, review is still slow; I currently have 40 PRs open) that’d be the same rate.”
“Poorly I'm afraid, given how many new bugs make their way to the claude code CLI every update.”