Questions que les réviseurs ont réellement posées.

spec-kit est une méthodologie — un processus pour rédiger des spécifications.SpecScore est un format de stockage pour les spécifications que vous écrivez, assorti d'un CLI pour les interroger et les modifier. Les deux se complètent : spec-kit peut produire des fichiers SpecScore, et une extension spec-kit écrivant au format SpecScore est déjà en préparation.

Choisissez spec-kit quand vous avez besoin d'un processus. Choisissez SpecScore quand vous avez besoin de spécifications que les agents d'IA peuvent linter, interroger et faire évoluer sans lire chaque fichier du dépôt. Utilisez les deux quand vous voulez les deux.

L'esprit est similaire. Toutes trois sont des bibliothèques de skills qui guident les agents d'IA à travers ideate → specify → plan → implement. La différence est d'ordre mécanique, non philosophique.

SpecStudio Skills écrit ses artefacts au format SpecScore (une structure définie en Markdown + YAML) et fait appel au CLI specscore pour les requêtes, le linting et les transitions d'état. Superpowers et agent-skills, pour la plupart, lisent et écrivent directement des fichiers depuis la prose de la skill.

Choisissez SpecStudio Skills quand la consommation de tokens compte — le CLI renvoie une réponse structurée à « toutes les Features ouvertes avec des questions en suspens » en un seul appel, tandis qu'une skill basée sur des fichiers lit N documents pour répondre à la même chose.

Les skills peuvent lire et écrire des fichiers. Elles ne peuvent pas, de manière fiable :

• garantir l'intégrité référentielle à travers l'arbre de spécifications (que les liens soient résolus, les identifiants uniques, les index synchronisés) ;
• renvoyer une liste filtrée de « Features ouvertes avec questions sans réponse » sans lire chaque fichier ;
• modifier le bon champ d'état au bon moment sur chaque artefact.

Le CLI offre aux agents un appel propre par tâche — de la même façon que jq vous donne un appel propre pour interroger du JSON. Les skills seules consomment plus de tokens, divergent plus souvent et oublient de mettre à jour l'index.

« Score » se lit de deux façons, et les deux sont intentionnelles.

Partition. Une partition structurée d'exigences — tout comme une partition musicale organise les parties, les voix et les mesures. Ouvrez un arbre SpecScore et vous devriez pouvoir le lire comme un chef d'orchestre lit une partition : hiérarchie, sections, références, tout visible en même temps.

Une note de qualité au sens propre. Le linter du CLI est la note déterministe (la structure de la spécification tient-elle la route ?). La skill /scoreest la note évaluée par l'IA — une note de maturité de A à F par artefact, avec un feedback par axe pour l'auteur. La partie « Score » du nom devient une fonctionnalité produite par l'outil, pas seulement une aspiration.

Un comparatif mesuré côte à côte est en cours et sera publié avant l'article sur Habr — la même tâche (« sur quoi devrais-je travailler ensuite ? »), exécutée deux fois : une fois avec un agent sans CLI lisant des documents, une autre avec le même agent appelant le CLI de SpecScore. Comptage des tokens et délai de réponse pour les deux cas.

En attendant la publication de ces chiffres, l'affirmation est structurelle : un agent qui demande au CLI les Features ouvertes et les questions non résolues reçoit une réponse courte et structurée. Le même agent sans le CLI lit N documents — N se chiffrant souvent en dizaines. La surface du CLI est expressément conçue pour court-circuiter cette avalanche de lectures.

La spécification et la documentation du dépôt public specscore/specscore sont sous CC BY 4.0. L'interface en ligne de commande (CLI) de référence dans specscore/specscore-cli est sous Apache-2.0.

Non. Les spécifications sont des fichiers texte dans le dépôt. La CLI est un binaire local. Les AI Skills de ce site enveloppent cette CLI pour les agents qui savent exécuter des skills. Le format n'impose pas un fournisseur.

Le développement piloté par les spécifications (SDD) consiste à écrire une spécification testable — exigences et critères d'acceptation — avant le code, puis à vérifier le résultat contre cette spécification. SpecScore est un format de fichier pour ces spécifications.