A Faxina de Pasta: Seu Primeiro Resultado em 40 Segundos

A Faxina de Pasta: Seu Primeiro Resultado em 40 Segundos — aula do módulo Primeiro Resultado em 10 Minutos, na trilha Começando com Antigravity: do Zero ao…

Leitura de aproximadamente 4 minutos.

Módulo: Primeiro Resultado em 10 Minutos · 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

A Faxina de Pasta: Seu Primeiro Resultado em 40 Segundos

O que você vai aprender

Como pedir um script que classifica, renomeia e move arquivos por categoria.
O que é modo de simulação e por que ele é inegociável em script que mexe em arquivo seu.
Os números reais de execução: 15 arquivos, 7 categorias, menos de um segundo.
O que fazer quando o resultado sai diferente do esperado.

1. O problema que todo mundo tem

Abra sua pasta de Downloads. Provavelmente existem ali arquivos como Contrato Final (2).pdf, IMG_20250714_183422.jpg, Sem título.txt e apresentacao FINAL final.pptx, todos soltos, sem ordem nenhuma. Ninguém arruma porque arrumar à mão leva meia hora e volta a bagunçar em duas semanas.

Este é o exercício perfeito para começar: o resultado é visível em segundos, e o risco é zero — desde que você respeite a regra da seção 3.

2. A pasta de treino

Antes de qualquer coisa, não use sua pasta de Downloads real. Trabalhe numa pasta de treino, com arquivos descartáveis. Se você baixou o kit desta trilha, o script semear-demo.ps1 cria essa pasta pronta, com 15 arquivos de nomes propositalmente feios.

No seu computador, PowerShell:


powershell -NoProfile -ExecutionPolicy Bypass -File .\semear-demo.ps1 -Destino "$env:USERPROFILE\Desktop\demo"

O script não sobrescreve nada: se a pasta demo já existir, ele para e avisa. Para refazer o exercício do zero, apague a pasta antes.

3. O pedido, na íntegra

Abra a pasta demo no editor e cole este texto no painel do agente. Cole inteiro, sem resumir — cada parágrafo dele existe por um motivo:

Nesta pasta existe uma subpasta downloads-bagunca com arquivos soltos. Escreva um

script PowerShell chamado organizar-pasta.ps1 que classifique cada arquivo por tipo

(imagens, documentos, planilhas, slides, vídeos, compactados, instaladores), crie uma

subpasta por categoria, e mova cada arquivo renomeando no padrão

AAAA-MM-DD-nome-em-minusculas.ext, usando a data de modificação do arquivo. Acentos

viram a letra sem acento; espaços e símbolos viram hífen.

Regra mais importante: o padrão é simulação. Sem parâmetro, o script apenas imprime

uma tabela com categoria, nome de origem e caminho de destino, e não escreve nada em

disco. Só executa de verdade com o parâmetro -Aplicar.

Restrições: precisa rodar no Windows com o PowerShell que já vem no sistema, sem instalar

nada, sem pip, sem npm, sem conta e sem chave de API.

Repare na estrutura do pedido — ela se repete em todas as automações desta trilha:

1. O que entra: os arquivos soltos de downloads-bagunca. 2. O que sai: subpastas por categoria, com nomes padronizados. 3. O que é proibido: escrever em disco sem -Aplicar, instalar qualquer coisa.

Esse terceiro item é o que separa um brinquedo de uma ferramenta. Sem ele, o agente entrega algo que funciona na máquina dele e falha na sua.

4. Rodar, primeiro sem risco

O agente pode executar sozinho, ou você roda no terminal integrado:


powershell -NoProfile -ExecutionPolicy Bypass -File .\organizar-pasta.ps1 -Pasta .\downloads-bagunca

Saída medida na construção desta aula: 15 arquivo(s) em 7 categoria(s). Aparece uma tabela com três colunas — Categoria, De, Para — e nada foi movido. Leia a tabela com calma. É neste momento, e só neste, que corrigir sai de graça.

Quando a tabela estiver do seu gosto, execute de verdade:


powershell -NoProfile -ExecutionPolicy Bypass -File .\organizar-pasta.ps1 -Pasta .\downloads-bagunca -Aplicar

Saída medida: 15 arquivo(s) organizado(s). No explorador de arquivos, as 7 pastas apareceram e os nomes viraram algo como 2026-08-18-contrato-final-2.pdf.

5. Os números reais

Estes tempos foram medidos numa máquina comum com Windows 11, usando o PowerShell 5.1 que já vem no sistema, e revalidados no PowerShell 7.6.5:

| Etapa | Tempo | |---|---| | Criar a pasta de treino com 15 arquivos | 0,82 s | | Simulação, 15 arquivos | 0,77 s | | Aplicar, 15 arquivos em 7 categorias | 0,64 s |

A execução é instantânea. O tempo que você vai sentir é o do agente escrevendo o script — isso depende do modelo e da máquina, e costuma ficar entre alguns segundos e um minuto para as ~120 linhas que esse script tem.

6. Quando sai diferente do esperado

Três situações comuns, e o que dizer:

Categorizou errado. "O arquivo .psd foi para 'Outros'. Trate .psd, .ai e .svg

como imagens."

O nome ficou estranho com acento. Isso aconteceu de verdade na construção do material

e é o assunto da aula 4 desta trilha.

Ele aplicou sem você pedir. Peça de volta: "O padrão precisa ser simulação. Sem

-Aplicar, o script não pode escrever nada em disco." E confira você mesmo se o comportamento mudou, rodando sem o parâmetro.

Resumo

Todo pedido útil declara entrada, saída e proibições.
Script que move ou apaga arquivo nasce simulando; aplicar é uma decisão sua, explícita.
A simulação é o único momento em que corrigir é barato — leia a tabela antes de aplicar.
Treine em pasta descartável antes de apontar qualquer automação para arquivo que importa.

A Faxina de Pasta: Seu Primeiro Resultado em 40 Segundos