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

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

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

![Обновление документации и схемы сервиса после успешной сборки](/images/illustrations/part2/12-coda.webp)

## Как устроено

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

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

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

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

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

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

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

## Что это даёт

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