Агентская разработка и Documentation Driven Development: ИИ пишет контракты, а не код

Разработчики, использующие большие языковые модели для написания кода, часто сталкиваются с одной и той же проблемой: модель генерирует код, который выглядит рабочим, но при проверке обнаруживаются ошибки. Повторный запрос с тем же промптом приводит к другой архитектуре, и на проверку уходит ещё больше времени. Вместо того чтобы просить ИИ сразу реализовать задачу целиком, предлагается сначала заставить его спроектировать систему и создать контракты — OpenAPI, Proto, JSON Schema, CloudEvents или AsyncAPI. Такой подход получил название Documentation Driven Agent Development.

Суть метода в том, что главным артефактом становится не код, а его спецификация. Код при этом рассматривается как производное от контракта. Повторяемые части системы берет на себя обычный генератор, а проектно-зависимые — разработчик совместно с агентом, работающим в контексте репозитория. Это позволяет избежать нестабильности результатов и сократить время на проверку изменений.

На примере разработки простой автоматической телефонной станции (АТС) автор материала показывает, как такой подход работает на практике, и проводит границу между генераторами и агентами: первые отвечают за типовые фрагменты, вторые — за архитектурные решения в рамках заданных ограничений. В итоге ИИ перестает быть «черным ящиком», который выдает случайный код, а превращается в инструмент проектирования, где контракт фиксирует договоренности между модулями и становится основой для дальнейшей разработки.