CH.04agent-monorepo— шаблон для команд, где большую часть кода пишут агенты. сначала контракты, потом люди, потом агенты.
← вся работа
▸ ГЛ.04 / agent-monorepo · oss-инструмент
КОГДА
2025 → сейчас
РОЛЬ
автор · мейнтейнер
МЕТРИКИ
рантаймыnest · nuxt · flutter
контрактыopenapi + asyncapi
лицензияmit

цель

сделать так, чтобы в реальном продукте — бэкенд, веб, мобилка — большую часть кода мог безопасно и дёшево писать ai-агент, и при этом части не расходились молча.

проблема

агенты быстрые, но узко смотрят. они спокойно добавят поле в nest-контроллер и забудут про nuxt, переименуют flutter-модель и оставят серверную схему как есть. в обычном монорепо ничто их не останавливает — типы живут отдельно в каждом рантайме, и первая настоящая обратная связь — это 500-ка в проде.

как решаем

один контракт, три рантайма.

  • openapi + asyncapi — единственный источник правды для запросов, событий и доменных моделей.
  • кодген выдаёт типизированных клиентов и серверные заглушки для nest (typescript), nuxt (typescript) и flutter (dart) — изменение в спеке ломает компиляцию там, где это важно, до того как агент успеет отгрузить.
  • prisma 7 для данных, better auth для сессий, turbo + pnpm для склейки.
  • структура репо и readme написаны под агентов: маленькие понятные поверхности, чёткие границы «можно/нельзя», скрипты, которые агент реально умеет запускать.

сам шаблон специально маленький. идея не в «использовать этот фреймворк», а в «клонируй, выкинь лишнее, сохрани привычку писать через контракт».

исходники → github.com/evgentus-cy/claude-driven-nest-nuxt-flutter-monorepo

● oss · инструмент · mit