Desenvolvimento
Análise estática de código: quem valida o agente?
15 de novembro de 2026
Por que isso importa
Quando um agente termina uma alteração e escreve “todos os testes passaram”, o que exatamente foi verificado? Ele executou os comandos certos? Na versão atual do código? Com as mesmas regras que existiam antes da mudança? Para quem desenvolve com IA, essas perguntas precisam ter respostas verificáveis.
O vídeo do IndyDevDan começa com uma provocação sobre o nome *loop engineering*, mas minha leitura é que a discussão mais útil aparece na divisão de responsabilidades. O agente propõe e implementa; programas executam verificações definidas; alguém responde pela entrega. Análise estática de código entra nessa divisão como uma maneira de examinar o código sem executar a aplicação. Um linter pode identificar violações das regras configuradas, enquanto a checagem de tipos encontra determinadas incompatibilidades. Nenhum deles, sozinho, demonstra que a funcionalidade atende ao usuário.
Eu começaria por essa fronteira antes de montar uma estrutura com vários agentes. Um fluxo pequeno, que produz evidências confiáveis, já permite avaliar se a automação economiza trabalho. Também colocaria duas ressalvas nas afirmações mais fortes do vídeo: executar código tem custo de infraestrutura e manutenção, mesmo sem consumir tokens; adicionar agentes só aumenta a confiança quando a validação consegue distinguir uma solução correta de uma solução convincente.
Pontos principais
- 00:33 Dan propõe pensar no trabalho como um fluxo com entradas e entregas. A consequência prática é documentar o que precisa sair de cada etapa, permitindo localizar onde uma execução falhou.
- 03:19 A combinação entre engenheiros, agentes e código organiza as responsabilidades. Minha regra seria reservar interpretação para o agente e decisões verificáveis para programas, mantendo um responsável pelo resultado.
- 05:01 O linter introduz uma condição objetiva de aprovação. Seu valor depende das regras e dos arquivos examinados: uma execução verde com cobertura inadequada oferece pouca informação.
- 06:42 Testes entram na validação e devolvem falhas ao agente. Aqui vale separar defeitos no código de problemas no ambiente; cada situação pede uma resposta diferente.
- 10:35 Os ambientes separados ampliam as possibilidades de isolamento. Para avaliar uma entrega, porém, ainda é necessário saber qual revisão foi examinada e reproduzir suas condições de execução.
- 13:21 A passagem do ticket por pesquisa, planejamento e implementação transforma contexto em material de trabalho. Um requisito ambíguo pode atravessar todas essas etapas sem deixar de ser ambíguo.
- 15:33 O cenário de produção fora do ar muda as prioridades do fluxo. A aprovação humana intermediária apresentada pelo autor mostra que a posição da revisão depende do tipo de trabalho.
- 20:05 O autor diferencia tarefas rotineiras de mudanças mais exigentes. Isso sugere começar com uma categoria estreita de alteração e medir seu desempenho antes de ampliar a autonomia.
- 27:22 A separação entre execução do agente e execução do linter é o ponto mais aproveitável. Um controlador externo pode exigir a checagem mesmo que o agente considere a tarefa concluída.
- 29:00 Percorrer o processo inteiro antes de automatizá-lo ajuda a encontrar dependências escondidas. Eu incluiria nesse percurso as saídas de erro e a interrupção por falta de progresso.
- 30:07 Dan recomenda transferir etapas previsíveis para código. Essa decisão permite examinar cada transição do fluxo e verificar se uma falha realmente impede o avanço.
Como aplicar
Análise estática de código como etapa obrigatória
Escolha uma alteração pequena em um projeto conhecido. Por exemplo: corrigir a exportação de um relatório que usa separador decimal inadequado. Escreva o comportamento esperado, um exemplo de entrada e a saída correta antes de chamar o agente. Esse exemplo é uma proposta de exercício; não representa um teste realizado no projeto do Luiz.
Defina quais verificações respondem a quais perguntas:
| Verificação | O que ajuda a verificar | O que permanece fora dela | |---|---|---| | Linter | Cumprimento das regras configuradas | Correção do resultado do relatório | | Checagem de tipos | Compatibilidade conforme o sistema de tipos | Validade dos dados recebidos em produção | | Testes automatizados | Comportamento nos cenários exercitados | Cenários ausentes da suíte | | Revisão humana | Adequação da mudança e das evidências | Garantia absoluta de ausência de defeitos |
Essa divisão evita chamar toda a validação de análise estática e ajuda a escolher verificações que acrescentam informação.
Tire a aprovação de dentro da conversa
Monte um controlador simples: ele solicita a alteração, aguarda o agente terminar e executa as verificações obrigatórias. A mensagem final do agente passa a ser uma explicação do trabalho; a decisão de avançar depende dos resultados capturados pelo controlador.
Em um projeto JavaScript com ESLint já instalado e configurado, uma possível checagem é ./node_modules/.bin/eslint . --max-warnings 0. O controlador precisa distinguir os resultados: no ESLint, o código de saída 1 indica violações ou avisos acima do limite; 2 indica problema de configuração ou erro interno. Mandar o agente corrigir a aplicação por causa de uma configuração quebrada pode produzir alterações desnecessárias. A distinção está na documentação da interface de linha de comando do ESLint.
Registre a revisão examinada, os comandos, os códigos de saída e os relatórios. Se houver mudanças depois da checagem, produza novas evidências. Um relatório antigo não aprova uma versão nova.
Preserve as regras usadas para julgar a mudança
O fluxo deve perceber quando a alteração mexe nos próprios critérios de aprovação. Remover um teste, ampliar a lista de arquivos ignorados ou desativar uma regra pode fazer o resultado ficar verde sem resolver o problema.
Para o piloto, mantenha a configuração e os comandos de validação sob controle do executor. Mudanças nesses arquivos exigem análise específica antes de serem usadas como novo critério. Isso pode ser implementado comparando a proposta com uma versão de referência aprovada. Apenas escrever “não altere os testes” no prompt deixa essa condição dependente da execução do agente.
Experimente três falhas antes de confiar no fluxo
Faça estes exercícios em uma cópia descartável:
- Introduza uma violação conhecida de uma regra habilitada. O linter deve detectá-la e impedir o avanço.
- Faça a configuração da ferramenta falhar. O controlador deve registrar problema de validação, sem tratar a execução como aprovada.
- Apresente uma proposta que remova o teste responsável por detectar o defeito. A mudança nos critérios deve aparecer para revisão, mesmo que os comandos restantes passem.
Esses exercícios avaliam o mecanismo de controle. Depois, o caso funcional do relatório verifica se a implementação produz a saída esperada.
Dê ao fluxo uma condição de parada
Como ponto de partida para o piloto, eu permitiria até três tentativas e interromperia antes disso quando a mesma falha reaparecesse sem mudança relevante. Esses limites são escolhas operacionais a ajustar com dados, não números demonstrados pelo vídeo. Envie ao agente o diagnóstico da verificação que falhou, preservando o contexto necessário para a correção.
A própria Anthropic também recomenda critérios claros de sucesso, limites e uso seletivo de fluxos mais complexos. Há uma convergência prática por trás da disputa de nomes. Veja o artigo sobre loops.
Em dez alterações comparáveis, registre tempo humano de intervenção, custo de execução e retrabalho posterior. Compare com o processo anterior. Eu ampliaria a automação quando esses registros mostrassem benefício consistente e quando fosse possível explicar, para cada entrega, o que passou, o que falhou e por que o fluxo terminou.
Recursos citados
- Mermaid Live Editor · Editor recomendado para desenhar o fluxo antes de automatizá-lo.
- Thinking in Threads · Artigo gratuito do autor, recomendado no encerramento.
- Tactical Agentic Coding (pago) · Curso do autor; a página também apresenta a extensão Agentic Horizon.
- Phase 3 — IA3 (pago) · Divulgado na descrição; a página consultada apresenta a pré-venda.
- Anthropic — Getting started with loops · Artigo referenciado na descrição; endereço atual após redirecionamento.
- Publicação de Peter Steinberger sobre loops · Referência da descrição; o X bloqueou a conferência do conteúdo.
- Publicação de Boris Cherny sobre loops · Referência da descrição; o X bloqueou a conferência do conteúdo.