Архитектурные тесты вместо промптов. Как лечить старый код с помощью ИИ
В проекте с 120 000 строк кода ИИ-агенты начали писать плохой код, копируя ошибки предшественников. Чтобы спасти систему, разработчик перешёл от текстовых инструкций к жёстким архитектурным тестам.
Когда в проект с огромным техническим долгом внедрили Claude Code, тесты начали появляться, но они не решали проблем. Модели честно копировали плохие практики, принятые в репозитории за шесть лет разработки. В итоге ИИ писал код, который соответствовал старым ошибкам проекта, а автоматические ревью только раздували объём проверок, пропуская архитектурные дыры.
Вместо того чтобы просто давать ИИ новые инструкции, разработчик внедрил ArchUnit. Эта библиотека позволила создать «цифровой забор». Теперь любой новый код, нарушающий слоистую архитектуру или создающий циклические зависимости, просто не проходит сборку. Старый код остался в списке исключений, но новые ошибки больше не проникают в систему.
Помимо слоёв, ввели точечные запреты. Изменяемым структурам данных объявили войну через миграцию на Java records. Чтобы избежать утечки персональных данных, архитектурные тесты запретили передавать объекты базы данных напрямую клиентам. Для разделения перегруженных сервисов и уменьшения конфликтов при разработке пришлось выделить чистую доменную логику.
Количество тестов выросло с 700 до 6800 за два месяца. Это стало возможным благодаря подробному руководству для модели о том, как писать качественные интеграционные тесты. Без чётких правил ИИ-ассистент лишь создавал видимость работы, подменяя реальную проверку логики декоративными тестами.
Для исправления системы пришлось заменить человеческие пожелания в промптах на автоматические проверки. Теперь любая попытка нарушить правила ломает сборку, и это работает лучше любой инструкции. Для поддержания чистоты кода в долгосрочной перспективе важны не советы ИИ, а жёсткие технические ограничения.
Что поменялось
Вместо текстовых инструкций для ИИ были внедрены архитектурные тесты, которые блокируют сборку при нарушении правил проекта.
Источники · 1
Текст подготовила языковая модель по материалам источников.
