ub-mode: como Uncle Bob obriga um agente de código a provar que terminou

Um arquivo de skill com quatro programas atrás
Toda semana outro repositório entrega uma personalidade para o seu agente de código. Um arquivo markdown com nome, voz e uma lista de coisas com que o modelo deveria se importar. Você joga numa pasta de skills, digita um comando de barra e o agente começa a escrever mensagens de commit como um engenheiro sênior que já viu de tudo.
O ub-mode está com 7,989 estrelas no GitHub em 15 de novembro de 2026, em unclebob/ub-mode. A instalação segue o padrão à risca: copiar o SKILL.md para ~/.claude/skills/ub-mode/SKILL.md, ou o equivalente no Cursor, ou no Grok, e digitar /ub-mode. Três fases. «First Make it Work» traz Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, e uma seção de arquitetura sobre modelagem de domínio, fronteiras, disciplina de tipos, operações idempotentes e separar antes de serializar estado compartilhado. «Then Make it Right» traz Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior Not Implementation, Refactoring. «Practice» é um log, higiene da janela de contexto, limpeza de worktrees, commits pequenos e ordenados.
É essa lista que as pessoas vão citar em print. A parte que vale ler está dentro de «Then Make it Right»: quatro programas de linha de comando que o autor escreveu para conferir o trabalho do agente.
O problema da frase
Pergunte a um agente de código se ele terminou e você recebe uma frase. «Implementei o endpoint, adicionei testes, a suíte passa.» Essa frase foi gerada pelo mesmo processo que escreveu o código, então não carrega informação independente. É daí que vem o slop. Tem pouco a ver com o caráter do modelo e muito com o loop em que ele está. A definição de pronto do agente é uma afirmação, e afirmações são baratas de produzir.
A skill troca a afirmação por números que o agente precisa mover. O Crapper calcula complexidade ciclomática, cobertura de testes e um score CRAP por função, e a regra é que toda função fique abaixo de CRAP < 10. O Dryer procura duplicação estrutural e exige que blocos com 0.8 de similaridade ou mais sejam removidos. O Mutator roda testes de mutação: quebra o código de propósito e verifica se os testes percebem. O UML-viewer desenha componentes, cobertura, scores CRAP, scores de mutação e a direção das dependências.
Três desses quatro podem derrubar um build. Com um parágrafo dá para discutir. Com um exit code é mais difícil, principalmente porque a contra-argumentação precisa ser código diferente.
Attack the Premise
Dos nove princípios da primeira fase, dois se comportam diferente quando quem lê é um modelo.
Attack the Premise é o que eu publicaria sozinho. Agentes são obedientes de um jeito específico e caro: implementam o pedido como está escrito, com competência, e nunca perguntam se o pedido deveria existir. Mande um adicionar uma camada de cache e você ganha uma camada de cache. Testada, commitada em passos pequenos, com fronteira limpa. Ninguém checou se o endpoint estava lento por causa do plano de consulta. O agente também não vai notar que o ticket é um contorno para uma decisão tomada dois anos atrás por alguém que já saiu.
Um revisor humano contesta porque contestar é de graça e porque carrega o contexto ao redor na cabeça. Um agente contesta só quando uma regra manda, o que faz de Attack the Premise uma peça estrutural. A posição dele na fase um também importa, antes de existir código, quando mudar a resposta ainda é barato.
Sequence Work into Verifiable Units é o segundo, e na verdade é sobre memória. Sessões longas apodrecem. Uma restrição do terceiro turno ainda está na janela no turno noventa, mas não tem mais o mesmo peso, e o modelo começa a quebrar com confiança uma regra que você definiu uma hora atrás. Cortar o trabalho em unidades com uma checagem no fim de cada uma te dá um lugar para parar e olhar, e dá aos portões algo para morder. Um portão no fim de uma mudança de quatro mil linhas te diz que a mudança está ruim. Um portão no fim de quarenta linhas te diz quais quarenta.
Onde os números param de ajudar
É aqui que eu paro de confiar.
CRAP < 10 saiu da revisão de código humana. Foi calibrado para revisores com pouca paciência lendo código de colegas. Um agente otimizando para o limite pode pegar uma função honesta de quarenta linhas e dividi-la em quatro funções de doze linhas com nomes piores e lógica idêntica. A complexidade por função cai, a cobertura se mantém, o score desce, o build fica verde. Nada no código melhorou. O número sim.

A duplicação falha pelo outro lado. O Dryer marca blocos com 0.8 de similaridade ou mais. Extraia um helper compartilhado que recebe nove parâmetros e uma flag de modo, e a similaridade cai abaixo do limite. Você acaba com uma função mais difícil de ler do que as duas que substituiu, mais uma checagem que passa. A ferramenta mede forma, e forma é fácil de burlar com formas piores.
Teste de mutação é o portão honesto e o caro. Ele roda sua suíte uma vez por mutante, então o tempo de parede é o tempo da suíte multiplicado pelo número de mutações. Isso é tolerável num notebook e doloroso dentro de um loop em que um agente está iterando numa correção. Meu palpite, e é só um palpite, é que é aqui que os agentes vão cortar caminho primeiro: pular o mutator, ou escrever testes que matam mutantes sem afirmar comportamento. Um teste que só afirma que a função retorna algo não nulo mata um número surpreendente de mutantes sem testar nada que um usuário reconheceria.
O ensaísta que agora entrega portões
Tem uma piada dentro deste projeto que o README não conta. Robert C. Martin é discutido há duas décadas, principalmente por causa dos conselhos de estilo em Clean Code, sobre se aquelas regras eram experiência duramente conquistada ou folclore com bom marketing. O mesmo autor agora entrega as regras como programas com limites e exit codes, e pede que você as instale em vez de lê-las.
Isso soa como uma concessão, e uma concessão justa. Um ensaio não pode ser executado. Você pode discordar de um capítulo por anos e nunca resolver. Você pode discordar de CRAP < 10 numa tarde, rodando a ferramenta no seu próprio repositório e olhando o que ela quer mudar. Discussões de estilo terminam quando alguém produz um número, ou pelo menos ficam mais quietas e mais específicas. O homem famoso pela prosa sobre código decidiu que a prosa era a parte fraca.
O que os portões não veem
Uma limitação, dita sem rodeios. Isto é um arquivo de skill mais quatro ferramentas CLI. Nada no conjunto verifica se um humano leu o diff. Os portões inspecionam o código que o agente produziu. Não dizem nada sobre se alguém concordou que aquele código deveria existir, nem se o ticket valia a pena. Attack the Premise, a regra que eu manteria se pudesse manter uma, continua sendo uma frase num arquivo markdown, aplicada por nada além da disposição do modelo de seguir instruções. O item mais forte de toda a coleção é o único sem um programa atrás, o que diz algo sobre quais problemas são de fato difíceis.
Antes de instalar, rode o crapper no repositório para o qual você pretende apontar o agente. Se duzentas funções já estão acima do limite, a primeira sessão vai ser refatoração, não feature, e o agente vai gastar o orçamento em código que você nunca pediu para ele tocar. Melhor ver esse número você mesmo do que deixar o agente descobrir por você às duas da manhã.
Artigos relacionados
Um servidor, uma streamer de IA: dentro do código que roda uma live noturna
open-yoki é o código de produção de uma host de IA que transmite toda noite no Binance Square, sem persona, voz ou qualquer recurso que toque dinheiro. headless Chrome desenha o frame, ffmpeg empurra RTMP e uma pasta de Markdown decide o humor e o que ela publica.
O Pinky deixa um agent dirigir seu celular e segura o botão Enviar até você clicar em Permitir
O Pinky conecta qualquer agent MCP a um iPhone ou Android de verdade e aplica a aprovação no próprio gateway, não num prompt. Apps de banco são invisíveis, campos de senha estão fora de alcance e, no Android 13, o agent ganha uma segunda tela escondida.
O Cicada escuta o áudio da sua reunião direto, sem bot na sala
O Cicada é um app gratuito para Mac, Windows, Linux e Android que escreve legendas bilíngues e notas de reunião estruturadas a partir do áudio do sistema, e depois deixa você segurar uma tecla para responder no outro idioma com sua própria voz clonada. Nenhum bot entra na chamada.
O SeedRealtime da ByteDance pega dois frames por segundo e decide quando falar
O Doubao-Seed-Realtime-1.0 junta frames de câmera, frames de tela e fala numa única sessão full duplex, a no máximo dois frames por segundo. As decisões interessantes são a taxa de frames, a fala proativa e a resposta de auditoria que já vem ligada.