Vibecoding
Como dar a primeira tarefa a um agente de IA sem estrago
A primeira tarefa não é a mais útil. É a que ensina você a operar sem custar caro. Um roteiro de cinco decisões que cabe numa tarde.
A primeira tarefa que você dá pra um agente define o que você vai aprender sobre ele.
E o instinto de todo mundo é escolher errado: pega a tarefa mais valiosa, porque é a que mais dói fazer à mão.
Escolhe pelo custo do erro, não pelo tamanho do ganho.
Decisão 1: a tarefa
Três critérios, e os três precisam ser verdade ao mesmo tempo:
Reversível. Se der errado, você desfaz em minutos. Verificável. Você consegue olhar o resultado e dizer se está certo, rápido. Contida. Não toca dado de cliente identificado, não envia nada pra fora, não gasta.
Bons primeiros casos: organizar e renomear arquivos numa pasta de trabalho, compilar informação de vários documentos num resumo, preencher uma planilha a partir de textos, revisar uma lista procurando inconsistência.
Ruins: responder cliente, atualizar sistema de produção, qualquer coisa financeira.
Decisão 2: a instrução
Três partes, e a maior parte do texto vai nas duas últimas:
Objetivo. Uma frase clara do que é pra fazer.
Limite. O que ele não pode fazer, nomeado. Não apagar, não sair da pasta, não alterar arquivo original, não acessar outra fonte.
Parada. O que fazer quando não souber: parar, não adivinhar, registrar o motivo e avisar.
A parada é a parte que quase todo mundo esquece, e é a que evita o modo de falha mais comum: o agente inventa um caminho pra completar a tarefa de qualquer jeito.
Uma instrução que é dois terços limite e parada não está exagerada. Está certa.
Decisão 3: só leitura
Na primeira rodada, ele lê e propõe. Você aplica.
Parece que anula o ganho, e anula mesmo. Não tem problema: nessa fase você está avaliando o julgamento dele, não economizando tempo.
O pior caso vira uma sugestão ruim que você descarta. Exatamente o que você quer enquanto está aprendendo a operar.
Decisão 4: roda acompanhado
Primeira execução com você olhando do começo ao fim.
Você vai ver coisas que nenhum tutorial conta: ele interpreta uma palavra ao pé da letra, resolve uma ambiguidade de um jeito que você não previu, insiste onde uma pessoa desistiria.
Isso é informação sobre como escrever a próxima instrução, e ela só existe no seu caso.
Decisão 5: confere o caminho, não só o resultado
O resultado quase sempre parece bom. Erro de critério produz saída bonita.
Olha o que ele fez pra chegar lá: quais passos, em que ordem, o que decidiu não fazer.
E olha especialmente as recusas. Se ele não recusou nada em nenhum caso, provavelmente a parada não está funcionando, porque processo real sempre tem caso estranho. É o que detalhei em como revisar o trabalho de um agente.
Como ampliar depois
Um eixo por vez. Nunca dois juntos.
De leitura pra escrita, na mesma tarefa que ele já domina. Ou de acompanhado pra sozinho, mantendo só leitura.
Se você ampliar os dois ao mesmo tempo e algo der errado, você não vai saber qual mudança causou. E vai ter que voltar as duas.
O erro clássico da primeira semana
Dar a tarefa valiosa logo de cara, com acesso de escrita, rodando sozinha, porque a versão limitada "não economiza tempo".
Não economiza mesmo. Não é pra economizar. É pra você descobrir como essa ferramenta se comporta antes de ela ter poder de fazer estrago.
Uma tarde investida na tarefa chata compra a confiança pra delegar a tarefa cara.
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Como escolher a primeira tarefa?
Pelo custo do erro, não pelo ganho. Ela precisa ser reversível, ter resultado verificável em minutos e não tocar dado de cliente nem enviar nada para fora.
+O que a instrução precisa ter?
Três partes: o objetivo em uma frase, o limite dizendo o que ele não pode fazer, e a parada dizendo o que fazer quando não souber. Sem as duas últimas, o agente completa a tarefa a qualquer custo.
+Por que rodar acompanhado a primeira vez?
Porque é onde você descobre como ele interpreta a sua instrução. Ele resolve ambiguidade de formas inesperadas, e isso não aparece em nenhum tutorial, só no seu caso.
+Quando ampliar o escopo?
Depois que a mesma tarefa rodou várias vezes com resultado conferido. Amplia um eixo por vez: de leitura para escrita, ou de acompanhado para sozinho, nunca os dois juntos.
Continue lendo
Como documentar um sistema que a IA escreveu
Documentação longa ninguém escreve e ninguém lê. Existe uma versão curta que cabe em uma página e resolve 90% do problema, principalmente quando quem escreveu o código foi a IA.
VibecodingComo subir pra produção numa sexta sem medo
A regra de não subir na sexta existe porque o processo é ruim, não porque sexta é perigosa. Com quatro coisas no lugar, o dia da semana para de importar.
VibecodingO agente de código entrou no canal do time. Ver não é revisar
O Slack lançou canais onde agentes de IA programam na frente de todo mundo, com Claude, Copilot, Devin, ChatGPT e Vercel. É a melhor notícia de governança do ano e a maior armadilha de teatro de revisão.