Open source · MIT · par Bluewaves
Craftsman Bâtir avec des agents sans baisser l'exigence. La machine dit passe — ou elle ne le dit pas.
Pour celles et ceux qui ne baisseront jamais l'exigence
À celles et ceux qui laissent l'agent faire le travail — sans jamais le laisser corriger sa propre copie.
Votre propre chaîne d'outils — les tests, le linter, le vérificateur de types, le build — devient la machine à verdicts. Chaque contrôle renvoie un code de sortie. Pas une impression. Pas l'avis d'un modèle de langage. Un verdict qu'une machine peut assumer.
Le contrat
L'humain porte la vision.
L'agent fait le travail.
La machine dit passe.
Une seule phrase que tout le système sert. Le reste n'est que détail.
Le vert veut dire exit 0 — montré, pas revendiqué. Ce que c'est
La Constitution
Cent lignes, relues à chaque tour.
AGENTS.md — la vision, la stack, un exemple par convention, les commandes des portes. Porté par l'humain, jamais compacté, jamais plus de cent lignes. Un seul fichier aiguille chaque tour de travail.
Verdicts machine
Le code de sortie est le verdict.
Le modèle ne juge jamais si son propre code fonctionne — les portes s'en chargent. Et les portes sont les commandes de votre propre projet : test, lint, types, build. Le vert veut dire exit 0, avec la preuve collée.
Neuf Skills
Affûtés, pas lourds.
Brainstorm, specify, plan, implement, verify, fix, review, finish — et un pour tout mettre en place. Chacun tient en soixante-dix lignes ou moins : il montre la forme du bon travail, puis s'arrête.
Le Flux
Aiguillé par l'état, jamais à la main.
Une table dans la constitution aiguille chaque tour. La spec se fige à l'approbation ; le plan s'adapte à chaque frontière de lot ; les changements invisibles peuvent sauter la cérémonie — jamais les portes.
Les Registres
Tout ce qui dure est sur le disque.
SPEC.md tient les critères figés, PLAN.md les lots vivants, ADR.md les décisions et les impasses, le journal git le récit — des commits typés qu'un humain peut auditer. Le travail survit à la compaction.
Le flux
Neuf skills affûtés. Personne ne les nomme — le travail s'aiguille tout seul.
craftsman-mode — observe votre base de code et écrit la constitution à partir de commandes réellement exécutées.
brainstorm — ouvre l'espace — qu'est-ce que cela devrait être, au juste ?
specify — transforme l'intention en critères figés et vérifiables. À vous de les approuver.
plan — découpe la spec en lots, s'adapte à chaque frontière, attend votre feu vert.
implement — une tâche, le test d'abord, la doc ouverte — rouge avant vert.
verify — toutes les portes, des preuves fraîches, des codes de sortie — jamais d'auto-évaluation.
fix — diagnostique jusqu'à la cause racine avant la moindre ligne de réparation.
review — un regard neuf juge si le travail est bon, pas seulement vert.
finish — QA complète, décisions consolidées, documentation vraie sur une machine propre.
Vous prenez les décisions produit ; les codes de sortie jugent le code. C'est tout le travail.
Douze messages de l'humain — un prompt, des décisions produit, des validations. Tout le reste, le flux l'a aiguillé tout seul : un produit livré, sur un modèle de milieu de gamme, sans le moindre sous-agent.
16/16 critères · 53/53 tests · 44 commits typés · $7.07
Mesuré, pas promis.
Comment c'est bâti
Du markdown, pas de machinerie
Une constitution et trois registres — SPEC, PLAN, ADR — plus votre journal git. Des fichiers simples, portés par l'humain, aucun état ailleurs. Sans CLI, sans dépendances, sans démon : du markdown et du bash, rien à casser.
Une commande pour installer
Bash seulement, idempotent, au niveau utilisateur ou projet. Les skills atterrissent dans le magasin au standard ouvert, votre agent les découvre, et votre AGENTS.md existant n'est jamais touché. La désinstallation est documentée dans le script.
Les Skills
Neuf skills au standard ouvert Agent Skills — lisibles par Claude Code, Codex, Cursor, et la suite. Chacun montre la forme du bon travail en soixante-dix lignes, puis s'efface.
La machine parle
Le flux n'a qu'une voix pour l'état du travail : la preuve. Il ne flatte jamais, et il ne devine jamais.
Pas pour tout le monde
Craftsman ne court pas après le classement, la démo ou le modèle de la semaine. C'est un cadeau — sous licence MIT, sans contrepartie — pour celles et ceux qui livrent du vrai logiciel et refusent de laisser un agent corriger son propre travail. Si c'est vous, il est à vous.
Filiation
Deux ancêtres et un pari — chaque ancêtre gardé pour la seule chose qu'il a su faire juste.
Craftsman v1 — imposé par la machine : son intuition, c'est que les verdicts doivent être des codes de sortie. Gardée — moins les 22 000 lignes de CLI.
Superpowers — le comportement par l'ingénierie : son intuition, c'est la divulgation progressive — ne garder presque rien de résident en permanence. Gardée — moins la cérémonie.
The LLM-judge research — les modèles reconnaissent un code correct à peine mieux qu'à pile ou face ; le retour mécanique bat le « merci de faire du TDD ».
Agent Skills — un seul format de skill que tout harnais sait lire — un processus, pas un verrou.
Le pari par-dessus les deux : les modèles de frontière suivent mieux la forme que les règles. Montrez un bon exemple, ils généralisent ; écrivez dix paragraphes d'interdits, ils rationalisent.
L'humain porte la vision. L'agent fait le travail. La machine dit passe.
Guider et montrer, plutôt que dicter et contrôler.
Prenez-le. Il est à vous.
Lire le rapport du piloteSous licence MIT · par Bluewaves