Claude Code · 9 min · 2026-08-15 · Par Équipe MaitriseLIA

Spec Kit : la méthode de GitHub pour coder avec une IA sans improviser, testée sur un vrai bug

Spec Kit, l’outil open source de GitHub, oblige un agent de code à travailler à partir d’une spécification plutôt qu’à l’improvisation. Depuis l’été, il est passé en version 1, gère 43 agents et propose aussi un parcours de correction de bug et un autre d’évaluation d’idée. Nous l’avons installé et lui avons confié un vrai bug.

Spec Kit : définir une spécification claire avant de coder avec un agent IA
Crédit photo : Unsplash

L’essentiel en une minute (article mis à jour le 24 octobre 2026)

  • Ce que c’est : un outil open source de GitHub (licence MIT, plus de 142 000 étoiles) qui fait travailler un agent de code à partir d’une spécification écrite d’abord, plutôt qu’à l’improvisation.
  • Avec quels agents : 43 aujourd’hui, dont Claude Code, GitHub Copilot, Codex, Cursor, Gemini CLI et Mistral Vibe.
  • Ce qui a changé depuis août : la version 1.0, un parcours de correction de bug avec verdict de vérification, un parcours d’évaluation d’idée, et des catalogues de modules.
  • Notre test : un vrai bug de calcul diagnostiqué, corrigé et vérifié en 1 minute 44, avec trois rapports écrits et un verdict justifié.
  • Notre verdict : à tester, sur une vraie fonctionnalité ou un bug qui compte.

Coder avec un agent IA en lui décrivant vaguement ce qu’on veut fonctionne bien pour un prototype. Sur un vrai projet, l’agent oublie des contraintes, réinvente ce qui existe et part dans des directions que personne n’a validées. Spec Kit propose l’inverse : écrire d’abord ce qu’on veut construire, puis laisser l’agent construire à partir de ce document.

Mise à jour du 24 octobre : ce qui a changé

Quand nous avons publié cet article le 15 août, Spec Kit était en version 0.16 et comptait environ 128 000 étoiles. Il en a aujourd’hui plus de 142 000, et 23 versions sont sorties depuis.

  • La version 1.0 est sortie le 21 août. Sa note de version reprend un billet qui défend une position inhabituelle : un numéro de version ne garantirait plus la stabilité, puisqu’un agent peut désormais adapter le code à un changement incompatible en quelques minutes. Autrement dit, attendez-vous encore à des changements de format.
  • Trois parcours au lieu d’un. Depuis septembre, la page d’accueil propose de choisir : la méthode de spécification (toujours au cœur), la correction de bug et l’évaluation d’idée. Les deux derniers s’installent à part et ne demandent pas de suivre la méthode complète.
  • Des catalogues de modules. Extensions, modèles personnalisés, enchaînements automatiques et packs par métier existaient déjà en août ; nous ne les avions pas mentionnés. La documentation détaille désormais les catalogues privés, réservés à une entreprise, et l’usage hors ligne.
  • 43 agents pris en charge, contre « plus de 30 » en août.

La méthode, en six commandes

Une fois Spec Kit installé dans un projet, vous pilotez votre agent avec des commandes dédiées :

  1. Constitution : les principes et règles du projet (technologies, conventions, contraintes).
  2. Specify : ce que vous voulez construire, sous forme de besoins et de scénarios d’usage. Le quoi, pas le comment.
  3. Plan : la stratégie technique proposée par l’agent.
  4. Tasks : le découpage en tâches.
  5. Implement : la réalisation.
  6. Converge : la vérification que le code correspond à la spécification ; les écarts deviennent de nouvelles tâches, jusqu’à convergence.

Trois commandes facultatives aident en chemin : clarifier les zones floues avant le plan, vérifier la cohérence entre les documents avant la réalisation, produire des listes de contrôle.

Notre test : un vrai bug, le parcours de correction

Nous avons créé un petit projet Python de calcul de devis, avec un bug réel : une remise de 10 % donnait un total de moins 2 160 euros au lieu de 216 euros, parce que le code traitait le pourcentage comme une fraction. Nous avons installé Spec Kit pour Claude Code, ajouté l’extension de correction de bug, puis confié le bug à un agent Claude qui a suivi les trois commandes de l’extension.

Le diagnostic. La première commande a reproduit le bug, localisé la ligne fautive et classé le problème en gravité haute. Son rapport donne la cause, le correctif proposé et deux questions ouvertes : faut-il refuser une remise hors de 0 à 100 %, et d’autres programmes passent-ils déjà la remise sous forme de fraction ? Ce sont les questions qu’un développeur expérimenté poserait.

Le correctif. La deuxième commande a modifié une seule ligne et ajouté deux tests : la remise de 10 %, et une remise de 100 % qui doit donner zéro.

La vérification. La troisième commande a conclu « vérifié », preuves à l’appui : la reproduction donne maintenant 216 euros et tous les tests passent. Nous avons refait le contrôle de notre côté : les deux nouveaux tests échouent bien sur l’ancien code et passent sur le nouveau.

L’ensemble a pris 1 minute 44 secondes et laissé trois rapports dans le dossier du projet. Le cas reste simple ; sur un vrai projet, le diagnostic serait plus long et les questions ouvertes plus lourdes.

Les défauts relevés en chemin. La commande de correctif ne demande pas d’écrire un test qui échoue avant de corriger : l’agent l’a fait de lui-même, mais rien ne l’y obligeait. La commande de vérification n’a pas le droit de toucher au code, si bien que l’agent a dû exécuter l’ancienne version à part pour prouver que les tests détectaient le bug. Enfin, les modèles de rapport sont en anglais, et rien n’indique s’il faut enregistrer le correctif dans l’historique du projet.

Ce qu’il faut savoir avant de l’adopter

  • Le temps d’installation est négligeable : quelques secondes pour préparer un projet. Le vrai coût est ailleurs : treize fichiers d’instructions, soit environ 170 000 caractères, que votre agent lit au fil des commandes.
  • La méthode complète reste lourde pour une petite correction. Le parcours de bug répond en partie à ce reproche : il ne demande ni spécification ni plan.
  • La version 1 n’est pas un gage de stabilité, sa propre note de version le dit. Fixez une version pour un usage en équipe.
  • Les catalogues communautaires ne sont pas audités. Une extension s’exécute dans votre projet, avec votre agent : lisez son code avant de l’installer, comme le recommande la documentation.
  • Une spécification floue donne un code à côté. L’outil structure le travail, il ne remplace pas la clarté de ce que vous demandez.

Pour qui

  • Une fonctionnalité qui compte ou un projet qui démarre : la spécification évite les dérives et le code jetable.
  • Une équipe : la spécification devient le document de référence que tout le monde peut relire.
  • Un bug qui revient ou qui coûte cher : le parcours de correction laisse une trace écrite de la cause, du correctif et de sa vérification.

Pour une correction d’une ligne ou un script personnel, il n’apporte rien.

Notre verdict : à tester

Spec Kit formalise une discipline que les bons développeurs appliquaient déjà : décider avant de construire, et vérifier après. Depuis l’été, il est devenu plus large, avec des parcours plus légers que la méthode complète. Essayez-le sur votre prochaine fonctionnalité sérieuse ou sur un bug qui vous a déjà coûté du temps, en fixant la version utilisée et en lisant le code des extensions communautaires avant de les ajouter.

Sources

  1. Spec Kit, dépôt GitHub (github/spec-kit)
  2. Spec Kit, documentation officielle
  3. Spec Kit, note de version 1.0.0 (21 août 2026)

À propos de l'auteur

Équipe MaitriseLIA

Experts en formation Claude Code, Anthropic API et outils d'IA professionnels. Nos contenus sont rédigés par des spécialistes qui utilisent Claude Code et les MCPs au quotidien pour automatiser leurs business.