Онбординг разработчика случается в комментариях к пулл-реквестам. Не в вики, не на созвонах — в строке «у нас из хендлеров в базу не ходим, есть слой репозиториев». Правило, которого нет ни в одном документе, джун узнаёт из ревью, и за первый месяц таких правил набираются десятки.
Отсюда интерес к AI-ревью. Если оно знает конвенции команды, новичок получает ответ в первую минуту, а не ждёт пять часов, пока старший проснётся в другом часовом поясе. Работает это ровно до тех пор, пока джун читает замечания.
Почему ревью — узкое место
Сеньоры тащат менторство вместе со своей работой. Час на объяснение правил именования — час, не потраченный на проектирование. В кейсе LoopUp старшие инженеры до внедрения AI-ревью тратили заметную долю времени на разбор PR и наставничество.
В распределённых командах эффект злее: ревьюер в шести часах разницы превращает каждый раунд комментариев в сутки, а первый PR — в неделю ожидания.
Ревью по диффу учит не тому, что нужно новичку
Дифф показывает изменённую строку. Конвенция, которую эта строка нарушает, обычно лежит в другом месте: в общем хелпере, в соседнем сервисе, в паттерне, который команда выбрала два года назад.
Ревьюер, который видит только дифф, скажет, что функция длинная, а имя переменной невнятное. Что в платформенном пакете уже есть готовый retry-хелпер, он не скажет: хелпера в диффе нет.
| Что нужно новичку | Ревьюер по диффу | Ревьюер с контекстом всего кода |
|---|---|---|
| Эта строка корректна? | Да, в пределах диффа | Да |
| Может, для этого уже есть хелпер? | Других файлов не видит | Показывает существующий хелпер |
| Так принято у нас? | Общие лучшие практики | Правила команды и прошлые PR |
| Что ещё затронет изменение? | Вызовы не видит | Связанные файлы и сервисы |
| Почему конвенция вообще появилась? | Объяснять не из чего | Ссылается на правило или код, из которого оно выведено |
В монолите разрыв заметнее: модуль тихо зависит от пяти других, и новичок этих связей пока не видит. Ревьюер, который их тоже не видит, просто подтверждает его слепое пятно. Собственные системы не спасают: по признанию Cloudflare (апрель 2026), их внутренние ревьюеры регулярно спотыкаются об архитектурную картину и влияние изменений на соседние системы.
Откуда AI берёт правила, которых никто не записал
В Qodo, на котором построен кейс выше, правила приходят из нескольких источников. Ручной понятен: тимлид формулирует правило словами в портале, система превращает его в проверку. Файловый тоже: правила автоматически импортируются из AGENTS.md, CLAUDE.md и подобных файлов при пуше. Третий интереснее — Rule Miner ищет повторяющиеся паттерны в истории пулл-реквестов и превращает их в правила. Работает на GitHub, GitLab и Azure DevOps, в мульти- и однотенантном развёртывании.
Добытые правила либо включаются сразу, либо ждут в разделе Pending, пока лид их одобрит. Для организаций, начавших пользоваться Qodo после 1 сентября 2026, они по умолчанию идут в работу.
Пример из жизни. Команда логирует всё через общий логгер с request ID, но нигде это не записано. Новичок добавляет «print» для отладки и забывает убрать. Находка объясняет: у нас структурное логирование через общий логгер, request ID нужны для трейсинга, вот какой вызов использовать. Сеньору не нужно печатать этот комментарий пятый раз за квартал.
Первая неделя новичка: по шагам
Порядок стоит держать в голове, даже если конкретные команды у вас будут свои.
День первый: поставить инструменты
Agentic Toolbox требует Node.js 20 или выше. На macOS и Linux установка и проверка доступа выглядят так: curl -fsSL https://get.qodo.ai | sh, затем qodo tools. Для on-prem команда установки своя, её выдают на главной странице портала.
Дни второй и третий: спрашивать до того, как трогать код
До первого тикета новичок выясняет, как модуль стыкуется с системой: «как связаны эти репозитории», «какие сервисы зависят от billing API». Ответы приходят из вашего кода и истории PR, то есть из живых примеров. Такие вопросы закрывает Codebase Wisdom в Agentic Toolbox — он доступен через CLI, MCP и плагины для Claude Code, Codex и Kiro Power.
Дни четвёртый и пятый: первый PR
Команда /agentic_describe собирает структурное описание изменений — полезно и тому, кто читает чужой PR. Дальше находки: что не так, почему это важно, как исправить, по убыванию важности. «Почему» — учебная часть, она превращает замечание в урок. Неясное можно спросить в чате прямо в треде PR.
Недели со второй по четвёртую: от находок к привычкам
Хороший сигнал — одинаковые находки у одного человека появляются всё реже. Плохой — не меняется ничего. Аналитика разбивает находки по репозиторию, автору PR, важности, категории и типу, плюс показывает, какие правила срабатывают чаще всего. Лид видит, на чём спотыкается новичок, и сажает его на час к нужному сеньору вместо десяти одинаковых комментариев.
Джуны, которые жмут «принять»
AI-ревью умеет вредить. Тот, кто принимает каждую находку не читая, учится кликать. В небольшом интервью-исследовании (arXiv 2607.24606, июль 2026) джуны, которые проверяли вывод и просили объяснений, продолжали учиться; те, кто пропускал эти шаги, получали поверхностное понимание. Выборка качественная, но картина знакомая.
Правило простое: каждую принятую находку джун должен уметь объяснить своими словами. Проверяется на one-on-one — попросите рассказать об одной находке за неделю и о том, откуда взялась конвенция. Не рассказал — значит, принял не глядя.
Документация врёт так же, как её читают
Устаревший README обманывает и человека, и агента: оба начинают с него. Cloudflare держит в своей системе ревьюера, который проверяет свежесть AGENTS.md, — такие файлы быстро протухают. Классический пример: команда переехала с Jest на Vitest, инструкции не обновила, и AI продолжает писать тесты на Jest.
Qodo импортирует правила из AGENTS.md и CLAUDE.md на каждом пуше, так что исправленный файл сразу меняет поведение ревью. Плюс правила, находки по которым почти не исправляют, отключаются автоматически (если лид не залочил их). Мёртвое правило перестаёт учить новичка тому, что команда уже не практикует.
Человеческая привычка в довесок: если PR меняет способ работы — новый тест-фреймворк, новый логгер, — шаблон PR может спрашивать, не пора ли обновить AGENTS.md или README.
Чек-лист перед включением
- Проверьте, что ревьюер видит весь репозиторий. Если он смотрит только дифф, получите общие советы из учебника.
- Заведите хотя бы десяток правил вручную — те, которые вы уже устали повторять.
- Почистите AGENTS.md и README до включения: агент прочитает их первыми.
- Решите судьбу добытых правил: сразу в бой или через одобрение лида.
- Зафиксируйте, что находки AI совещательные. Решение об изменениях и мерже остаётся за человеком.
AI-ревью ускоряет онбординг ровно настолько, насколько хорошо оно знает ваш код. Инструмент, который видит только дифф, научит новичка общим истинам про длину функций. Инструмент с контекстом репозитория и историей PR объяснит, почему в этой команде принято именно так, и снимет со старших повторяющуюся часть менторства.
Оставшееся не автоматизируется: читать находки, задавать вопросы, проверять. Это и есть работа новичка.
Fluxs
Комментарии (0)
Войдите, чтобы комментировать.
Пока нет комментариев. Будьте первым.