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

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...

Uno de los mejores modelos mentales sobre IA que escuché recientemente vino de Uncle Bob en el episodio 4 de Agentic Discipline en Clean Coders: Humanos e IA tienen puntos fuertes completamente diferentes. La IA es muy buena en: sintaxis velocidad memoria de corto plazo tareas repetitivas generar código boilerplate buscar información reasoning lógico/local Los humanos siguen siendo mucho mejores en: arquitectura visión sistémica entendimiento de contexto discernimiento moral experiencia...

Um dos melhores modelos mentais sobre IA que ouvi recentemente veio do Uncle Bob no Episódio 4 de Agentic Discipline do Clean Coders: Humanos e IA possuem pontos fortes completamente diferentes. IA é muito boa em: sintaxe velocidade memória de curto prazo tarefas repetitivas gerar código boilerplate pesquisar informação reasoning lógico/local Humanos continuam muito melhores em: arquitetura visão sistêmica entendimento de contexto discernimento moral experiência prioridades trade-offs direção...