CODA — агент, который пишет документацию за разработчиков

Документация устаревает всегда. Не потому что разработчики ленивые, а потому что писать её нужно в тот момент, когда задача уже закрыта и голова занята следующей.

CODA закрывает этот разрыв: она подключается не к желанию человека, а к пайплайну CI.

Как устроено

Событие. Пайплайн CI успешно собрал коммит — и дёргает агента webhook’ом.

Разница. Агент запрашивает у Git диф между коммитами и понимает, что именно изменилось.

Работа. Запускается сессия ИИ-агента с доступом к трём хранилищам: база знаний, архитектурная модель инфраструктуры и реестр описаний API. Агент читает изменения и правит то, что от них зависит: страницу сервиса, схему связей, спецификацию.

Аудит. Каждый вызов инструмента пишется в базу: видно, что агент читал и что менял.

Отдельно есть режим сверки: агент проходит по страницам базы знаний и сопоставляет их с источниками истины — репозиториями, манифестами, реальным состоянием, — отмечая расхождения.

Почему это работает

Документация обновляется в момент, когда изменение уже описано в коммите и его смысл ещё восстановим из разницы. Через неделю ни человек, ни агент этого не сделают.

Что это даёт

Описание сервиса перестаёт быть архивным документом «на момент внедрения». В базе знаний лежит то, что действительно развёрнуто, — и на это можно опираться при разборе аварии в три часа ночи.