IA escreve código morto? A ferramenta deadcode da equipe Go o encontra em um comando

Agentes de codificação por IA são ótimos em gerar código, mas também são ótimos em deixar código morto — funções não utilizadas, ramificações inacessíveis e auxiliares órfãos que incham seu código e confundem futuros leitores. A ferramenta deadcode da equipe Go encontra tudo isso em um único comando.

O que é deadcode?

deadcode é uma ferramenta Go oficial (parte de golang.org/x/tools) que realiza análise de inacessibilidade de programa inteiro. Ela reporta funções e métodos que nunca podem ser chamados a partir de qualquer ponto de entrada do seu programa. Não é apenas um linter — ela faz análise real de fluxo de controle e de ponteiros para determinar a acessibilidade.

Como encontrar código morto escrito por IA

Execute isto a partir da raiz do seu módulo:

go run golang.org/x/tools/cmd/deadcode@latest ./...

Isso escaneia todo o seu módulo e imprime uma lista de funções inacessíveis, por exemplo:

deadcode: unreachable: main/helpers.go:23:7:func helperNeverCalled()

Você também pode passar pacotes específicos ou flags:

• -test: incluir arquivos de teste na análise
• -filter: relatar apenas funções que correspondem a uma regex (ex.: -filter '_dead')
• -json: saída em JSON para integração com ferramentas de CI

Por que seu agente de IA deixa código morto

Agentes LLM geram código probabilisticamente — eles frequentemente escrevem funções utilitárias que nunca chamam, ou fazem backup de uma refatoração com uma cópia do código antigo. Como o código compila e os testes passam, é fácil não notar. O deadcode captura isso deterministicamente.

Removendo código morto com segurança

Depois de executar deadcode, revise cada função inacessível manualmente. Uma função pode ser inacessível porque é usada via reflexão, invocada a partir de go:linkname, ou faz parte de uma API pública — a ferramenta tem uma flag -reflect para considerar reflexão. Mas na maioria dos casos, se não é chamada a partir de main (ou testes), você pode deletá-la com segurança.

Depois, execute go test ./... para confirmar que nada quebrou. A eliminação de código morto é uma das vitórias mais fáceis para a higiene do código — e torna a saída do seu agente mais limpa para a próxima iteração.