Minha Esposa Criou um App em 20 Minutos Sem Saber Programar - A Instrução Que Ela Deu

Gravei o processo completo (screencast): instrução dela → instalação de dependências → script sendo escrito → teste funcionando → o ajuste que ela pediu.

Minha esposa estava estudando para um concurso.

Ela tinha baixado um monte de apostilas em PDF, mas ler texto em fundo branco por horas cansava os olhos. Ela queria aplicar efeito sépia nas páginas, aquele fundo amarelado que o Kindle usa.

Eu falei: tenta fazer você mesma.

Ela nunca tinha escrito uma linha de código. Mostrei o Claude Code, expliquei em um minuto como funciona: "você descreve o que quer, ele constrói" - e saí do quarto.

Vinte minutos depois, ela tinha um script funcionando que processou todos os PDFs de uma vez.

Na primeira instrução. Sem erro. Sem retrabalho.

O que eu quero te mostrar não é que isso é possível, você provavelmente já sabe. É a instrução que ela deu e por que ela funcionou, enquanto a maioria das pessoas tentaria a mesma coisa e entraria num loop de iterações.

A instrução que a maioria daria seria:

O Claude Code vai executar isso. Mas vai tomar uma série de decisões por conta própria: qual biblioteca Python usar, como nomear o arquivo de saída, se sobrescreve o original ou cria um novo, qual tom específico de sépia.

Cada decisão não dita é uma fonte potencial de retrabalho.

Você recebe o resultado, algo não está como esperava, pede para ajustar. Ele ajusta uma coisa e assume outra. Mais uma rodada. O problema não é o Claude é que a instrução deixou espaço demais para interpretação.

Objetivo descreve o que você quer chegar.
Comportamento descreve como você quer que as coisas funcionem no caminho.

O agente precisa do segundo para executar sem chutar.

Ela não sabia o nome técnico de nada. Não sabia o que era "argumento de linha de comando" ou "parâmetro". Mas descreveu exatamente como queria que a ferramenta se comportasse:

Repara no que está nessa instrução:

Sem jargão técnico. Só precisão sobre o comportamento.

O Claude Code perguntou se ela queria instalar as dependências necessárias. Ela confirmou. Ele instalou, escreveu o script, rodou um teste. Funcionou na primeira execução.

Ela ainda pediu um ajuste queria poder passar a intensidade da cor como parâmetro também. Ele atualizou. Testou. Funcionou. Ela processou todas as apostilas de uma vez.

O que fez a instrução dela funcionar é replicável em qualquer problema. Três campos:

Não é sobre vocabulário técnico. É sobre não deixar o agente adivinhar nas partes que importam para você.

Exemplo 1 - Renomear arquivos em lote:

❌ Vago: "renomeia as fotos da pasta"

✅ Com comportamento: "renomeia todos os arquivos .jpg nessa pasta seguindo o padrão AAAA-MM-DD-nome-original, usando a data de modificação do arquivo. Não sobrescreve — cria cópia na subpasta 'renomeados'."

Exemplo 2 - Consolidar planilhas:

❌ Vago: "junta todos os arquivos Excel"

✅ Com comportamento: "lê todos os arquivos .xlsx nessa pasta, extrai a coluna 'Valor Total' de cada um e gera um CSV consolidado com o nome do arquivo como primeira coluna e o valor como segunda."

Exemplo 3 - Converter formato:

❌ Vago: "converte os textos em PDF"

✅ Com comportamento: "converte cada arquivo .txt nessa pasta em PDF com fonte Arial 12, margens de 2cm e o nome do arquivo como título centralizado na primeira página."

Mesmo padrão nos três: você descreve o comportamento, não só o objetivo.

Vai acontecer. E a reação errada é repetir a mesma instrução com outras palavras.

❌ "não ficou certo, tenta de novo"

Isso não dá ao Claude nenhuma informação nova. Ele vai tentar de novo com o mesmo entendimento e provavelmente chegar no mesmo lugar.

O que funciona é descrever o gap entre o que aconteceu e o que você esperava:

✅ "o arquivo de saída está sobrescrevendo o original em vez de criar um arquivo novo. Quero que o arquivo original seja preservado e o arquivo de saída tenha o sufixo '-sepia' no nome."

Comportamento atual + comportamento esperado.

Se aparecer uma mensagem de erro no terminal, cole ela diretamente e diga "isso aconteceu quando rodei o script." O Claude lê o erro, identifica a causa, e corrige sem você precisar entender o que o erro significa.

Se você quer tentar isso agora, o caminho mais curto:

Funciona melhor para problemas com entrada, saída e comportamento descritível:

Não use para: ferramentas que outras pessoas vão usar, sistemas com dados sensíveis ou que precisam de segurança — esses precisam de revisão técnica que o agente não substitui.

Antes de abrir o Claude Code, escreva em papel ou no bloco de notas:

Só abra o terminal depois de ter isso respondido.

Cole sua instrução completa. Confirme quando ele pedir para instalar dependências.

Se o resultado não for o esperado:

Sempre peça para testar em um único arquivo primeiro.

Isso evita processar 50 arquivos e descobrir que o output não é o que você queria.

O script da minha esposa funciona. Ela usa todo dia.

Mas tem um limite que vale ser explícito: é uma ferramenta pessoal para um problema específico. Se der problema, ela não consegue depurar sozinha além do básico (descrever o erro pro Claude).

Para ferramentas pessoais, automações que só você usa, scripts que resolvem um problema seu Claude Code pode entregar na primeira tentativa ou com poucas iterações.

Para sistemas que outras pessoas vão usar, com validação de dados, segurança ou lógica de negócio complexa, você vai precisar de revisão técnica em algum ponto. O agente não substitui esse julgamento.

Saber essa linha é o que separa uso bem-sucedido de frustração.

Processamento de arquivos:

Consolidação de dados:

Renomeação em lote:

Adriano Viana
Master Architect | AI-Native Content Creator