Contract-First comme protection contre les agents LLM : l'approche API-First revient pour aligner frontend et backend
Moonshot AI
L'auteur décrit le problème de dégradation des projets lors de l'utilisation d'agents LLM pour le développement : les agents ignorent souvent les contrats réels entre le frontend et le backend, créent des données factices et entraînent des erreurs d'exécution. La solution est de revenir à l'approche contract-first, où la spécification OpenAPI est l'artefact principal à partir duquel les interfaces serveur et les clients sont générés, faisant de tout écart par rapport au contrat une erreur de compilation.
L'auteur a constaté sur deux projets parallèles que les agents LLM divergent souvent dans les contrats lorsqu'ils développent le frontend et le backend : l'agent frontend type les réponses comme Record<string, unknown>, utilise des objets flous ou des nœuds JSON, duplique les DTO avec des noms de champs différents, et simule parfois un backend inexistant avec des données locales et des toasts. Aucune de ces erreurs n'est détectée par le compilateur, le linter ou les tests d'architecture, car les analyseurs ne voient pas les requêtes HTTP entre les bases de code. La solution est de privilégier le contrat d'abord : la source de vérité unique est la spécification OpenAPI (YAML), à partir de laquelle les interfaces serveur (avec les options interfaceOnly et skipDefaultInterface) et un client sont générés au moment de la compilation. Le contrôleur implémente l'interface générée, ce qui garantit la correspondance des signatures — tout écart par rapport au contrat devient une erreur de compilation. L'auteur note que cette approche est déjà utilisée dans gRPC et GraphQL et revient à REST, car le lecteur de contrat n'est désormais plus un humain mais un agent LLM, qui ne reconstitue pas les intentions et prend le chemin facile de deviner.
Source: Habr — хаб ИИ —
original