Qu’est-ce que ZeeSpec ?
ZeeSpec est la méthode de Vishal Mysore pour le développement guidé par les spécifications : 60 questions en six groupes (quoi, où, quand, qui, pourquoi, comment), dix par groupe, à traiter en une heure environ pour qu'un agent n'ait plus aucun comportement indéfini à deviner. Une petite CLI Node.js crée huit modèles Markdown dans un dossier .spec/, les assemble en AGENTS.md et copie le prompt dans le presse-papiers.
L'app de navigateur sur vishalmysore.github.io/zeespec/app a trois onglets. Spec Builder déroule les questions et peut rédiger AGENTS.md avec un modèle local en WebGPU. EPIC Score note une spec, un dépôt GitHub public ou un texte collé selon une version heuristique de la grille EPIC issue d'un article arXiv d'octobre 2026 : 40 pratiques réparties sur 10 dimensions, notées sur 30. SpecGuard recrée SpecGuardBench en miniature : 16 tâches JavaScript qui vérifient si le harnais de validation d'un modèle rejette une implémentation boguée tout en acceptant deux correctes. Le dépôt compte 14 commits et aucune release ; le dernier commit date du 16 novembre 2026.
ZeeSpec vaut-il le coup ?
L'idée utile ici, c'est l'onglet SpecGuard, pas la méthode. Il montre, dans un navigateur et sans GPU, l'échec documenté par un article intitulé SpecGuardBench : demandez à un modèle d'écrire des tests à partir d'une implémentation de référence et il reproduira la référence, bogues compris. Des trois références intégrées, recopier l'implémentation obtient 0 % de fidélité, rejouer le test existant 0 %, et seul un oracle écrit à la main atteint 100 %. Chaque harnais tourne dans un worker sans réseau et avec limite de temps, et on peut le modifier et le relancer. Comme démonstration de la raison pour laquelle les tests écrits par des agents valident des bogues, c'est plus clair que la plupart des textes sur le sujet.
L'onglet EPIC Score est plus modeste que son badge ne le laisse croire. C'est une réimplémentation heuristique de la grille de l'article, pas l'outil des auteurs, et l'app le dit ; le constat de l'article selon lequel les specs de la tranche haute consacraient 11,8 % des commits à des corrections de bogues, contre 20,4 % pour la tranche basse, est une corrélation sur 114 dépôts.
Les 60 questions sont de bonnes questions, celles que pose un responsable technique attentif : ce qui ne doit jamais être stocké, qui ne doit jamais agir, quand le système doit bloquer. La promesse d'une heure est nuancée par l'avertissement du projet lui-même.
Le hic : la commande d'installation du README, `npx spec-cli init`, récupère un paquet npm sans rapport nommé spec-cli, publié par un autre auteur en 2024 et pointant vers un autre dépôt ; ZeeSpec lui-même n'est pas sur npm. L'exécuter, c'est exécuter le code d'un inconnu. Clonez plutôt le dépôt et lancez bin/spec.js. Le projet compte 18 étoiles et 14 commits.
Notre avis : voyez ZeeSpec comme une feuille de travail et une démonstration de cours. Le Spec Kit de GitHub est l'outil de production pour le même travail.
Là où il fait la différence
Une responsable d'ingénierie qui anime un atelier interne sur les tests écrits par des agents
Montrer aux développeurs pourquoi des tests générés à partir du code ratent les bogues de ce code
Ouvrez l'onglet SpecGuard, activez le mode mirror trap et lancez en direct les trois références : l'oracle obtient 100 % de fidélité, les deux autres 0 %. Gratuit, rien à installer, et chaque harnais tourne isolé dans le navigateur.
Un développeur seul qui démarre une petite app de réservation avec Claude Code
Écrire une spec assez complète pour que l'agent cesse d'inventer des règles
Parcourez les 60 questions dans Spec Builder, exportez AGENTS.md, vérifiez-le dans l'onglet EPIC Score et collez son prompt de correction dans l'agent. Pour la CLI, clonez le dépôt au lieu d'utiliser npx.
Avant de vous engager
- Mise en route
- Ouvrez l'app web dans un navigateur compatible WebGPU pour le modèle local, ou clonez le dépôt et lancez `node bin/spec.js init`. N'exécutez pas `npx spec-cli` : ce nom sur npm appartient à un paquet sans rapport.
- Intégrations
- Produit un AGENTS.md pour tout agent qui le lit ; EPIC Score lit les structures Spec Kit, Kiro, ZeeSpec et AGENTS.md des dépôts GitHub publics ; WebLLM pour le modèle local facultatif.
- Données et confidentialité
- L'app affirme que rien ne quitte votre navigateur ; le téléchargement du modèle et la lecture des dépôts GitHub sont le seul trafic réseau. Les harnais SpecGuard tournent dans des workers sans réseau. Licence MIT.
- Limites
- SpecGuard compte 16 tâches JavaScript contre les 291 tâches Python de l'article, les scores ne sont donc pas comparables ; la notation EPIC est heuristique ; ni paquet npm ni release taguée.
Les points forts
- SpecGuard montre clairement l'échec des tests en miroir
- App de navigateur locale, avec workers de test sans réseau
- 60 questions concrètes qui révèlent les comportements indéfinis
- Honnête sur la notation heuristique et ses limites
Les points faibles
- La commande npx du README installe un paquet npm sans rapport
- Le score EPIC est une heuristique, pas l'outil de l'article
- Projet minuscule : 18 étoiles, 14 commits, aucune release
- Téléchargement du modèle local d'environ 1 à 2 Go
Idéal pour
Responsables techniques et enseignants qui veulent une liste de contrôle structurée pour les specs et une démonstration parlante de la façon dont les agents écrivent des tests qui laissent passer des bogues.
Alternatives à ZeeSpec
ZeeSpec : questions fréquentes
- ZeeSpec vaut-il le coup ?
- Les questions de ZeeSpec forment une liste de contrôle solide et son onglet SpecGuard est un petit outil pédagogique très affûté, mais la ligne d'installation de la CLI pointe vers le paquet de quelqu'un d'autre. Nous lui donnons 3.3 sur 5.
- Combien coûte ZeeSpec ?
- Gratuit et open source (MIT). L'app web tourne dans votre navigateur ; son modèle local facultatif se télécharge une fois, environ 1 à 2 Go.
- Quels sont les inconvénients de ZeeSpec ?
- La commande npx du README installe un paquet npm sans rapport; le score EPIC est une heuristique, pas l'outil de l'article; projet minuscule : 18 étoiles, 14 commits, aucune release; téléchargement du modèle local d'environ 1 à 2 Go.
- À qui s’adresse ZeeSpec ?
- Responsables techniques et enseignants qui veulent une liste de contrôle structurée pour les specs et une démonstration parlante de la façon dont les agents écrivent des tests qui laissent passer des bogues.
- ZeeSpec est-il sûr pour les données de l’entreprise ?
- L'app affirme que rien ne quitte votre navigateur ; le téléchargement du modèle et la lecture des dépôts GitHub sont le seul trafic réseau. Les harnais SpecGuard tournent dans des workers sans réseau. Licence MIT.
- Quelles sont les meilleures alternatives à ZeeSpec ?
- Les alternatives les plus proches que nous avons testées sont Spec Kit et Agent Skills (Addy Osmani).
Réponses vérifiées le 21 nov. 2026.