sdd-kit

Le problème

Les agents d'IA écrivent du code vite, mais sans processus : ils oublient le projet à chaque session, ouvrent des pull requests énormes, décident à la place du propriétaire et, quand la CI passe au rouge, la réparent parfois en désactivant le test.

Les outils SDD de la communauté gèrent bien la spécification. Ce qui reste à la personne, c'est la livraison : transformer la spécification en tickets relisibles, garder la CI verte et clôturer la version.

La solution

Le kit apporte à n'importe quel dépôt la façon de livrer d'une équipe professionnelle :

• Une skill qui enseigne à l'agent tout le processus : analyse fondée sur des preuves, spécifications avec critères d'acceptation, une épopée par phase, un ticket par branche et par pull request, revue, CHANGELOG et tag.
• Un script d'adoption, en sh et en PowerShell, qui copie le modèle sans rien écraser : CLAUDE.md, modèles d'issue et de PR, spécifications et une CI prête pour Go, Node/TypeScript, Java, Python, Rust et C#/.NET, avec une couverture de tests minimale.
• Un moteur d'événements sur GitHub Actions qui fait les étapes mécaniques sans IA : il met à jour le point de reprise à chaque merge, résume la CI rouge, intègre la main dans les PR, ouvre la PR de clôture et déclenche la release.
• Des points de reprise : une session peut s'arrêter à tout moment, et la suivante reprend là où la précédente s'est arrêtée.
• axyn, une CLI en Go qui applique le même processus à des modèles gratuits ou locaux, en n'avançant que si les contrôles de qualité passent.

Comment la qualité est garantie

Le kit est développé avec son propre processus, et chaque pull request passe par 12 vérifications :

• Lint du Markdown et du shell, tests des scripts et vérification des workflows (actionlint).
• L'adoption testée sous Linux, macOS et Windows.
• Chaque modèle de langage adopté dans un projet minimal, avec le make ci généré réellement exécuté.
• Traçabilité : chaque critère d'acceptation est cité dans un test ; une règle fait échouer la CI s'il en manque un.
• La version de chaque release est calculée à partir des commits, avec Go Release Manager.

Choix techniques

• Des points d'arrêt explicites : décisions, revue, merge et tag appartiennent au propriétaire, sauf délégation.
• Les tests sont souverains : une CI rouge se corrige à la cause racine, jamais en assouplissant ou en sautant un test.
• Des scripts en sh POSIX et en PowerShell, pour tourner de la même façon sous Linux, macOS et Windows.
• L'adoption n'écrase jamais les fichiers du projet, et une synchronisation hebdomadaire tient les dépôts adoptés à jour.

Résultat

Le kit est né de cv-craft, passé du prototype à la v1.x avec ce processus : 10 spécifications et 71 critères d'acceptation, tous couverts par un test automatisé. Aujourd'hui, il pilote Go Release Manager et sdd-kit-demo, un projet créé de zéro avec épopée, tickets, pull requests et release, ainsi que le kit lui-même. La même méthode, avec des spécifications et des tests souverains, guide ce site.

Limites

Le kit dépend de GitHub et d'un agent (Claude Code, ou opencode via axyn). Pour l'instant, il est utilisé sur mes projets ; il manque la validation par d'autres équipes. Le processus ne remplace pas la personne : les décisions et la revue restent au propriétaire.