Développement d'agents et développement piloté par la documentation : quand l'IA rédige des contrats, pas du code
Un article décrit une approche agentique où les grands modèles de langage conçoivent d'abord les contrats système (OpenAPI, Proto, JSON Schema, CloudEvents, AsyncAPI) avant la génération de code. Cette méthode, appelée développement d'agents piloté par la documentation, utilise plusieurs étapes de prompts pour produire et réviser les contrats. L'auteur la démontre sur l'exemple d'un service de standard téléphonique automatique (PBX), en distinguant les générateurs des agents.
L'auteur, Matvey Likhota, développeur Go senior, propose une approche de développement où un LLM conçoit d'abord un système et produit des contrats tels que OpenAPI, Proto, JSON Schema, CloudEvents et AsyncAPI, le code étant généré ensuite par des générateurs répétables et les parties dépendantes du projet par des développeurs et des agents. Il appelle cela le développement piloté par la documentation ou le développement piloté par les spécifications. L'article montre le processus sur un exemple simple de service PBX. La première invite demande au LLM de lister les questions architecturalement significatives sans écrire de code. La deuxième invite génère un contrat OpenAPI 3.1 avec des exigences strictes incluant les erreurs RFC 9457, Idempotency-Key, If-Match/ETag et la pagination par curseur. Ensuite, une invite de revue antagoniste critique le contrat pour détecter des défauts. Pour les contrats d'événements, CloudEvents 1.0 est utilisé avec un catalogue d'événements comme CallStarted, CallAnswered, CallMissed. Les contrats WebSocket sont décrits via AsyncAPI 3.0, et les API internes sont conçues comme gRPC avec proto3. L'article souligne la séparation entre la conception des contrats et la génération de code, et l'utilisation d'invites de revue pour détecter les incohérences.
Source: Habr — хаб ИИ —
original