Spec-driven development : définition et usage par un PM
Le spec-driven development est une manière de développer avec des agents de code où la spécification écrite devient la source de vérité du travail. On décrit d'abord l'intention, le comportement attendu et les preuves qui diront que c'est terminé ; l'agent en tire ensuite un plan et des tâches avant d'écrire le code. La spec reste dans le dépôt et évolue avec le produit, au lieu d'être oubliée après le lancement.
Définition rédigée par Alex Dionisio, Senior Product Manager. Mis à jour le 13 novembre 2026.
Pourquoi c’est important pour un PM
Un agent de code exécute vite ce qu'on lui demande, y compris une demande floue. Plus la génération de code devient rapide, plus la qualité de la spec pèse sur le résultat. Le PM, qui porte l'intention et les règles métier, retrouve ainsi une place centrale : une spec précise réduit les allers-retours, rend la relecture du plan possible et fournit des critères pour décider si le résultat est terminé.
Exemple
Pour une fonction d'export de factures, le PM rédige un fichier de spec : le problème utilisateur, les formats demandés, les cas où l'export doit être refusé, et une liste de critères vérifiables. L'agent propose un plan en six tâches. Le PM repère qu'il a oublié les factures annulées, corrige la spec, puis l'agent régénère le plan avant de toucher au code.
Comment se déroule un cycle spec-driven ?
Le cycle avance par étapes que l'on valide une à une. On écrit d'abord ce que la fonctionnalité doit faire et pour qui, avec ses critères d'acceptation. L'agent en déduit un plan technique : composants touchés, données, dépendances. Ce plan est ensuite découpé en tâches courtes, que l'agent exécute dans l'ordre en vérifiant chacune. À chaque étape, un humain relit avant que l'étape d'après ne commence, ce qui coûte bien moins cher que de corriger du code déjà écrit.
Les outils publics reprennent ce schéma avec leur propre vocabulaire. Spec Kit, publié en open source par GitHub, enchaîne des commandes pour spécifier, planifier, découper en tâches puis implémenter, et s'appuie sur un document de principes du projet. Kiro, l'environnement d'AWS, produit trois fichiers : les exigences, la conception et la liste des tâches. Rien n'empêche toutefois une équipe d'appliquer la démarche avec de simples fichiers Markdown et l'agent de son choix.
Pour un PM, le moment le plus utile est la relecture du plan. On y repère une règle métier oubliée, un périmètre qui a grossi en silence ou un choix technique qui contraindra la feuille de route, avant que le moindre fichier ne change. Cette relecture prend quelques minutes, alors que défaire la même erreur dans du code terminé peut prendre des jours.
Spec-driven development, PRD et TDD : quelles différences ?
Un PRD s'adresse d'abord à des humains : il justifie un investissement, fixe un périmètre et aligne les équipes. Une spec destinée à un agent va plus loin dans le détail vérifiable : comportements attendus cas par cas, contraintes techniques, exemples de données, définition du terminé. Les deux se complètent, et une partie du PRD peut alimenter directement la spec.
Le développement piloté par les tests (TDD) se situe à un autre niveau : il consiste à écrire un test qui échoue avant le code qui le fait passer. Il s'accorde bien avec le spec-driven development, puisque les critères d'acceptation de la spec se traduisent naturellement en tests. L'opposé de la démarche serait plutôt le vibe coding, où l'on enchaîne les demandes conversationnelles sans document de référence : efficace pour un prototype jetable, risqué pour un produit qui doit durer.
Quand l'approche vaut-elle l'effort ?
Elle paie sur les fonctionnalités riches en règles métier, sur les projets où plusieurs personnes et plusieurs agents interviennent, et partout où il faudra expliquer plus tard pourquoi le système se comporte ainsi. Pour une correction d'une ligne ou un prototype destiné à être jeté, elle ajoute surtout de la cérémonie.
Quelques questions aident à démarrer : qui écrit la spec et qui la valide ? Où est-elle rangée, et comment sait-on qu'elle correspond encore au code ? Que fait l'agent quand la spec est muette sur un cas : il s'arrête pour demander, ou il choisit seul ? Gardez aussi en tête la limite principale : une spec ne garantit rien par elle-même, et rien n'empêche l'agent de dériver. La relecture du code et les tests restent la preuve finale.
Points clés
- La spec décrit le quoi et le pourquoi ; l'agent propose le comment, que l'équipe relit avant exécution.
- Des critères d'acceptation vérifiables permettent à l'agent et aux humains de juger le résultat de la même façon.
- Des outils publics outillent cette approche, par exemple Spec Kit de GitHub ou l'environnement Kiro d'AWS.
- Une spec qui n'est plus à jour devient un piège : elle doit changer en même temps que le code.
Erreurs fréquentes
- Rédiger une spec très longue que personne ne relit, au lieu d'une spec courte et vérifiable.
- Laisser l'agent inventer les règles métier absentes de la spec sans les faire valider.
- Croire que la spec dispense de relire le code et de tester le comportement réel.
Pour aller plus loin dans Module
Les formations et les leçons qui traitent cette notion :
Guides sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
- Claude Code pour Product Manager
Ce qu’un PM peut faire avec Claude Code, la méthode et les garde-fous, avec un CLAUDE.md de départ.