Você abre a IA com uma ideia. Ela constrói outra coisa.
Seis arquivos markdown que a IA lê antes de fazer qualquer coisa. Produto, persona, dados, fluxo, métricas e integrações. Tudo definido antes do primeiro prompt. O resultado da primeira sessão já parece com o que você tinha na cabeça.
Prompt genérico. Resultado genérico. Retrabalho.
O problema não é a ferramenta. É o que você dá para ela trabalhar. Você abre o Cursor ou o Bolt com uma ideia clara na cabeça e um prompt de duas linhas. A IA constrói algo. Parece certo por alguns minutos. Depois você percebe que o fluxo está errado, a estrutura de dados não faz sentido, e a interface não é para o usuário que você tinha em mente. Você corrige. A IA corrige. O resultado fica mais confuso. Você começa de novo.
Pesquisas mostram que 19% dos praticantes de vibe coding admitem que o código gerado é frágil ou propenso a erros. O problema não é a velocidade. É que construíram rápido a coisa errada.
A causa é sempre a mesma: a IA não tem contexto suficiente. Ela não trava, não pergunta, não avisa. Ela assume. E o que ela assume raramente é o que você quer.
O Vibe Doc é o briefing que transforma prompt em produto.
É uma pasta chamada docs dentro do seu projeto. Seis arquivos markdown. Cada um cobre um aspecto diferente do que você quer construir. A IA lê essa pasta antes de fazer qualquer coisa. O resultado da primeira sessão já parece com o produto que você tinha na cabeça.
contexto.md
O produto em poucas linhas densas: problema, audiência, escopo e o que não é
personas.md
Quem usa, como usa, o que evita. A IA usa isso para decidir fluxo e interface
estruturadedados.md
As coisas que o produto guarda e como se conectam. Pense em planilha
metricas.md
O que precisa ser medido e por quê. Define o que a IA registra automaticamente
layout.md
Telas, fluxos, hierarquia. Texto, não wireframe. A IA transforma em interface
integracoes.md
Autenticação, pagamentos, APIs externas. O que o produto precisa se conectar
Se você já escreveu um PRD, você já sabe pensar em Vibe Doc. A diferença é o leitor. Um PRD é para um dev que faz perguntas. Um Vibe Doc é para uma IA que assume.
Da ideia ao protótipo que parece certo na primeira sessão.
O Lucas queria construir um app para personal trainers. Abriu o Bolt, digitou "cria um app para personal trainer" e recebeu algo genérico que não servia para nada. Perdeu duas horas.
Na segunda tentativa, passou uma hora montando o Vibe Doc. Escreveu o contexto.md, criou duas personas, estruturou os dados. Quando abriu a ferramenta, o primeiro prompt tinha três linhas e um link para a pasta docs.
Uma hora de Vibe Doc. Zero horas de retrabalho na primeira sessão.
Baixe os arquivos. Abra no editor. Comece a preencher.
Os arquivos já estão estruturados com os campos que a IA precisa ler. O kit inclui 5 exemplos completos para perfis diferentes: app B2C, ferramenta interna, marketplace, automação de processo e geração de LPs. Escolha o que mais se parece com o que você quer construir, substitua o conteúdo pelo seu produto e comece. Funciona com Cursor, Windsurf, Bolt, Lovable, Claude Code ou qualquer ferramenta de vibe coding.
O método em produção.
Esses números vêm de projetos construídos com o Vibe Doc em um laboratório de IA e automações de uma empresa de médio porte, entre 2025 e 2026.
Nenhum deles começou com um dev. Todos começaram com um Vibe Doc.
O Vibe Doc é o ponto de partida. O handbook é o método completo.
O Vibe Doc resolve o primeiro problema: a IA não sabe o que você quer. O handbook resolve o segundo: você não sabe como construir com ritmo e controle. Vibe Coding na Prática cobre o método do zero ao produto funcionando: como montar o Vibe Doc, como configurar rules e skills, como escolher a ferramenta certa, como construir funcionalidade a funcionalidade sem perder o rumo.
O último capítulo mostra o método em ação: três projetos reais, do problema ao produto em produção, com as decisões tomadas e os resultados medidos.
O que você vai saber fazer ao terminar:
- ▸Montar um Vibe Doc completo antes de abrir qualquer ferramenta
- ▸Configurar rules e skills que mantêm a IA consistente entre sessões
- ▸Escolher a ferramenta certa para o seu projeto e perfil
- ▸Construir com ritmo: uma funcionalidade por vez, versionada, documentada
- ▸Passar o projeto para um dev com documentação que ele entende sem reunião