Tout changement qui mérite d'être bâti commence par une intention

Une semaine de SDD : d'une première version à un outil qui vérifie son propre travail.

Le jour, je suis ingénieur logiciel et architecte senior. Le soir et le week-end, je peins sous le nom de Sam Grudge : des cœurs, à l'huile sur toile, construits couche après couche jusqu'à ce que la couleur rayonne (hearts-colors.com). Les deux vies semblent très éloignées. De plus en plus, elles se rejoignent autour d'une seule question : que veux-je faire de mes propres mains, et que puis-je confier à une machine ?

SDD vient de mon métier de jour. C'est une compétence de développement piloté par les spécifications pour les agents de codage IA (Claude Code et Codex), et c'est open source sur GitHub. L'idée est simple. Avant que l'agent n'écrive du code, il rédige une courte spécification : les exigences, et des exemples concrets de comportement attendu, y compris en cas d'erreur. Je l'approuve. Ensuite, l'agent la construit en commençant par les tests, la vérifie par rapport à la spécification, et tient un registre vivant du comportement du système.

Ce qui a changé en une semaine

La première version est sortie le 7 octobre. Elle gérait les petits changements de bout en bout, avec une seule approbation, des tâches orientées tests d'abord et une spécification vivante. Sept jours et quatorze versions plus tard :

• Les travaux plus importants suivent leur propre chemin. Un changement plus large reçoit trois approbations au lieu d'une : la spécification, le plan et les résultats.
• Une spécification approuvée est verrouillée. La modifier ensuite exige un amendement consigné et approuvé. Les bugs suivent leur propre circuit, et un test de non-régression est ajouté à la spécification vivante pour que le bug ne puisse pas revenir discrètement.
• Un critique relit la spécification avant que quoi que ce soit ne soit construit. Il audite chaque exigence et ne me pose que les questions qui me reviennent de trancher, cinq au maximum.
• SDD développe désormais SDD. Depuis la version 0.5, le projet fonctionne selon sa propre méthode, avec une rigueur de niveau « production » : le second niveau le plus élevé de ses quatre niveaux.
• La suite de tests est passée de 82 à 208 tests.

L'outil a trouvé des failles en lui-même

Le premier changement que SDD a appliqué sur lui-même était un bug qu'il avait découvert dans ses propres approbations. L'approbation finale des « résultats » ne tenait pas compte du verdict du relecteur, si bien qu'un travail marqué comme comportant des lacunes pouvait tout de même être approuvé. La constitution du projet, ses règles non négociables, pouvait être modifiée après approbation sans que personne ne s'en aperçoive, y compris pour abaisser le niveau de rigueur.

Les deux problèmes sont corrigés. Une approbation couvre désormais exactement ce qui a été approuvé. Le contrôle des résultats n'accepte qu'un verdict favorable, et la constitution porte une empreinte : toute modification ultérieure est signalée et bloque la progression tant que je ne l'approuve pas à nouveau.

Ce que j'ai le plus apprécié, c'est la manière dont on y est arrivé. La vérification a été lancée trois fois, chacune dans une session neuve sans mémoire du travail précédent. Les deux premiers tours ont révélé des lacunes : des règles énoncées dans la spécification mais non prouvées par un test. Chaque fois, la spécification a été amendée, les tests manquants ont été écrits, et le relecteur a regardé à nouveau. Le troisième tour a été validé. Rien n'a été accepté sans preuve.

Couches

Un de mes tableaux, ce sont des couches. Les premières disparaissent sous la couleur, mais elles soutiennent tout l'ensemble. SDD fonctionne de la même façon : l'intention, puis la spécification, le plan, les tests et la vérification, chacun visible et vérifiable sous le code.

Sur mon site, je dis que toute histoire qui mérite d'être racontée commence par un cœur. En logiciel, tout changement qui mérite d'être bâti commence par une intention. Cette part-là reste entre mes mains. Tout comme les décisions et les approbations, qui portent mes propres mots.

Déléguer la corvée

Toutes les couches n'ont pas besoin d'une main de maître. Un tour de vérification prenait environ 14 minutes et près de 180 000 jetons, et une grande partie de ce travail était mécanique : rejouer des tests sur l'ancien code, enfreindre délibérément des règles pour prouver qu'un test les détecte, rassembler des preuves. Un script peut faire ce travail, sans aucun modèle.

C'est la prochaine étape. Un modèle principal orchestrera l'ensemble : il échangera avec moi, tiendra les points de contrôle et répartira le travail. Des relecteurs indépendants fonctionneront comme des agents distincts sur les modèles les plus puissants. Les tâches routinières iront à des modèles moins coûteux et plus rapides. Chaque type de travail va vers l'outil qui lui convient, tout comme un pinceau convient à un certain coup et une spatule à un autre.

C'est la promesse de l'IA qui me tient à cœur. Elle ne retire pas le métier. Elle retire la corvée qui l'entoure, pour que je garde la part que j'aime. Au bureau, c'est l'architecture et le jugement. Dans l'atelier, c'est le prochain cœur.

SDD est open source sous licence MIT : github.com/fpapleux/sdd-skill. Les notes de version répertorient chaque version.