Ideia principal

Duas maneiras de pedir a mesma coisa a um assistente como o Claude Code: mandá-lo organizar os arquivos de um diretório direto no contexto dele, ou mandá-lo escrever o script Python que os organiza. O resultado visível é idêntico — os arquivos estão organizados. O que fica para trás não é.

No primeiro caso, a operação não existe em lugar nenhum: você não pode relê-la, nem saber o que foi feito com o quinquagésimo arquivo, nem repeti-la no mês seguinte sem pedir de novo. No segundo, o assistente produz um objeto inspecionável — a regra de organização está escrita, dá para ler em dois minutos, dá para corrigir, dá para rodar de novo em outros arquivos, e ela dá o mesmo resultado a cada execução.

O deslocamento é sobre o que você delega. Você não delega mais a execução, delega a escrita da regra de execução — e é essa regra, não o resultado dela, que vira o objeto a verificar.

Por que isso importa

Isso dá um critério para escolher a forma de uma delegação, antes de escolher o modelo ou o prompt: assim que uma operação precisa se repetir, incidir sobre um volume que você não vai reler, ou ser justificada depois, a saída certa é o script, não o resultado.

Isso também explica por que esse tipo de delegação continuava confortável: o perímetro era delimitado, a saída era curta, e a verificação cabia na releitura de uma função. A passagem para um produto completo — telas, APIs internas, alterações de dados — derruba essa propriedade sem que nada anuncie a mudança de regime.

Nuances e limites

A regra só vale para operações determinísticas. Uma organização por extensão se escreve em script; uma classificação que exige julgar o conteúdo de cada arquivo não se escreve, e forçar o script equivale a congelar um critério ruim.

E o script desloca a verificação sem eliminá-la: um script correto na amostra de teste pode errar no resto, exatamente como a execução direta.

Questões em aberto

• A partir de que volume de código gerado a saída deixa de ser inspecionável, e o que é preciso produzir então no lugar do script para manter a mesma propriedade de verificação?