O checklist do Uncle Bob para trabalhar com IA


Uma ideia muito forte do Uncle Bob sobre IA:

“Sem restrições, os agentes fazem qualquer coisa.”

Por isso ele insiste muito na criação de “physical barriers”.

Ou seja: mecanismos concretos que limitam o que a IA pode fazer dentro do sistema.

O checklist que ele sugere é interessante:

  • unit tests com cobertura extremamente alta (os agentes usam os testes para entender o comportamento esperado do sistema)
  • acceptance tests escritos em Gherkin/BDD (testes legíveis por humanos funcionando como “leis” do sistema)
  • mutation tests (a ferramenta altera automaticamente partes do código (por exemplo trocando > por < ) para verificar se os testes detectam o problema. Se os testes continuam passando, significa que eles provavelmente estão fracos)
  • linters (evita erros básicos e força padrões mínimos de código)
  • dependency checkers (controlam dependências entre módulos e ajudam a proteger a arquitetura)
  • code coverage tools (forçam os agentes a cobrirem partes esquecidas do sistema)
  • CRAP metric: complexidade ciclomática + cobertura de testes (ajuda a identificar funções complexas e perigosas)
  • architecture viewers (ajudam humanos a visualizar sistemas que ficaram grandes demais para entender só lendo código)
  • implementation plans com checkpoints (evita que agentes saiam implementando coisas longas sem supervisão)

A ideia é simples: não confiar apenas em prompts e instruções.

Porque os agentes:

  • esquecem contexto
  • ignoram regras
  • focam demais na última instrução
  • “compactam” memória quando o contexto enche
  • começam a agir de forma imprevisível

Então os testes deixam de ser apenas garantia de qualidade e viram mecanismos de controle dos agentes.

Achei especialmente interessante essa frase implícita no episódio: “tests are documentation for the AI”.

A IA lê os testes para entender o comportamento esperado do sistema.

Talvez esse seja um dos pontos mais contraintuitivos da era de IA: quanto mais código conseguimos gerar automaticamente, mais importante fica criar mecanismos que impeçam o sistema de degradar silenciosamente ao longo do tempo.

Fonte: episódio “Agentic Discipline”, do Clean Coders / Uncle Bob.

Leo Andreucci - CTO Mentor

Ex-VP Engineering @ Creditas ($4.8B). 20+ years building and scaling tech teams. Today, I help CTOs make better decisions.

Read more from Leo Andreucci - CTO Mentor

Durante los últimos meses construí un proyecto personal usando Claude como mi principal herramienta de desarrollo. La idea parecía simple: Crear una quiniela del Mundial donde los participantes hacen todos sus pronósticos antes de que empiece el torneo, como hacíamos en Excel hasta hace poco. El software estuvo listo mucho más rápido de lo que imaginaba. Pero lo más interesante fueron los aprendizajes a lo largo del camino. Algunos de ellos: Los tests son obligatorios. En un momento decidí...

Nos últimos meses construí um projeto pessoal usando Claude como principal ferramenta de desenvolvimento. A ideia parecia simples: Criar um bolão da Copa do Mundo onde os participantes fazem todos os palpites antes do torneio começar, como fazíamos em excel até pouco tempo atrás. O software ficou pronto muito mais rápido do que eu imaginava. Mas o mais interessante foram os aprendizados ao longo do caminho. Alguns deles: Testes são obrigatórios. Em um momento eu decidi que iria ler todos os...

Una idea muy fuerte de Uncle Bob sobre IA: “Sin restricciones, los agentes hacen cualquier cosa.” Por eso insiste mucho en la creación de “physical barriers”. Es decir: mecanismos concretos que limitan lo que la IA puede hacer dentro del sistema. El checklist que él sugiere es interesante: unit tests con cobertura extremadamente alta (los agentes usan los tests para entender el comportamiento esperado del sistema) acceptance tests escritos en Gherkin/BDD (tests legibles para humanos...