Aller au contenu
Cabinet d'expertise en transformation technologique · ARDIANE Group Innover, sécuriser, réussir

Ingénierie

Mettre en œuvre le spec driven development avec un assistant de code, et savoir quoi relire

L'essentiel

Le spec driven development, ou développement piloté par les spécifications, consiste à faire rédiger puis relire une spécification, un plan technique et une liste de tâches avant qu'un assistant de code n'écrive le code. Management Square décrit ici les étapes de cette méthode dans l'ordre, avec le livrable de chacune et la relecture qu'il appelle, d'après des sources publiques lues le 12 novembre 2026.

Sommaire de la page

Le spec driven development, ou développement piloté par les spécifications, est une expression d’usage récent : elle désigne une manière de travailler avec un assistant de code dans laquelle on rédige et on relit d’abord un texte qui décrit ce qu’il faut construire, puis un plan technique et une liste de tâches, avant de laisser l’assistant écrire le code.

L’approche se déroule en étapes : l’intention, la spécification, le plan technique, le découpage en tâches, la réalisation, la vérification. Chacune livre un texte ou du code, rangé dans le dépôt, qu’une personne relit avant de passer à la suivante. Ce découpage est notre lecture de deux outillages publics, consultés le 12 novembre 2026. Les contours du terme bougent encore ; aucun outil n’est recommandé ici et aucun gain n’est promis.

Une expression récente, portée par des outillages qui diffèrent

Deux sources d’origine donnent une idée de ce que le terme recouvre.

Spec Kit, publié par GitHub sous licence MIT (github.com/github/spec-kit), se présente comme une boîte à outils en code ouvert qui fournit aux agents de programmation des processus structurés, des gabarits réutilisables et des résultats documentés (notre traduction de « structured processes, reusable templates, and documented outcomes »). Son parcours minimal enchaîne des commandes : une « constitution » rédigée une fois par projet, qui fixe les principes à respecter, puis, pour chaque fonctionnalité, specify, plan, tasks, implement et converge. Son document de méthode place le code au service de la spécification, position propre à ses auteurs.

Kiro (kiro.dev), dont le site porte la mention d’Amazon Web Services, appelle specs des artefacts structurés qui formalisent le développement d’une fonctionnalité ou la correction d’une anomalie. Chaque spec repose sur trois fichiers : requirements.md (récits utilisateur et critères d’acceptation ; bugfix.md pour une anomalie), design.md (architecture, diagrammes de séquence, gestion des erreurs, stratégie de test) et tasks.md (tâches distinctes, suivies une à une). Sa documentation propose deux variantes, selon que l’on part des exigences ou de la conception.

Les deux outillages ne découpent donc pas le travail de la même façon.

Les étapes du spec driven development, dans l’ordre

Étape Ce qu’elle livre Ce que la personne relit
Intention Quelques phrases : le résultat attendu, pour qui, ce qui reste hors périmètre Que le besoin est bien le sien, avant toute rédaction par l’assistant
Spécification Des exigences et des critères d’acceptation, sans choix technique Chaque exigence, les cas oubliés, les questions restées ouvertes
Plan technique Les choix de conception : modules, modèle de données, interfaces, tests prévus La conformité au cadre d’architecture et les décisions coûteuses à défaire
Découpage en tâches Une liste ordonnée de tâches, avec leurs dépendances L’ordre, la taille de chaque tâche, le moyen de la vérifier
Réalisation Le code et ses tests, une tâche après l’autre Chaque modification, en revue de code
Vérification Un relevé des écarts entre le code, la spécification et le plan Les écarts, et le résultat des critères d’acceptation rejoués

Une relecture qui ne laisse aucune trace (une question, une correction, un refus) peut indiquer que le texte a été approuvé sans être lu.

L’intention et la spécification reviennent au métier

L’intention s’écrit à la main, en quelques phrases. Elle dit ce qui devra être vrai une fois le travail terminé et ce qui ne doit pas changer. Elle revient à la personne qui arbitre le produit, par exemple le product owner dans une équipe Scrum. Savoir si la fonctionnalité mérite d’être construite est la question d’un MVP produit, à trancher avant.

L’assistant rédige ensuite la spécification à partir de cette intention. Dans Kiro, les exigences suivent la notation EARS (Easy Approach to Requirements Syntax), sur le patron « WHEN [condition] THE SYSTEM SHALL [comportement attendu] ». Spec Kit ajoute deux commandes facultatives : clarify, pour lever les ambiguïtés, et checklist, qui produit une liste de contrôle de la qualité des exigences, confiée au relecteur par sa documentation.

Un modèle produit sans effort un texte complet en apparence : la personne du métier relit donc d’abord ce qui manque, comme le cas d’erreur, la règle de gestion restée implicite ou la limite de volume.

Le plan technique et les tâches engagent l’architecture

Le plan traduit la spécification en choix de conception. Dans Spec Kit, la commande plan reçoit les choix techniques de l’équipe et produit un plan avec des documents annexes (modèle de données, contrats d’interface), en contrôlant leur conformité à la constitution du projet. Dans Kiro, le fichier design.md tient ce rôle.

Un développeur expérimenté ou un architecte y cherche les décisions coûteuses à défaire : découpage en modules, modèle de données, échanges avec les applications voisines. Celles qui engagent au-delà de la fonctionnalité gagnent à être consignées dans un architecture decision record, où l’on cherchera plus tard la raison d’un choix.

Le découpage en tâches se relit sur l’ordre, la taille et le moyen de vérifier chaque tâche. Les deux outils repèrent les tâches indépendantes pour qu’elles s’exécutent en parallèle ; dès que plusieurs agents travaillent en même temps, les questions de coordination de notre article sur l’orchestration d’agents IA se posent.

La réalisation et la vérification restent soumises à la revue et aux tests

L’assistant exécute les tâches dans l’ordre de leurs dépendances. Ce qu’il produit entre dans le dépôt par le même chemin que le reste : contrôles automatiques, puis relecture par une autre personne, selon notre article sur la revue de code. Un assistant qui exécute des commandes et modifie des fichiers agit comme un agent ; ses droits se bornent comme l’explique notre article sur la sécurité des agents IA.

La vérification compare le résultat à ce qui était demandé. Spec Kit prévoit une commande, converge, qui confronte le code à la spécification, au plan et aux tâches, puis ajoute des tâches si elle trouve des écarts. Ce contrôle, mené par un assistant, ne remplace pas des tests tirés des critères d’acceptation par quelqu’un qui en connaît l’intention. Notre article sur les tests automatisés aide à choisir le niveau de chaque vérification, et notre page qualité logicielle et tests rappelle la limite d’un test tiré du code qu’il doit contrôler.

Ni cahier des charges, ni BDD, ni usage libre d’un assistant

Le cahier des charges décrit le besoin d’une application entière et se valide entre des parties, avant l’engagement d’un projet : notre article sur le cahier des charges d’une application en détaille le contenu. La spécification dont il s’agit ici porte sur une fonctionnalité, vit dans le dépôt et se relit à chaque étape.

Le behavior driven development repose sur une conversation à trois voix (métier, développement, test) qui décrit le comportement attendu par des exemples. Ses scénarios peuvent servir de critères d’acceptation dans une spécification ; la conversation, elle, ne se délègue pas à un assistant.

L’usage libre d’un assistant va de la demande au code sans texte intermédiaire. Il convient à une modification que l’on contrôle sur-le-champ. Les règles à poser avant de généraliser un assistant, avec ou sans spécifications, sont celles de notre article sur le développement assisté par IA. À l’autre extrémité, un cadre plus structuré répartit ces étapes entre des agents spécialisés par rôle : notre article sur la méthode BMAD le présente.

Pour un premier essai, nous proposons de retenir une fonctionnalité bornée, de nommer avant de commencer le relecteur de la spécification, du plan et des tâches, puis de noter ce que chaque relecture a changé. La conduite d’un tel projet, du cadrage à la mise en production, relève de notre page développement sur mesure.

Insights

À lire sur le sujet

Tous les insights
Dresser une feuille de route de modernisation des applications pour un parc entier

Une feuille de route de modernisation des applications attribue à chaque application d'un parc une voie de traitement, un rang et un point de décision, puis range ces lignes selon les dépendances et la capacité disponible. Management Square propose ici une méthode en six temps pour l'établir, du relevé du parc à la règle de révision, et indique le résultat tangible de chaque temps.

Lire l'analyse
REST, GraphQL, gRPC ou événements : comparer les styles pour bâtir une architecture API

L'architecture API désigne ici les choix par lesquels un système d'information expose ses fonctions et ses données à d'autres logiciels : style de chaque interface, forme du contrat, règles d'évolution et de sécurité. Management Square compare REST, GraphQL, gRPC et les API pilotées par événements, puis décrit ce qu'une stratégie d'API fixe à l'échelle du système d'information.

Lire l'analyse
Reconnaître l'obsolescence applicative à ses signes, avant l'échéance subie

L'obsolescence applicative désigne le vieillissement des composants d'une application qui rend toujours son service ; Management Square étend ici le mot, par choix, à la connaissance de l'application et à sa capacité à évoluer. L'article en décrit les signes observables, couche après couche, avec le risque que chacun peut indiquer et la manière d'y répondre.

Lire l'analyse

FAQ

Questions fréquentes

Une autre question ? Posez-la-nous

Que signifie spec driven development ?

L'expression se traduit par développement piloté par les spécifications. Elle désigne une façon de travailler avec un assistant de code où un texte relu, la spécification, précède le plan technique, les tâches puis le code. Le terme est récent et ses contours varient d'un outil à l'autre : il ne renvoie ni à une norme ni à un référentiel unique.

Quels outils servent à pratiquer le spec driven development ?

Parmi les outillages publics lus le 12 novembre 2026 figurent Spec Kit, boîte à outils en code ouvert publiée par GitHub sous licence MIT, et Kiro, dont la documentation décrit des specs en trois fichiers : exigences, conception et tâches. Ils ne découpent pas le travail de la même façon et évoluent vite. Les citer ne vaut pas recommandation : le choix dépend de l'assistant déjà en place et des règles de l'équipe.

Le spec driven development remplace-t-il un cahier des charges ?

Non. Le cahier des charges décrit le besoin d'une application entière et se valide entre des parties avant l'engagement d'un projet. La spécification du spec driven development porte sur une fonctionnalité, se range dans le dépôt avec le code et se relit à chaque étape. La seconde peut découler du premier, sans en tenir lieu.

Faut-il rédiger une spécification pour chaque modification du code ?

Non. Une correction qu'un coup d'œil suffit à contrôler peut se passer de texte intermédiaire, et la documentation de Kiro juge elle-même ses specs de fonctionnalité peu adaptées au code exploratoire sans objectif clair. La spécification se justifie lorsque la fonctionnalité compte plusieurs tâches, engage des choix de conception ou doit être comprise par d'autres personnes que son auteur.

Un projet à faire aboutir ?

Un premier échange suffit pour situer votre enjeu, identifier les bons interlocuteurs et vous dire franchement ce que nous pouvons apporter.