Desarrollo de Agentes y Desarrollo Dirigido por Documentación: Cuando la IA Escribe Contratos, no Código
Un artículo describe un enfoque agéntico donde los modelos de lenguaje de gran tamaño (LLM) primero diseñan contratos de sistema (OpenAPI, Proto, JSON Schema, CloudEvents, AsyncAPI) antes de la generación de código. El método, llamado Desarrollo Dirigido por Documentación para Agentes, utiliza múltiples etapas de prompts para producir y revisar contratos. El autor lo demuestra en un ejemplo de servicio de central telefónica automática (PBX), distinguiendo entre generadores y agentes.
El autor, Matvey Likhota, un desarrollador senior de Go, propone un enfoque de desarrollo en el que un LLM primero diseña un sistema y produce contratos como OpenAPI, Proto, JSON Schema, CloudEvents y AsyncAPI, y el código se genera posteriormente mediante generadores repetibles y las partes dependientes del proyecto las desarrollan desarrolladores y agentes. Él lo llama Desarrollo Dirigido por Documentación o Desarrollo Dirigido por Especificaciones. El artículo muestra el proceso en un ejemplo de un servicio PBX simple. El primer prompt pide al LLM que enumere preguntas arquitectónicamente significativas sin escribir código. El segundo prompt genera un contrato OpenAPI 3.1 con requisitos estrictos que incluyen errores RFC 9457, Idempotency-Key, If-Match/ETag y paginación por cursor. Luego, un prompt de revisión adversaria critica el contrato en busca de defectos. Para los contratos de eventos, se utiliza CloudEvents 1.0 con un catálogo de eventos como CallStarted, CallAnswered, CallMissed. Los contratos WebSocket se describen mediante AsyncAPI 3.0, y las API internas se diseñan como gRPC con proto3. El artículo enfatiza la separación del diseño de contratos de la generación de código y el uso de prompts de revisión para detectar inconsistencias.
Fuente: Habr — хаб ИИ —
original