L'IA agentique redéfinit la valeur des spécifications logicielles

La redécouverte de la spécification à l'ère de l'IA

Pendant des années, la spécification a été perçue comme une formalité fastidieuse dans le développement logiciel. En 2001, le manifeste agile a mis l'accent sur l'importance d'un "logiciel qui fonctionne" plutôt que sur une "documentation exhaustive". Cette approche a conduit à une pratique où la documentation est souvent reléguée à l'arrière-plan, rarement mise à jour ou relue. Tant que le code était écrit par des humains, cette négligence n'avait pas de conséquences majeures. Cependant, avec l'avènement des agents d'intelligence artificielle qui génèrent du code, cette approche pose désormais un problème significatif.

De l'intuition au développement structuré

Le développement d'applications a dépassé le cadre des développeurs traditionnels pour inclure les équipes métiers, séduites par les capacités de l'IA générative. Désormais, une grande partie du code est produite par des modèles de LLM. Pourtant, la manière dont ce code est généré reste souvent improvisée, avec des prompts non formalisés qui disparaissent à la fin de chaque session. En 2023, Andrej Karpathy a qualifié ce phénomène de "vibe coding", une approche intuitive sans intention clairement définie. Cela engendre une nouvelle forme de dette, la dette de compréhension, où le code fonctionne mais personne ne peut vraiment l'expliquer ou le maîtriser.

Si le "vibe coding" peut suffire pour un POC, il devient risqué à grande échelle. Les DSI l'ont bien compris, car les applications d'entreprise nécessitent une expertise et une maîtrise complètes. C'est ici qu'intervient l'Agentic Engineering, avec sa méthode phare, le Spec-Driven Development. Cette approche consiste à décrire précisément les attentes dans un document structuré et versionné, permettant ensuite aux agents de générer le code. Le code devient ainsi un artefact vérifiable, aligné sur l'intention initiale et potentiellement régénérable. Le véritable changement réside dans le déplacement de la réflexion d'ingénierie du code vers la spécification, garantissant un code compréhensible et maintenable par les humains.

Équilibre entre documentation et innovation

Il est crucial de ne pas confondre ce retour à la spécification avec un retour au cycle en V traditionnel ou une utopie où le code n'aurait plus besoin d'être édité. Les recherches récentes identifient trois niveaux de maturité dans ce domaine :

• spec-first : la spécification initie la génération du code, qui peut ensuite évoluer indépendamment.
• spec-anchored : spécification et code évoluent ensemble, avec des tests automatisés pour vérifier leur alignement.
• spec-as-source : un idéal où l'humain n'intervient que sur la spécification, jamais sur le code généré.

En pratique, le modèle "spec-anchored" est souvent le plus équilibré. Bien que rédiger une bonne spécification ne supprime pas les erreurs ou les dérives, cela permet de les réduire et de les gérer méthodiquement.

À l'ère de l'IA, une spécification n'est pas simplement un cahier des charges en prose. C'est un artefact semi-structuré, compréhensible par les humains et les agents, basé sur des règles métiers explicites et normalisées. Les critères d'acceptation adoptent un formalisme inspiré du Behavior-Driven Development, rendant la spécification presque directement transposable en cas de test.

Impact sur la chaîne de production

Ce changement de paradigme commence dès les premières étapes du développement. La structuration des éléments d'entrée devient un véritable travail d'ingénierie, organisé autour d'une série d'artefacts :

• un PRD (Product Requirements Document) qui fixe l'intention précise,
• des SPECS validées minutieusement par le business analyst,
• un PLAN d'implémentation validé par le développeur avec la même rigueur,
• des tests de bout en bout versionnés avant même que la première ligne de code ne soit générée.

Un changelog à jour est également essentiel, retraçant chaque évolution et garantissant la maintenabilité de l'application sur le long terme. Ce processus alimente un corpus contextuel incluant les règles d'architecture, les conventions et les décisions du projet, que les agents peuvent consulter via des protocoles standardisés.

Ce retour en grâce des spécifications redéfinit les rôles au sein des équipes. Le business analyst retrouve une position centrale, transformant les besoins métiers en exigences exploitables par les agents et garantissant que la formalisation reflète fidèlement les intentions métiers. Le client, quant à lui, ne se contente plus de valider les interfaces utilisateur, mais approuve également la source de vérité elle-même. Les critères d'acceptation et les tests de bout en bout sont validés en atelier, puis confrontés au logiciel à chaque fusion et livraison.

La spécification devient ainsi le contrat entre le métier, l'équipe et les agents, et la référence lorsque le comportement observé diverge de l'intention déclarée. Cette dérive, autrefois découverte lors des phases de recette, est désormais surveillée en continu grâce à des tests et des analyses statiques qui fournissent un verdict indépendant de l'humeur d'un modèle.

Un atout stratégique pour les DSI

Pourquoi ce sujet est-il crucial aujourd'hui ? Parce qu'un ensemble de spécifications versionnées et alignées sur le code modifie la position des DSI sur plusieurs fronts. La documentation cesse de tromper, car les tests la vérifient. L'auditabilité devient intrinsèque, en réponse aux exigences de traçabilité imposées par la réglementation européenne sur l'IA. La réversibilité redevient possible, tant vis-à-vis des prestataires que des outils. Ces spécifications serviront de base à la régénération, le jour où il faudra changer de framework ou d'architecture.

Bien que le code soit plus facile à produire que jamais, l'intention formalisée et qualifiée qui le guide est redevenue précieuse. À l'ère de l'IA agentique, la question cruciale n'est plus "qu'avons-nous codé ?", mais "qu'avons-nous spécifié ?". La qualité et la maintenabilité du code restent des exigences incontournables.