Um Pedido Grande Vira Três Pedidos Pequenos — aula do módulo O Método em Qualquer Agente, na trilha Começando com Antigravity: do Zero ao Primeiro Resultado…
Leitura de aproximadamente 4 minutos.
Módulo: O Método em Qualquer Agente · Curso: Começando com Antigravity: do Zero ao Primeiro Resultado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código
Faça um script de backup completo da minha pasta, com compactação, agendamento, rotação,
log, notificação e verificação de integridade.
Cinco assuntos em uma frase. O agente vai entregar as cinco coisas, e as cinco vão estar mais ou menos. Pior: quando alguma coisa não funcionar, você vai olhar para duzentas linhas sem saber em qual das cinco está o problema.
Não é preguiça do agente. É que você não deu como conferir nada.
Antes de escrever qualquer pedido, escreva a lista de etapas — uma linha cada:
1. Inventário — o que exatamente vai entrar no backup, e quanto pesa. 2. Compactar — gerar o arquivo com nome datado. 3. Conferir — abrir o arquivo gerado e comparar com a origem.
Agora aplique o teste a cada linha: "eu consigo olhar o resultado dessa etapa sozinha e dizer se está certo ou errado?"
Se a resposta for não, a etapa ainda está grande demais. Quebre mais.
Escreva um backup-pasta.ps1 que, por enquanto, faça só uma coisa: listar quantos
arquivos existem na pasta indicada, quanto pesam somados, e quantos foram ignorados por
regra de exclusão (node_modules,.git,bin,obj,.venv). Não compacte nada
ainda. Windows, PowerShell do sistema, sem instalar nada.
Saída medida: 17 arquivo(s) | 17.4 KB | 0 ignorado(s) por regra.
E aqui está a conferência: abra o explorador de arquivos e conte. Dezessete. Bateu. Você acabou de estabelecer uma base sobre a qual pode construir sem medo.
A expressão "por enquanto, faça só uma coisa" faz mais trabalho do que parece. Sem ela, o agente antecipa as etapas seguintes por conta própria, e você perde a conferência isolada.
Agora acrescente a compactação: gere backup-<nome-da-pasta>-AAAA-MM-DD-HHmm.zip na pasta
de destino, usando só o Compress-Archive que já vem no Windows. O padrão continua sendo
simulação — só compacta com -Aplicar. Mostre o tamanho do zip e quanto ele ficou menor
que a origem.
Saída medida: 6.9 KB | 60.4% menor que a origem.
Note que a regra de simulação continua valendo. Se você tiver o AGENTS.md da aula 1 na pasta, nem precisa repetir — mas repetir não custa nada.
Acrescente a conferência: depois de gerar o zip, abra o zip e compare arquivo a arquivo
com a origem — mesmo caminho relativo, mesmo tamanho. Liste o que está faltando ou com
tamanho diferente e devolva código de saída 1 se algo divergir. Deixe também um parâmetro
-Conferir <caminho do zip> para auditar um backup antigo sem gerar outro.
powershell -NoProfile -ExecutionPolicy Bypass -File .\backup-pasta.ps1 -Pasta .\demo -Destino .\backups -Aplicar
Saída medida: 17 arquivos no zip, 17 na origem, OK: todo arquivo da origem esta no zip, com o mesmo tamanho. Tempo total de compactar e conferir: 3,50 s.
Esta é a etapa que quase ninguém pede e a única que importa daqui a seis meses. Backup que não sabe dizer se está completo não é backup: é esperança.
Uma automação de segurança que nunca disse "não" ainda não foi testada. Crie um arquivo qualquer na pasta depois do backup e rode só a conferência contra o zip antigo:
powershell -NoProfile -ExecutionPolicy Bypass -File .\backup-pasta.ps1 -Pasta .\demo -Conferir .\backups\backup-demo-2026-08-19-1118.zip
Saída medida:
no zip : 17 arquivo(s)
na origem: 18 arquivo(s)
FALTANDO no zip (1):
- arquivo-novo-depois-do-backup.txt
Código de saída 1. Ele te disse que o backup está desatualizado, com nome e sobrenome do arquivo que ficou de fora. Confiança precisa ser verificável — e agora é.
Com as três etapas conferidas, acrescentar a quarta vira um pedido de uma linha: "mantenha só os 5 backups mais recentes na pasta de destino e apague os anteriores". Você acrescenta sem medo, porque sabe exatamente o que já estava funcionando antes.
É esse o retorno da quebra de tarefa: pedido grande é uma aposta; três pedidos pequenos são três conferências. Quando quebra, você sabe em qual das três.