← Voltar ao blog
Aicerca de 7 min de leitura

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

Publicado 15 de nov. de 2026
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