Как заставить ИИ-агентов не ломать архитектуру: опыт перестройки проекта на 200К строк

Проблема знакома многим: ИИ-агенты, генерируя код, часто игнорируют архитектурные ограничения и «заливаются» в щели, которые им оставил разработчик. Автор статьи на реальном проекте из 200 тысяч строк столкнулся с тем, что агенты ломали модульную структуру, несмотря на подробные промпты в CLAUDE.md.

Решение оказалось не в словах, а в железе: границы модулей стали проверять линтер и CI-пайплайн. Любое нарушение архитектуры — например, импорт из запрещённого слоя — теперь вызывает ошибку сборки. Агент может предлагать что угодно, но в продакшен попадёт только код, прошедший автоматические проверки.

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

Главный вывод: не пытайтесь «воспитывать» агента текстом — проектируйте архитектуру так, чтобы её было невозможно нарушить технически. Это экономит часы отладки и позволяет спокойно делегировать написание кода ИИ.