Поддержка БОЛЬШИХ проектов на ИИ-агентах БЕЗ деградации кода

Источник

Это инфа, которую я собирал более полугода. И это +- самое дорогое из знаний об ИИ, что у меня есть. Начну сразу с "тяжёлой артиллерии". Позже будет статья с более базовыми принципами.

ВСЕ из пунктов очень важны для крупных проектов. Но я всё равно постарался упорядочить их по убыванию важности.

1. Правильный выбор модели - самый важный пункт. Модели на данный момент ОЧЕНЬ СИЛЬНО отличаются.

На конец января 2026 модель №1 в мире для кода - это Opus 4.5. Его родное агент-приложение - Claude Code. Можно взять подписку на $20, а потом доплатить до подписки в $100, если понравится.

2. Документация (CLAUDE.md/AGENTS.md). Создаётся силами ИИ по вашему запросу. Это позволяет агенту НЕ изучать код проекта с нуля, тратя на это лимиты и контекст.

Дока - это краткий пересказ всего вашего проекта. Не забывайте просить ИИ её обновлять, например, глядя на последние коммиты.

В больших проектах без документации никуда, так как агент может просто физически не успеть уложиться в отведённый ему контекст, изучая код по поставленной ему задаче. Документация может быть многоуровневой, если у вас огромный проект.

3. Рефакторинги и ревью. Периодически ОБЯЗАТЕЛЬНО нужно делать рефакторинги и ревью. Просто спросите у ИИ, что можно сделать на этот счёт. Просите сделать план, и выбирайте то, что нужно. Повторяйте, пока ИИ не начнёт предлагать избыточные оптимизации.

Без этого проект с ростом будет деградировать, а код превращаться в помойку. И в какой-то момент вы будете создавать больше багов, чем решать задач.

Примеры: оптимизация по DRY/YAGNI, секьюрити-ревью, архитектура и структура, перфоманс, разделение бизнес-логики и UI.

4. Ограничение размеров файлов (и функций за компанию). Если у вас в проекте файлы по 1к+ строк, то это крайне быстро сожрёт контекст и лимиты.

Проще всего проблема решается через ESLint (если вы JS/TS-кодер) и запрет на коммит кода с ошибками (спросите у ИИ как). Правила max-lines и max-lines-per-function. Думаю, значения в 200-300 и 20-30 будут ок.

5. Используйте TypeScript (или другую типизацию). Оч желателен строгий конфиг (и линтер тоже настройте строго). Это радикально повышает качество кода, и ИИ начинает понимать происходящее в коде с полуслова, видеть связи итд.

6. Тесты (e2e, юниты и какие вам ещё нравятся). Чтобы предотвратить поломку существующего функционала в будущем, нужно писать тесты. ИИ прекрасно пишет тесты.

7. Частые коммиты. Выполнил любую ценную мелочь - коммит. ИИ генерирует к коммитам шикарные описания на основе проделанной работы. Это источник доп документации, если описания достаточно подробные.

Итого
Если стабильно придерживаться ВСЕХ этих правил, то даже большие проекты можно развивать почти не глядя в код

Если чего упустил - пишите.