ub-mode, ovvero come Uncle Bob obbliga un agente di codice a dimostrare il lavoro

Un file di skill con quattro programmi dietro
Ogni settimana un altro repository pubblica una personalità per il tuo agente di codice. Un file markdown con un nome, una voce, un elenco di cose a cui il modello dovrebbe badare. Lo infili in una cartella di skill, digiti un comando slash, e l'agente comincia a scrivere messaggi di commit come un senior engineer che ne ha viste di tutti i colori.
ub-mode è a 7,989 stelle su GitHub al 15 novembre 2026, sotto unclebob/ub-mode. L'installazione segue lo schema alla lettera: copiare SKILL.md in ~/.claude/skills/ub-mode/SKILL.md, o l'equivalente per Cursor, o per Grok, poi digitare /ub-mode. Tre fasi. «First Make it Work» contiene Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, e una sezione di architettura su modellazione del dominio, confini, disciplina dei tipi, operazioni idempotenti e separazione prima della serializzazione dello stato condiviso. «Then Make it Right» contiene Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior Not Implementation, Refactoring. «Practice» è un log, igiene della finestra di contesto, pulizia dei worktree, commit piccoli e ordinati.
È quella lista che la gente citerà negli screenshot. La parte che vale la pena leggere sta dentro «Then Make it Right»: quattro programmi da riga di comando che l'autore ha scritto per controllare il lavoro dell'agente.
Il problema della frase
Chiedi a un agente di codice se ha finito e ottieni una frase. «Ho implementato l'endpoint, aggiunto i test, la suite passa.» Quella frase è stata generata dallo stesso processo che ha scritto il codice, quindi non porta informazione indipendente. Da qui viene lo slop. Ha poco a che fare con il carattere del modello e molto con il loop in cui è inserito. La definizione di finito, per l'agente, è un'affermazione, e le affermazioni costano poco.
La skill sostituisce l'affermazione con numeri che l'agente deve muovere. Crapper calcola complessità ciclomatica, copertura dei test e un punteggio CRAP per ogni funzione, e la regola è che ogni funzione resti sotto CRAP < 10. Dryer cerca duplicazione strutturale e impone di rimuovere i blocchi con similarità 0.8 o superiore. Mutator esegue i test di mutazione: rompe il codice di proposito e verifica se i test se ne accorgono. UML-viewer disegna componenti, copertura, punteggi CRAP, punteggi di mutazione e direzione delle dipendenze.
Tre di quei quattro possono far fallire una build. Con un paragrafo si può discutere. Con un exit code è più difficile, soprattutto perché la controargomentazione deve essere codice diverso.
Attack the Premise
Dei nove principi della prima fase, due si comportano diversamente quando chi legge è un modello.
Attack the Premise è quello che pubblicherei da solo. Gli agenti sono obbedienti in un modo specifico e costoso: implementano la richiesta come è scritta, con competenza, e non chiedono mai se quella richiesta dovrebbe esistere. Di' a uno di aggiungere un livello di cache e ottieni un livello di cache. Testato, committato a piccoli passi, con un confine pulito. Nessuno ha controllato se l'endpoint era lento per il piano di query. L'agente non noterà nemmeno che il ticket è un workaround per una decisione presa due anni fa da qualcuno che se n'è andato.
Un revisore umano obietta perché obiettare è gratis e perché porta il contesto intorno nella testa. Un agente obietta solo quando una regola glielo dice, e questo rende Attack the Premise portante. Conta anche la sua posizione nella prima fase, prima che esista codice, quando cambiare la risposta costa ancora poco.
Sequence Work into Verifiable Units è il secondo, e in realtà parla di memoria. Le sessioni lunghe marciscono. Un vincolo del terzo turno è ancora nella finestra al novantesimo, ma non ha più lo stesso peso, e il modello comincia a infrangere con sicurezza una regola fissata un'ora prima. Tagliare il lavoro in unità con un controllo alla fine di ognuna ti dà un posto dove fermarti a guardare, e dà alle porte qualcosa da mordere. Una porta alla fine di una modifica da quattromila righe ti dice che la modifica è cattiva. Una porta alla fine di quaranta righe ti dice quali quaranta.
Dove i numeri smettono di aiutare
Qui è dove smetto di fidarmi.
CRAP < 10 viene dalla revisione del codice umana. Era tarato su revisori con poca pazienza che leggono codice di colleghi. Un agente che ottimizza per la soglia può prendere una onesta funzione da quaranta righe e spezzarla in quattro funzioni da dodici righe con nomi peggiori e logica identica. La complessità per funzione scende, la copertura tiene, il punteggio cala, la build diventa verde. Del codice non è migliorato niente. Il numero sì.

La duplicazione fallisce dall'altra direzione. Dryer segnala i blocchi con similarità 0.8 o superiore. Estrai un helper condiviso che prende nove parametri e un flag di modalità, e la similarità scende sotto la soglia. Ti ritrovi una funzione più difficile da leggere delle due che ha sostituito, più un controllo che passa. Lo strumento misura la forma, e la forma si aggira facilmente con forme peggiori.
I test di mutazione sono la porta onesta e quella cara. Eseguono la suite una volta per mutante, quindi il tempo reale è il tempo della suite moltiplicato per il numero di mutazioni. È tollerabile su un portatile e doloroso dentro un loop in cui un agente itera su una correzione. La mia ipotesi, ed è solo un'ipotesi, è che qui gli agenti taglieranno per primi: saltare mutator, o scrivere test che uccidono i mutanti senza affermare comportamento. Un test che afferma solo che la funzione restituisce qualcosa di non nullo uccide un numero sorprendente di mutanti senza testare nulla che un utente riconoscerebbe.
Il saggista che ora pubblica porte
C'è una battuta dentro questo progetto che il README non fa. Su Robert C. Martin si discute da vent'anni, soprattutto per i consigli di stile di Clean Code, sul fatto che quelle regole fossero esperienza conquistata duramente o folklore con un buon marketing. Lo stesso autore ora pubblica le regole come programmi con soglie ed exit code, e ti chiede di installarle invece di leggerle.
Si legge come una concessione, e una giusta. Un saggio non si può eseguire. Puoi essere in disaccordo con un capitolo per anni e non chiuderla mai. Puoi essere in disaccordo con CRAP < 10 in un pomeriggio, eseguendo lo strumento sul tuo repository e guardando cosa vuole cambiare. Le discussioni sullo stile finiscono quando qualcuno produce un numero, o almeno diventano più quiete e più precise. L'uomo famoso per la prosa sul codice ha deciso che la prosa era la parte debole.
Cosa le porte non vedono
Un limite, detto chiaramente. Questa è una skill più quattro strumenti CLI. Niente nell'insieme verifica che un umano abbia letto il diff. Le porte ispezionano il codice prodotto dall'agente. Non dicono nulla sul fatto che qualcuno abbia concordato che quel codice dovesse esistere, né che il ticket valesse la pena. Attack the Premise, la regola che terrei se potessi tenerne una, resta una frase in un file markdown, applicata da niente tranne la volontà del modello di seguire le istruzioni. L'elemento più forte dell'intera collezione è l'unico senza un programma dietro, il che dice qualcosa su quali problemi siano davvero difficili.
Prima di installare, esegui crapper sul repository verso cui pensi di puntare l'agente. Se duecento funzioni sono già sopra la soglia, la prima sessione sarà refactoring, non funzionalità, e l'agente spenderà il budget su codice che non gli hai mai chiesto di toccare. Meglio vedere quel numero da solo che lasciare che l'agente lo scopra per te alle due di notte.
Articoli correlati
Un server, una streamer IA: dentro il codice che manda avanti una diretta notturna
open-yoki è il codice di produzione di una host IA che va in diretta ogni sera su Binance Square, con persona, voce e funzioni legate al denaro rimosse. headless Chrome disegna il frame, ffmpeg spinge RTMP, una cartella di Markdown decide umore e post.
Pinky lascia che un agent guidi il tuo telefono e tiene premuto Invia finché non tocchi Consenti
Pinky collega qualsiasi agent MCP a un iPhone o Android vero e impone l'approvazione nel proprio gateway invece che in un prompt. Le app bancarie sono invisibili, i campi password sono off limits e su Android 13 l'agent riceve un secondo schermo nascosto.
AnyModelBot mette un piccolo team di bot IA sulla tua macchina, chiavi comprese
AnyModelBot è un'app desktop che fa girare più bot insieme, ognuno con la sua persona, il suo modello, la sua cartella di lavoro e la sua memoria. Ci parli dentro l'app oppure da WeChat, Feishu, Telegram, Slack e Discord, e file, cronologia e chiavi API restano sul tuo disco.
SeedRealtime di ByteDance prende due frame al secondo e decide quando parlare
Doubao-Seed-Realtime-1.0 mette frame di camera, frame di schermo e voce in un'unica sessione full duplex, a non più di due frame al secondo. Le decisioni interessanti sono la frequenza dei frame, il parlato proattivo e la risposta di audit attiva di serie.