Контекстный инжиниринг для ИИ-агентов: как официальный харнес Flow обучает нейросети архитектуре AdonisJSСтатья · дайджест за 17 ноября
Инженерная диорама в виде архитектурного каркаса AdonisJS с направляющими рельсами для ИИ-агентов.
Статья3 раздела≈ 7 мин

Контекстный инжиниринг для ИИ-агентов: как официальный харнес Flow обучает нейросети архитектуре AdonisJS

Эта статья отвечает на прямой практический вопрос: как заставить кодинг-агента писать код под актуальный 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, отсутствию проверки владельца и рискованным миграциям. Если хотя бы пара таких дефектов нашлась, системный харнес или жёсткие правила в репозитории точно окупят себя на первом же ревью.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3