O que é vibe coding? O que a pessoa deve fazer ao delegar código à IA

01Entender vibe coding como uma forma de colaboração, não como “autocompletar”

Nesta série, vibe coding significa descrever em linguagem natural a tarefa desejada, deixar a IA ajudar a ler arquivos ou criar e modificar código e, depois, fazer com que uma pessoa verifique o resultado. A ideia central não é prometer que a pessoa nunca precisará escrever uma única linha de código. Ao contrário, primeiro é preciso decidir o que será criado, quais são a entrada e a saída, até onde a ferramenta pode agir e como verificar se o resultado está correto. Como explicado no artigo introdutório sobre IA generativa “O que é IA generativa? Entenda como ela responde e por que pode alucinar”, uma resposta de IA pode parecer convincente e ainda assim divergir dos fatos ou da intenção; por isso, também na programação é mais seguro separar “geração” de “verificação”.

Portanto, a qualidade do vibe coding não depende apenas de saber escrever prompts sofisticados. É mais importante definir uma tarefa pequena, tornar visível o que a IA fez e deixar critérios que indiquem de onde retomar a revisão quando algo der errado.

02Definir o exemplo fictício de despesas que usaremos ao longo dos 8 artigos

Esta série expande progressivamente um único exemplo pequeno. O arquivo de entrada é expenses.csv, um CSV UTF-8 com as colunas date, category e amount. Os valores de category também permanecem em inglês, como food, transport e supplies. Não usamos extratos reais de cartão nem registros pessoais de despesas; usamos apenas dados fictícios como os abaixo.

date,category,amount
2026-09-01,food,12000
2026-09-03,transport,1450
2026-09-03,food,8500
2026-09-10,supplies,3200
2026-09-15,transport,1450
2026-10-02,food,9800

O primeiro objetivo é criar summarize.py para ler esse arquivo e exibir os totais mensais. Os valores esperados são 26600 para 2026-09 e 9800 para 2026-10. Em artigos posteriores, ampliaremos o exemplo com os totais por categoria de 2026-09 — food 20500, transport 2900 e supplies 3200 —, mas ainda não escreveremos código. Primeiro, praticaremos como fixar os requisitos.

03Escrever em quatro partes a entrada, a saída, o que não deve ser feito e como verificar

Se você pedir imediatamente à IA “faça um programa de despesas”, ela pode preencher por conta própria o formato do arquivo, o formato da saída, a escolha de bibliotecas e o alcance do tratamento de erros. Mesmo para uma ferramenta pequena, anotar primeiro quatro elementos deixa a conversa seguinte muito mais clara: qual arquivo é a entrada, quais valores a saída deve produzir, o que não deve ser feito e com o que a pessoa fará a comparação.

Nome da ferramenta: total mensal de um CSV de despesas

Entrada
- Arquivo CSV UTF-8 expenses.csv
- Colunas: date, category, amount
- Formato de date: YYYY-MM-DD
- amount é um inteiro

Saída
- Mostrar o total mensal junto com o mês
- 2026-09 = 26600
- 2026-10 = 9800

Não fazer
- Não usar dados pessoais reais nem dados reais de pagamento
- Não adicionar pacotes externos
- Não modificar o CSV de entrada

Como verificar
- Executar python summarize.py expenses.csv
- Comparar se os totais dos dois meses coincidem exatamente com os valores esperados acima

Esta nota não é código. No entanto, ela servirá como critério para decidir depois se uma implementação proposta pela IA saiu dos requisitos. Por exemplo, se a IA sugerir instalar pandas, isso entra em conflito com a condição “usar apenas a biblioteca padrão do Python”, então não é necessário seguir essa proposta.

04Incluir na solicitação critérios que permitam verificar a resposta correta

Ao delegar o trabalho ao Claude Code na próxima etapa, você pode enviar a nota de requisitos como está ou resumir seus pontos principais. Uma boa solicitação não termina em “crie isto”: ela inclui um exemplo de entrada, a saída esperada, as restrições e o que deve ser verificado antes de modificar arquivos. Assim, a pessoa mantém uma base para avaliar se o código criado pela IA está correto.

Planeje a criação de um script Python que leia expenses.csv e mostre o total mensal de amount.
Ainda não modifique nenhum arquivo.
As colunas de entrada são date, category, amount; date usa o formato YYYY-MM-DD e amount é um inteiro.
Use apenas a biblioteca padrão do Python.
Os valores esperados são 2026-09 = 26600 e 2026-10 = 9800.
Primeiro explique quais arquivos você leria, o que verificaria e em que ordem implementaria.

Esta solicitação ainda não autoriza a escrita do código. Ela inclui a ideia de “primeiro entender e planejar” para que o escopo possa ser revisado. A documentação oficial do Claude Code também recomenda dividir tarefas complexas em etapas e compreender o código antes de alterá-lo.

05Definir os pontos em que a pessoa deve parar e verificar

Uma ferramenta de programação com IA pode ler e modificar arquivos ou sugerir a execução de comandos. Para iniciantes, portanto, é mais importante saber “quando parar e revisar” do que “quando clicar em Yes”. Se aparecer um comando desconhecido, uma proposta para alterar vários arquivos de uma vez, uma instalação de pacote que não foi solicitada ou código que modifica o arquivo de entrada original, verifique o motivo antes de continuar.

• Verificar se apenas os arquivos dentro da pasta solicitada estão sendo usados.
• Verificar se o CSV de entrada é apenas lido e não sobrescrito.
• Verificar se a restrição de usar apenas a biblioteca padrão está sendo respeitada.
• Verificar se o formato de saída permite comparar os valores esperados 26600 e 9800.
• Pedir uma explicação do que será alterado antes de executar comandos ou modificar arquivos.

Checklists de revisão de código e testes unitários são tratados separadamente em outros artigos do Worknote, portanto não os repetimos aqui. O foco desta série é o fluxo em que a pessoa controla o escopo do trabalho e o momento das alterações ao colaborar com uma ferramenta de programação com IA no terminal.

06Resultado do primeiro artigo: concluir uma nota de requisitos de uma página

Ao terminar este artigo, ainda não é necessário instalar o Claude Code nem gerar código. Em vez disso, deve estar pronta uma nota de requisitos de uma página. No próximo artigo, usaremos essa nota para instalar o Claude Code e começaremos fazendo perguntas para que ele leia e explique a pasta de prática antes de alterar código.

Com esses critérios, mesmo que a IA explique o código em detalhes, as perguntas principais continuam simples: “ela lê a entrada que defini?, produz a saída que defini?, evita o que proibi? e eu consigo verificar o resultado?”. Basta revisar nessa ordem.

O que conferir por conta própria

Redigido com base na documentação oficial do Claude Code (consultada em 2026-09-22) e no exemplo fictício desta série · Claude Code não foi executado de fato · Não há código Python para executar

• Verificar se as 6 linhas do expenses.csv fictício e os nomes das colunas date, category, amount são os mesmos em toda a série
• Comparar manualmente os valores mensais esperados 2026-09 = 26600 e 2026-10 = 9800
• Verificar se a nota de requisitos inclui os quatro elementos: entrada, saída, o que não deve ser feito e como verificar
• Verificar se não foram usados exemplos editoriais que pareçam respostas reais do Claude Code e se não foi afirmado que ele foi executado
• Verificar se são usados apenas os tipos de bloco p, ul, code e table
• Verificar se não são repetidos os procedimentos detalhados dos artigos existentes sobre verificação e revisão de código