Contrato Primeiro como Proteção Contra Agentes de LLM: API Primeiro Retorna para Manter Frontend e Backend Alinhados
Moonshot AI
O autor descreve o problema de degradação do projeto ao usar agentes de modelo de linguagem de grande porte (LLM) para desenvolvimento: os agentes frequentemente ignoram os contratos reais entre frontend e backend, criando dados fictícios e levando a erros em tempo de execução. A solução é retornar à abordagem de contrato primeiro, onde a especificação OpenAPI é o artefato principal, a partir do qual interfaces de servidor e clientes são gerados, tornando qualquer desvio do contrato um erro de compilação.
O autor encontrou em dois projetos paralelos que os agentes de LLM frequentemente divergem em contratos ao desenvolver frontend e backend: o agente de frontend tipa respostas como Record<string, unknown>, usa objetos soltos ou nós JSON, duplica DTOs com nomes de campos diferentes e, às vezes, até simula um backend inexistente com dados locais e toasts. Nenhum desses erros é capturado pelo compilador, linter ou testes arquiteturais, porque os analisadores não veem as requisições HTTP entre os codebases. A solução é contract-first: a fonte única de verdade é o spec OpenAPI (YAML), a partir do qual as interfaces do servidor (com as opções interfaceOnly e skipDefaultInterface) e um cliente são gerados no momento da construção. O controller implementa a interface gerada, garantindo a correspondência de assinatura—qualquer desvio do contrato se torna um erro de compilação. O autor observa que essa abordagem já é usada em gRPC e GraphQL e está retornando ao REST, já que o leitor de contratos agora não é um humano, mas um agente de LLM, que não recupera intenções e segue o caminho mais barato de adivinhar.
Fonte: Habr — хаб ИИ —
original