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.