ub-mode, ou comment Uncle Bob oblige un agent de code à prouver son travail

Un fichier de skill et quatre programmes derrière
Chaque semaine, un dépôt de plus livre une personnalité pour votre agent de code. Un fichier markdown avec un nom, une voix, une liste de ce à quoi le modèle devrait faire attention. Vous le déposez dans un dossier de skills, vous tapez une commande slash, et l'agent se met à écrire des messages de commit comme un ingénieur senior qui en a vu d'autres.
ub-mode affiche 7,989 étoiles sur GitHub au 15 novembre 2026, sous unclebob/ub-mode. L'installation suit le schéma à la lettre : copier SKILL.md dans ~/.claude/skills/ub-mode/SKILL.md, ou l'équivalent Cursor, ou l'équivalent Grok, puis taper /ub-mode. Trois phases. « First Make it Work » contient Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, et une section d'architecture sur la modélisation du domaine, les frontières, la discipline des types, les opérations idempotentes et la séparation avant sérialisation d'un état partagé. « Then Make it Right » contient Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior Not Implementation, Refactoring. « Practice », c'est un journal, l'hygiène de la fenêtre de contexte, le nettoyage des worktrees, des commits petits et ordonnés.
C'est cette liste que les gens citeront en capture d'écran. La partie qui vaut la lecture est à l'intérieur de « Then Make it Right » : quatre programmes en ligne de commande que l'auteur a écrits pour vérifier le travail de l'agent.
Le problème de la phrase
Demandez à un agent de code s'il a fini, vous obtenez une phrase. « J'ai implémenté l'endpoint, ajouté les tests, la suite passe. » Cette phrase a été produite par le même processus qui a écrit le code, elle ne porte donc aucune information indépendante. C'est de là que vient le slop. Cela tient peu au caractère du modèle et beaucoup à la boucle dans laquelle il tourne. La définition de terminé, pour l'agent, est une affirmation, et les affirmations coûtent peu.
Le skill remplace l'affirmation par des nombres que l'agent doit faire bouger. Crapper calcule la complexité cyclomatique, la couverture de tests et un score CRAP par fonction, et la règle veut que chaque fonction reste sous CRAP < 10. Dryer cherche les duplications structurelles et exige la suppression des blocs à 0.8 de similarité ou plus. Mutator lance des tests de mutation : il casse le code exprès et regarde si les tests le remarquent. UML-viewer dessine les composants, la couverture, les scores CRAP, les scores de mutation et le sens des dépendances.
Trois de ces quatre programmes peuvent faire échouer un build. On peut discuter avec un paragraphe. Un code de sortie est plus difficile à contester, surtout parce que la contradiction doit être du code différent.
Attack the Premise
Parmi les neuf principes de la phase un, deux se comportent différemment quand le lecteur est un modèle.
Attack the Premise est celui que je livrerais seul. Les agents sont obéissants d'une manière précise et coûteuse : ils implémentent la demande telle qu'elle est écrite, avec compétence, et ne demandent jamais si cette demande devrait exister. Dites-en un d'ajouter une couche de cache, vous obtenez une couche de cache. Testée, commitée par petits pas, avec une frontière propre. Personne n'a vérifié si l'endpoint était lent à cause du plan de requête. L'agent ne remarquera pas non plus que le ticket est un contournement d'une décision prise il y a deux ans par quelqu'un qui est parti depuis.
Un relecteur humain objecte parce que l'objection est gratuite et qu'il porte le contexte environnant dans sa tête. Un agent n'objecte que si une règle le lui demande, ce qui rend Attack the Premise porteur. Sa position dans la phase un compte aussi, avant que le moindre code existe, quand changer la réponse coûte encore peu.
Sequence Work into Verifiable Units est le second, et il s'agit en réalité de mémoire. Les longues sessions pourrissent. Une contrainte posée au troisième tour est encore dans la fenêtre au quatre-vingt-dixième, mais elle n'a plus le même poids, et le modèle se met à enfreindre avec assurance une règle fixée une heure plus tôt. Découper le travail en unités avec une vérification à la fin de chacune vous donne un endroit où vous arrêter et regarder, et donne aux portes quelque chose à mordre. Une porte à la fin d'un changement de quatre mille lignes vous dit que le changement est mauvais. Une porte à la fin de quarante lignes vous dit lesquelles.
Là où les nombres cessent d'aider
C'est ici que je cesse de lui faire confiance.
CRAP < 10 vient de la revue de code humaine. Le seuil a été réglé pour des relecteurs à la patience limitée lisant du code écrit par des collègues. Un agent qui optimise pour le seuil peut prendre une honnête fonction de quarante lignes et la découper en quatre fonctions de douze lignes aux noms pires et à la logique identique. La complexité par fonction baisse, la couverture tient, le score descend, le build passe au vert. Rien dans le code ne s'est amélioré. Le nombre, si.

La duplication échoue par l'autre bout. Dryer signale les blocs à 0.8 de similarité ou plus. Extrayez un helper partagé qui prend neuf paramètres et un drapeau de mode, la similarité tombe sous le seuil. Vous finissez avec une fonction plus difficile à lire que les deux qu'elle remplace, plus une vérification au vert. L'outil mesure la forme, et la forme se contourne facilement avec de pires formes.
Les tests de mutation sont la porte honnête et la plus chère. Ils exécutent votre suite une fois par mutant, donc le temps réel est le temps d'exécution de la suite multiplié par le nombre de mutations. C'est supportable sur un portable et pénible dans une boucle où un agent itère sur un correctif. Mon hypothèse, et ce n'est qu'une hypothèse, est que c'est là que les agents bâcleront en premier : sauter mutator, ou écrire des tests qui tuent des mutants sans affirmer de comportement. Un test qui vérifie seulement que la fonction renvoie quelque chose de non nul tue un nombre surprenant de mutants tout en ne testant rien qu'un utilisateur reconnaîtrait.
L'essayiste qui livre désormais des portes
Il y a une plaisanterie dans ce projet que le README ne fait pas. Robert C. Martin fait débat depuis vingt ans, surtout sur les conseils de style de Clean Code, sur la question de savoir si ces règles étaient de l'expérience durement acquise ou du folklore bien commercialisé. Le même auteur livre désormais les règles sous forme de programmes avec seuils et codes de sortie, et vous demande de les installer plutôt que de les lire.
Cela se lit comme une concession, et une concession honnête. Un essai ne s'exécute pas. On peut être en désaccord avec un chapitre pendant des années sans jamais trancher. On peut être en désaccord avec CRAP < 10 en un après-midi, en lançant l'outil sur son propre dépôt et en regardant ce qu'il veut changer. Les querelles de style se terminent quand quelqu'un produit un nombre, ou du moins elles deviennent plus calmes et plus précises. L'homme célèbre pour sa prose sur le code a décidé que la prose était la partie faible.
Ce que les portes ne voient pas
Une limite, dite clairement. C'est un fichier de skill et quatre outils en ligne de commande. Rien dans l'ensemble ne vérifie qu'un humain a lu le diff. Les portes inspectent le code produit par l'agent. Elles ne disent rien sur le fait que quelqu'un ait accepté que ce code existe, ni que le ticket valait la peine. Attack the Premise, la règle que je garderais si je ne pouvais en garder qu'une, reste une phrase dans un fichier markdown, sans autre application que la volonté du modèle de suivre des instructions. L'élément le plus fort de toute la collection est le seul sans programme derrière lui, ce qui dit quelque chose sur les problèmes réellement difficiles.
Avant d'installer, lancez crapper sur le dépôt vers lequel vous comptez pointer l'agent. Si deux cents fonctions sont déjà au-dessus du seuil, la première session sera du refactoring, pas des fonctionnalités, et l'agent dépensera son budget sur du code que vous ne lui avez jamais demandé de toucher. Mieux vaut voir ce nombre vous-même que laisser l'agent le découvrir pour vous à deux heures du matin.
Articles associés
Quelqu'un a mis le droit mondial dans git, on peut donc blâmer un article de loi
global-law conserve les textes de chaque pays dans un dépôt git où chaque commit correspond à une loi entrée en vigueur à une date connue. On peut lancer log, blame, show et diff sur un article, demander ce qui s'appliquait dans chaque pays un jour donné, et confier le tout à un assistant via MCP.
Un serveur, une streameuse IA : dans le code qui fait tourner un live nocturne
open-yoki est le code de production d'une hôte IA qui streame chaque soir sur Binance Square, personnalité, voix et fonctions liées à l'argent retirées. headless Chrome dessine la frame, ffmpeg pousse le RTMP, un dossier de Markdown décide de son humeur et de ce qu'elle publie.
Pinky laisse un agent piloter votre téléphone, et garde le bouton Envoyer enfoncé jusqu'à votre clic sur Autoriser
Pinky relie n'importe quel agent MCP à un vrai iPhone ou Android et impose l'approbation dans sa propre passerelle plutôt que dans un prompt. Les applis bancaires sont invisibles, les champs de mot de passe interdits, et sous Android 13 l'agent obtient un second écran caché.
Cicada écoute directement l'audio de votre réunion, sans bot dans la salle
Cicada est une application gratuite pour Mac, Windows, Linux et Android qui écrit des sous-titres bilingues et des notes de réunion structurées à partir de l'audio du système, puis vous laisse tenir une touche pour répondre dans l'autre langue avec votre propre voix clonée. Aucun bot ne rejoint l'appel.