Desenvolvimento de Agentes e Desenvolvimento Orientado por Documentação: Quando a IA Escreve Contratos, Não Código
Um artigo descreve uma abordagem agêntica em que LLMs primeiro projetam contratos de sistema (OpenAPI, Proto, JSON Schema, CloudEvents, AsyncAPI) antes da geração de código. O método, chamado Desenvolvimento de Agentes Orientado por Documentação, usa múltiplos estágios de prompt para produzir e revisar contratos. O autor demonstra em um exemplo de serviço de central telefônica automática (PBX), distinguindo entre geradores e agentes.
O autor, Matvey Likhota, desenvolvedor sênior de Go, propõe uma abordagem de desenvolvimento em que um LLM primeiro projeta um sistema e produz contratos como OpenAPI, Proto, JSON Schema, CloudEvents e AsyncAPI, sendo o código gerado posteriormente por geradores repetíveis e as partes dependentes do projeto por desenvolvedores e agentes. Ele chama isso de Desenvolvimento Orientado por Documentação ou Desenvolvimento Orientado por Especificação. O artigo mostra o processo em um exemplo simples de serviço de PABX. O primeiro prompt pede ao LLM para listar questões arquiteturalmente significativas sem escrever código. O segundo prompt gera um contrato OpenAPI 3.1 com requisitos estritos, incluindo erros RFC 9457, Idempotency-Key, If-Match/ETag e paginação por cursor. Em seguida, um prompt de revisão adversarial critica o contrato em busca de defeitos. Para contratos de eventos, usa-se CloudEvents 1.0 com um catálogo de eventos como CallStarted, CallAnswered, CallMissed. Contratos WebSocket são descritos via AsyncAPI 3.0, e APIs internas são projetadas como gRPC com proto3. O artigo enfatiza a separação entre design de contratos e geração de código, e o uso de prompts de revisão para detectar inconsistências.
Fonte: Habr — хаб ИИ —
original