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.