Я понял почему AI-агент косячит. И это не его вина.

Я просил добавить одну маленькую функцию — агент добавлял её и заодно менял три других вещи которые я не трогал. Иногда ломал то что работало. Иногда писал код в неожиданных местах.

Я думал проблема в агенте. Что он недостаточно умный. Что нужно лучше объяснять.

Оказалось проблема была в том как устроен мой проект.

Мой проект был написан так что всё было связано со всем. Агент когда получал задачу видел весь этот клубок сразу. И начинал "помогать" там где не просили — потому что видел связи и хотел их починить.

Я разбил проект на маленькие независимые части. Каждая делает ровно одно. Когда я прошу агента добавить что-то новое — он видит только этот маленький кусок. Остальное для него не существует.

И ещё одно правило которое изменило всё — одна задача, один разговор с агентом. Начинаю новый чат, даю одну конкретную задачу, получаю результат, закрываю. Никакого накопленного контекста из прошлых задач который начинает влиять на новые решения.

Агент перестал ломать то что не просили трогать. Физически не может — он просто не видит остального кода.

Новая функция — это новый маленький файл. Агент пишет его отдельно. Он не знает как устроено всё остальное и не пытается это "улучшить".

Под капотом там event bus и изолированные воркфлоу — но это больше интересно разработчикам. Нам важен принцип.

За два дня переписал архитектуру проекта и не сломал ни одной вещи которая уже работала.

---

Маленькие независимые части, одна задача за раз — и агент наконец делает что просят.

Если хочешь разобраться как выстроить работу с AI-агентами в своём бизнесе — давай разберёмся вместе.