Старший разработчик Axenix Антон Богун предлагает расширить практику Doc as Code для обучения ИИ-агентов. Традиционное хранение документации в Git обеспечивает контроль версий, но не всегда позволяет агентам отследить изменения в логике работы системы.
В современных проектах методы API и структура запросов могут оставаться прежними, тогда как поведение системы меняется. Например, внедрение дополнительной проверки заказов или использование брокеров сообщений часто остается скрытым от ИИ, если компоненты проекта не связаны между собой.
Простого доступа к OpenAPI-спецификациям, README и Markdown-файлам недостаточно для полноценной работы агентов. Для понимания актуального поведения системы разработчикам необходимо интегрировать кодовую базу, документацию и задачи из трекеров в единый контекст.
