Эта статья отвечает на прямой практический вопрос: как заставить кодинг-агента писать код под актуальный AdonisJS без галлюцинаций в устаревших API и без построчной вычитки каждого сгенерированного файла. Для этого создатель фреймворка Харминдер Вирк выпустил Flow — официальный харнес контекстного инжиниринга, вошедший в платформу AdonisJS Plus, о запуске которой команда объявила 16 ноября 2026 года в публичном анонсе.
Вместо очередного системного промпта на пару сотен строк харнес закрывает сразу два контура: задаёт агенту актуальные правила стека до генерации кода и отсеивает типичные ошибки уже на этапе пуллреквеста, работая внутри Claude Code, Cursor и других локальных сред. Я разобрал устройство инструмента на сценарии с AdonisJS 6, чтобы показать, как этот цикл срабатывает на практике и где проходят его границы.
Почему агенты путаются в версиях фреймворков и где ломается контекст
Когда разработчик работает через Claude Code, Cursor, Codex, GitHub Copilot или OpenCode, узким горлышком становится уже не скорость набора кода, а время на его чтение. По опыту Вирка, при неточном контексте модель додумывает недостающие детали из старых обучающих данных, и экономия от генерации сгорает в построчном ревью.
Свой подход автор называет «software factory», но сразу уточняет: это не конвейер без присмотра. Задачи в issues по-прежнему ставит человек, и финальное слово перед слиянием ветки остаётся за ним, а агенты забирают реализацию и открывают пуллреквесты. Именно так Вирк собрал сайт, реестр пакетов и дашборд AdonisJS Plus.
Чтобы такой поток не буксовал на повторяющихся ошибках, контекст приходится делить на две половины:
- Контекст продукта — бизнес-логика, доменные компромиссы и архитектурный вкус команды, который уникален для каждого проекта.
- Контекст технологического стека — раскладка каталогов, правила валидации, работа с ORM и стандарты тестов, которые одинаковы для всех приложений на AdonisJS.
Поддерживать вторую половину вручную в каждом репозитории — лишняя работа, хотя многие команды уже держат в корне общие правила вроде CLAUDE.md, о чём мы говорили в материале про выстраивание AI-native процессов в репозитории. Flow берёт контекст стека на себя: его пишут авторы фреймворка и обновляют синхронно с релизами пакетов.
Возьмём живую задачу: в приложении на AdonisJS 6 с Lucid ORM ты просишь агента сделать контроллер аутентификации и профиля пользователя. Без харнеса модель легко смешает вызовы v4, v5 и v6, набросает файлы вручную с произвольной структурой, прочитает невалидированные поля через request.all() или забудет фильтрацию по текущему пользователю. С Flow маршрут меняется на каждом этапе.
Четыре квадранта контекстного инжиниринга: как Flow замыкает цикл
Самое точное наблюдение в архитектуре Flow — разделение на упреждение и проверку. Инструкции без последующего контроля не видят, сработали ли они, а одни проверки без правил ловят одну и ту же ошибку в каждом коммите. Поэтому харнес опирается на 2×2-матрицу из доклада Жоэля Кенневилля «Harness Engineering on Rails» и статьи Биргитты Бёкелер о харнес-инжиниринге: воздействие до написания кода (feed forward) или после (feedback), выполненное детерминированным инструментом (computational) либо моделью (inferential).
Первый квадрант — генераторы (feed forward + computational). Агенты склонны создавать файлы с нуля руками, из-за чего структура контроллеров в проекте расползается. Навыки Flow обязывают модель сначала вызвать node ace make:controller AuthController или node ace make:model, получить предсказуемый каркас по конвенциям AdonisJS 6 и только потом писать логику.
Второй квадрант — версионированная документация и восемь навыков (feed forward + inferential). Flow устанавливает локальные гайды строго под мажорные версии Lucid ORM, VineJS и Bouncer, установленные в проекте, вычищая очевидные для LLM описания и оставляя жёсткие правила там, где модели обычно гадают. Рядом работают восемь встроенных навыков с префиксом /flow- — модульный подход, близкий к схемам из разбора эволюции агентных навыков. Они закрепляют выбор слоёв и контроль доступа: в нашем AuthController агент сразу использует схемы VineJS для входящего payload и Bouncer для проверки прав, а выборки в списках и массовых операциях ограничивает текущим пользователем.
Третий квадрант — линтер-правила (feedback + computational). Детерминированные требования к структуре проекта и полноте тестов упакованы в правила ast-grep внутри ESLint. Они срабатывают в редакторе, по npm run lint и в CI независимо от того, кто написал код, и не отъедают токены в контекстном окне модели.
Четвёртый квадрант — ревью пуллреквестов (feedback + inferential). Ревьюер проверяет дифф по тем же правилам, что зашиты в навыках, вылавливая четыре типичные проблемы AdonisJS:
- IDOR — экшен контроллера загружает чужую запись без проверки владельца.
- N+1 — списочный запрос уходит в базу за каждой строкой из-за пропущенного
preload. - Блокирующая миграция — изменение схемы таблицы способно остановить запись в продакшене при деплое.
- Обход валидации — данные запроса вроде
request.all()попадают во внутренние слои минуя VineJS.
Если при сборке профиля пользователя агент всё же пропустил прямое обращение к request.all(), ревью остановит такой пуллреквест до слияния.
Интеграция в локальные агенты, границы применимости и первый шаг
Flow работает поверх уже установленного локального агента в проекте на Node.js v20+ и AdonisJS 6+ при активной подписке с доступом к приватному реестру @adonisplus. Для подключения харнеса в репозиторий достаточно добавить пакет через Ace CLI и запустить мастер настройки:
node ace add @adonisplus/flow
node ace flow:install
Первая команда скачивает @adonisplus/flow, а вторая привязывает версионированную документацию, правила ast-grep для ESLint и навыки к выбранной среде — Claude Code, Cursor, Codex, GitHub Copilot или OpenCode. После этого в окне диалога с агентом по команде /flow- открывается список всех встроенных архитектурных сценариев.
Чтобы прогнать ревью незакоммиченных изменений или открытого пуллреквеста локально до отправки в репозиторий, запускается одна команда:
npx @adonisplus/flow review
Проверка выполняется локально или в собственном пайплайне GitHub Actions на твоих API-ключах либо подписке к LLM: код не отправляется на серверы AdonisJS, а кредиты и токены платформа не перепродаёт. При желании Flow спокойно сосуществует рядом с общими ревьюерами вроде CodeRabbit или Pullfrog.
Помимо самого харнеса, подписка AdonisJS Plus за $19 в месяц при годовой оплате ($228 в год, есть 30-дневный возврат) включает Feature packs — рецепты сквозных функций вроде passkeys, 2FA и безопасного сброса пароля, которые агент встраивает прямо в существующий код вместо жёсткого шаблона, модули Persona и Permissions для учётных записей и ролей, а также закрытый Discord. Для Вирка, перешедшего на full-time работу над фреймворком в июле 2025 года и собравшего более сотни первых подписчиков с марта 2026-го, это способ развивать бесплатный open-source AdonisJS.
Но применять инструмент вслепую не стоит — у него есть три заметных ограничения:
- Требования к стеку: харнес рассчитан на актуальную шестую ветку фреймворка (AdonisJS 6+) и современную среду выполнения — проекты на старых четвёртой и пятой версиях он не подхватит.
- Закрытая платная модель: сейчас доступна только персональная подписка (командный тариф в планах), а исходники правил
ast-grepи навыков не опубликованы на GitHub. - Граница ответственности: Flow знает фреймворк, но не заменяет продуктовые правила и финальный контроль мерджа со стороны разработчика.
Проверить, насколько такой контур нужен твоей команде, можно прямо сегодня без покупки подписки: открой последний пуллреквест от кодинг-агента и пройдись по списку типовых промахов, которые отлавливает Flow — обходу валидатора, пропущенному preload, отсутствию проверки владельца и рискованным миграциям. Если хотя бы пара таких дефектов нашлась, системный харнес или жёсткие правила в репозитории точно окупят себя на первом же ревью.



