Como planejar um projeto de software antes do vibe coding

Antes de escrever a primeira linha de um projeto novo, mande a ideia crua para a IA e peça 3 coisas, nessa ordem: concorrentes que já fazem aquilo, a complexidade de execução, e um desenho das etapas. As 3 respostas juntas sustentam uma decisão só, que é seguir com o projeto ou largar a ideia antes de gastar semana nenhuma nela.

Guilherme Saraiva descreveu esse procedimento ao vivo depois que alguém no chat perguntou o que deveria estudar para conseguir desenvolver melhor os próprios projetos. Ele recusou a pergunta do jeito que veio:

não existe algo muito pontual, tá ligado, que você tem que estudar. O o que eu acho que você tem que focar é em esclarecer suas ideias antes de mandar

A ideia não precisa estar perfeita, completou ele, mas "precisa tá bem estruturada". O que ele chama de estruturar tem etapas, e todas acontecem fora do editor de código.

As 3 perguntas que vêm antes da primeira linha

Ele abre o Excalidraw, um quadro branco onde dá para desenhar qualquer coisa, e manda a ideia do projeto para o assistente que estiver usando. Qual assistente é indiferente, e ele fez questão de dizer isso no ar: "mas pode ser o Codex, pode ser qualquer um".

A primeira pergunta é sobre quem já está no mercado:

E aí eu peço para ele buscar eh concorrentes que já fazem isso, né? Foi assim que surgiu o projeto do RPG.

O projeto de RPG que ele estava construindo na live nasceu dessa varredura. Ela devolveu um mercado ocupado e com defeito conhecido, que é o resultado mais aproveitável dessa pergunta:

O mercado de RPG com IA, ele é muito problemático. Primeiro porque a IA é burra para isso, eh, para imaginar o mundo inteiro, que é o que acontece em uma partida de RPG. E então ela precisa estar muito bem alimentada com muito contexto, com muita história e ela às vezes se perde, ela esquece das coisas.

A isso ele somou o preço, já que os sistemas de RPG com IA que existem hoje cobram em dólar. Durante a live ele passou um tempo dentro do Friends and Fables olhando o que aquele produto faz para trazer coisa para o dele, que é o uso prático de uma lista de concorrentes.

A pergunta seguinte é sobre o custo de construir:

eu peço para ele me explicar a complexidade de execução

A resposta dele para o próprio projeto é comparativa. Os trabalhos que ele entrega na agência ficam num nível, e o RPG fica em outro, com motor de regras e cerca para a IA não sair inventando:

E o bagulho do RPG é tipo aqui em cima, tá ligado? Porque tem sistema de motor, tem que fazer ele entender as regras, tem que tipo criar várias barricadas para ele não sair indo pro além

Ele estava com 20 dias de projeto quando decidiu abrir a construção em público.

O roadmap de planejamento vem antes do roadmap de execução

Com a complexidade medida, vem a terceira pergunta, e ela carrega uma restrição que muda o que a IA devolve:

eu peço para ele desenhar um fluxo de para eu me organizar em o que eu vou fazer em cada etapa, como se fosse um roadmap, tá ligado? Só que de planejamento, senão de execução

Roadmap de execução é a lista de tarefas de um projeto que já foi aprovado. O de planejamento é o mapa do que teria que existir para a coisa ficar de pé, pedido enquanto a decisão de construir ainda está aberta. Com ele na tela dá para medir o tamanho do trabalho e desistir a tempo. O critério de decisão vem logo depois, na frase mais curta do trecho todo:

E aí com isso eu vejo se faz sentido ou não seguir aquele projeto.

Os 2 roadmaps convivem no material dele. O de execução do RPG é um HTML que ele mesmo fez e abre no meio da live para conferir o que já saiu, com a barra marcando 65% concluído. Esse arquivo existe porque a decisão já foi tomada. O de planejamento existiu antes, quando ainda dava para não fazer nada. Foi o mesmo caminho de documentacao de software. O mesmo problema apareceu em mvp projeto. Foi o mesmo caminho de como nao desistir de um projeto com vibe coding. Isso aparece também em software como serviço. Isso aparece também em backup wordpress.

O mesmo canvas vira o briefing do vibe coding

O material do planejamento não é jogado fora quando a decisão sai positiva. O quadro que a IA montou durante as 3 perguntas é o que ele leva para a etapa de código, "um blank canvas com informações para mandar para que eu for usar para codar".

O Excalidraw tem MCP próprio, então dá para plugar o assistente direto no quadro. A IA desenha o planejamento ali e explica o que desenhou. Ele redesenha por cima, avisa que mexeu e pede "analisa aí, vê se faz sentido", e ela responde em cima do desenho novo. A descrição dele do resultado:

é um ambiente que os dois estão coabitando

Entre a ideia na sua cabeça e o prompt que você consegue escrever tem uma distância, e é nela que se perde quem constrói com vibe coding. É assim que o vibe coding funciona na prática. O desenho ocupa esse meio: você olha a coisa inteira antes de tentar descrever a coisa inteira, e a descrição sai mais organizada porque está no quadro na sua frente. Vale ver como isso terminou em o que e prd.

Rode as 3 perguntas na ideia que está parada

Pegue aquela ideia que você adia há semanas e passe as 3 perguntas nela antes de abrir o editor. Quem já faz isso, o que se aprende com o defeito do produto deles, quanto custa executar comparado ao que você já entregou, e como seria o mapa do que precisa existir. Sem código, sem escolher stack, sem comprar domínio.

O maior ganho está no caso em que a resposta é não, porque a ideia cai com dado na mão e a próxima entra na mesma peneira. Qual IA vai executar cada tarefa do seu projeto é uma decisão que tem que estar clara desde o começo. O viés do orquestrador de IA trata exatamente esse risco: um pedido de teste de modelo continua pesando nas decisões depois que o teste terminou. Mostrar o critério de descarte no ar, incluindo o que fez o RPG passar, é o que as leis do movimento cobram de quem constrói em público. Dá para assistir à live e ouvir a sequência inteira, com a pergunta do chat que puxou o assunto e a demonstração do quadro ao vivo.