Você abre a IA com uma ideia. Ela constrói outra coisa.
O briefing que a IA lê antes de fazer qualquer coisa: produto, pessoas, dados, fluxos, a cara do produto no padrão DESIGN.md e as decisões técnicas. Agora como skill: ela entrevista você, escreve tudo e mantém atualizado enquanto o código anda.
Em 40 segundos
Instala, pede, pronto.
Com narração e legenda. Prefere ler? O passo a passo está logo abaixo.
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, mais dois arquivos na raiz: o AGENTS.md, que todo agente lê primeiro, e o DESIGN.md, com a identidade visual. Cada arquivo cobre um assunto só. A IA lê tudo antes de fazer qualquer coisa, e o resultado da primeira sessão já parece com o produto que você tinha na cabeça.
AGENTS.mdnovo
A porta de entrada. Qualquer agente lê primeiro e sabe onde está cada coisa
DESIGN.mdnovo
A cara do produto no padrão aberto do Google: cores, tipografia, espaçamento e componentes que a IA aplica sem chutar
contexto.md
Problema, audiência, escopo, o que não é, e o critério de sucesso e de morte definidos antes de construir
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
fluxos.mdnovo
Telas, fluxos, hierarquia e estados. Texto, não wireframe. A IA transforma em interface
integracoes.md
Autenticação, pagamentos, APIs externas. O que o produto precisa se conectar
decisoes.mdnovo
Cada decisão técnica com data, alternativa descartada e motivo. A IA para de reabrir o que já foi decidido
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, pediu o Vibe Doc para a skill. Ela fez as perguntas que ele não tinha pensado: quem usa, com que mão, em quanto tempo, o que o produto não é, que número diz que deu certo. Meia hora de conversa depois, o projeto tinha o AGENTS.md, o DESIGN.md e a pasta docs completa. O primeiro prompt de construção tinha duas linhas.
Meia hora de conversa. Zero horas de retrabalho na primeira sessão.
Instala a skill. Conversa. Sai com o Vibe Doc pronto.
Em vez de seis arquivos em branco esperando você, a skill faz as perguntas certas, escreve tudo, monta o DESIGN.md e continua cuidando dos docs enquanto o produto cresce. Código aberto, grátis, no GitHub.
Claude Code, Codex, Cursor e cia.
Um comando instala a skill nas ferramentas compatíveis com o padrão aberto de Agent Skills.
npx skills add dssiqueira/skill-vibe-docSó no Claude Code, na mão
Clona o repositório e copia a pasta da skill para as suas skills pessoais.
git clone https://github.com/dssiqueira/skill-vibe-doc && cp -r skill-vibe-doc/skills/vibe-doc ~/.claude/skills/No app do Claude
Baixa o .zip da skill e envia na área de Skills das configurações.
Baixar a skill (.zip)Prefere sem agente?
Os templates e cinco exemplos completos: app B2C, ferramenta interna, marketplace, automação e gerador de páginas com IA. Todos com DESIGN.md validado pelo lint oficial do Google.
Baixar templates e exemplosDepois de instalar, é só pedir
"Cria o Vibe Doc desse projeto"
Entrevista você em blocos curtos e gera tudo.
"Atualiza o Vibe Doc com o que mudei hoje"
Lê o que mudou e mexe só nos arquivos afetados.
"Revisa o Vibe Doc"
Aponta contradição, doc atrás do código e trecho vago.
"Migra meu Vibe Doc antigo"
Transforma o layout.md em fluxos.md mais DESIGN.md.
Código, templates e exemplos em github.com/dssiqueira/skill-vibe-doc. Licença MIT.
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 com mais de 500 pessoas, 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