Manifesto Vibe Coding

Vibe
Coding
com método.

A IA acelera o código. O método protege o produto. Este manifesto transforma velocidade em direção, prompts em decisões e geração em engenharia.

12 etapasHuman in the LoopGates de validaçãoSpecs vivas
NÃO TERCEIRIZE O PENSAMENTO PARA A IA — USE A IA PARA AMPLIFICAR DECISÕES — CONTEXTO ANTES DE CÓDIGO — VALIDE ANTES DE ESCALAR — DOCUMENTE O QUE MUDOU —    NÃO TERCEIRIZE O PENSAMENTO PARA A IA — USE A IA PARA AMPLIFICAR DECISÕES — CONTEXTO ANTES DE CÓDIGO — VALIDE ANTES DE ESCALAR — DOCUMENTE O QUE MUDOU —
01 / 12

Saiba o que está construindo.

Antes de pedir código, crie um argumento. Produto sem direção vira uma coleção de features geradas.

O primeiro prompt não é para programar.É para definir problema, público, promessa e fronteiras.
Definir o problema principal.
Definir para quem o produto existe.
Definir o resultado esperado.
Definir o que não faz parte do MVP.
02 / 12

Pesquise antes de inventar.

Best in class não é para copiar interface. É para entender padrões, expectativas e lacunas.

Mapear produtos de referência.
Entender o que fazem bem e mal.
Mapear padrões de UX e feature-set.
Identificar oportunidades pouco exploradas.

A pesquisa reduz alucinação de produto.

03 / 12

Visualize antes de implementar.

Uma ideia conceitual transforma abstração em algo que pode ser criticado, comparado e melhorado.

Se você ainda não consegue mostrar a experiência, ainda é cedo para codificar a experiência.
Criar referência visual.
Criar wireframe ou conceito.
Definir jornada principal.
Eliminar complexidade antes do código.
04 / 12

PRD diz o quê. ADR diz como. Gates dizem quando.

Transforme intenção em contrato de execução.

PRD→ADR→Gates→Critério de aceite
Documentar escopo e requisitos no PRD.
Registrar decisões e trade-offs no ADR.
Quebrar implementação em Gates pequenos.
Definir aceite antes de escrever código.
05 / 12

Antes do build, ataque o plano.

O Red Team existe para encontrar o que você ainda está confortável demais para enxergar.

Peça para a IA quebrar o PRD e o ADR antes que usuários quebrem o produto.Segurança · edge cases · abuso · privacidade · performance · day one
Questionar premissas do produto.
Procurar vulnerabilidades e abusos.
Classificar riscos por severidade.
Revisar PRD e ADR após o ataque.
06 / 12

Dê contexto ao agente. Não dê liberdade infinita.

Um agente de código sem fronteiras otimiza pela execução. Você precisa otimizar pelo produto.

Fornecer PRD, ADR e Gate atual.
Definir arquivos que pode alterar.
Bloquear implementação de Gates futuros.
Exigir justificativa para dependências e mudanças arquiteturais.

Contexto é parte da arquitetura.

07 / 12

Padronize antes que a geração vire entropia.

Coding Guidelines são a memória operacional da codebase.

Manter CODE_GUIDELINES.md.
Manter STACK.md e finalidade das dependências.
Definir padrões de estrutura, nomes, erros e imports.
Evitar arquivos gigantes, duplicação e abstração prematura.
08 / 12

IA gera. Humano valida. Gate libera.

A velocidade da IA não elimina o julgamento humano. Ela aumenta a importância dele.

Código→Explicação→Human in the Loop→Validação→Checkpoint
Revisar o que foi criado e modificado.
Executar e validar manualmente.
Comparar com critérios do Gate.
Só avançar depois da aprovação humana.
09 / 12

Valide o comportamento, não apenas o build.

“Compila” não é sinônimo de “funciona”. E “funciona” não é sinônimo de “está correto”.

Testar happy path e caminhos alternativos.
Testar limites, erros e estados vazios.
Verificar console, network e warnings.
Evitar regressões em Gates anteriores.

Cada Gate precisa provar que merece existir.

10 / 12

Corrija a casa antes de construir outro andar.

A dívida acumulada pela geração rápida precisa ser removida continuamente.

Remover código morto e duplicado.
Remover dependências e arquivos desnecessários.
Resolver TODOs, FIXMEs e logs de debug.
Refatorar apenas com intenção clara.
11 / 12

Escala começa na legibilidade da codebase.

A infraestrutura não serve apenas à máquina. Ela precisa servir ao humano e ao próximo agente.

Speed + Codebase + Specs.Velocidade sustentável exige estrutura sustentável.
Separar responsabilidades.
Automatizar lint, testes e build.
Revisar performance, segurança e dependências.
Garantir que novos agentes entendam a codebase.
12 / 12

O código muda. A especificação precisa mudar junto.

Specs não são arquivo morto. São a versão legível do sistema que realmente existe.

PRD→Gate→Código→Validação→Specs→PRD
Comparar implementação com o PRD original.
Atualizar decisões, limitações e regras descobertas.
Atualizar ADR, STACK e guidelines quando necessário.
Garantir que código e documentação contem a mesma história.

Vibe coding não é ausência de processo.

É um processo novo: mais rápido, mais iterativo e mais dependente de contexto explícito. O objetivo não é pedir para a IA “fazer um app”. O objetivo é criar um sistema em que cada decisão possa ser explicada, cada Gate possa ser validado e cada linha gerada tenha um motivo para existir.

Manual de desenvolvimento com IABuild fast. Validate hard.