O ciclo: contexto → plano → geração → revisão
Vibe coding parece improviso de fora, mas tem um método. No ClubPetro a gente repete um ciclo de quatro fases em quase toda tarefa. Pular fase é a causa nº1 de resultado ruim. Vamos por partes.
Fase 1 — Contexto
A regra de ouro: contexto vence prompt bonito.
Antes de pedir qualquer coisa, você alimenta a IA com o que ela precisa saber: o arquivo relevante, a tabela envolvida, o comportamento esperado, a convenção do projeto. No nosso caso, o CLAUDE.md do repo já entrega um monte de contexto automático (arquitetura, regras de RLS, pegadinhas).
"Arruma o bug do login" rende pouco. "No auth do apps/web, o callback do Google OAuth está perdendo a sessão quando X" rende muito.
Fase 2 — Plano
Em tarefa grande, peça o plano antes do código.
Ler um plano de 10 linhas e corrigir o rumo custa minutos. Revisar 400 linhas geradas no caminho errado custa horas. Por isso usamos o plan mode: a IA propõe os passos, você ajusta, e só então ela executa. É o ponto mais barato pra mudar de ideia.
Fase 3 — Geração
Passos pequenos batem passo gigante.
Em vez de "constrói a feature inteira", a gente quebra: primeiro o procedimento tRPC, depois o componente, depois o ajuste fino. PR pequeno é PR que dá pra revisar de verdade — e PR que dá pra revisar é PR que não esconde bug.
Fase 4 — Revisão
Aqui o humano manda.
Você lê o que foi gerado com olho crítico: faz o que devia? segue os padrões? introduz risco? mexe em dado sensível? Só depois vai pro fluxo de PR (onde o AI Code Review e a aprovação humana fecham a conta — assunto do #38).
O ciclo é um loop, não uma linha
Revisão reprovou? Volta pro contexto (faltou explicar algo) ou pro plano (a abordagem estava errada). Cada volta deixa a IA mais alinhada. A "vibe" é justamente esse vai-e-volta fluido entre as quatro fases.
⚠️ Armadilha #3: pular o plano em tarefa grande pra "ganhar tempo". É a economia que mais custa caro — você descobre que estava no caminho errado depois de 400 linhas, não antes.
Próximo da série: #04 — O arsenal: visão geral do nosso stack de IA.