Добавляете AI-агентов в проект, а они ведут себя непредсказуемо? Дело не в модели — дело в архитектуре

Вот 5 признаков, что система не готова:

1. God Object вместо доменной модели AI-агент не понимает, где начинается одна ответственность и заканчивается другая. 5000 строк в одном классе = хаос для агента.

2. Прямые вызовы БД из UI-слоя Агент должен работать через чёткие границы. Если UI лезет напрямую в базу — агент сломает инварианты с вероятностью 100%.

3. Нет явных портов и адаптеров Clean Architecture нужна не ради красоты — она даёт агенту понятные точки входа. Без этого агент угадывает.

4. Отсутствие контрактов (типы/схемы) TypeScript strict mode + Zod = язык, на котором агент общается с кодом. Без типов — телепатия.

5. Побочные эффекты везде Если функция одновременно считает, пишет в БД и шлёт email — агент не может безопасно её вызвать. Нужна изоляция эффектов.

Проверил на своём проекте: после рефакторинга под Clean Architecture + DDD агенты стали работать в 3 раза надёжнее. Не потому что модель стала умнее — потому что код стал читаемее.

Какой из этих признаков встречается у вас чаще всего?