brainax

Primeiro o plano: uma página

Aula 5 de 26 do curso “Vibe coding”. Grátis, com animações e teste.

Por que planejar antes do código

A IA não lê mentes. O que você não diz, ela inventa, e muitas vezes não do jeito que você queria. Você pede “um app para a academia” e recebe um app com pagamento, chat e ranking, quando só queria marcar treinos. Depois, meio dia refazendo. Um plano curto antes da primeira linha de código economiza mais tempo do que gasta. Parece chato, mas são cinco minutos.

Uma especificação de uma página

A especificação é uma descrição curta do que você vai construir. Um pedido da lição anterior descreve um passo; a especificação descreve o projeto inteiro. Cinco linhas. Objetivo: uma frase sobre para que serve. Para quem: quem vai usar. Três funções principais. O que não fazemos agora. Pronto quando: os sinais de que deu certo. Na imagem há um exemplo para um app de treinos.

Três funções e “agora não”

MVP, produto mínimo viável: a menor versão que já é útil. Para o app de treinos são três funções: marcar um treino, ver a sequência de dias seguidos, ver estatísticas simples. A linha “o que não fazemos agora” importa tanto quanto: pagamento e chat podem esperar. Erro comum: colocar vinte funções de uma vez. O projeto afunda e nada fica pronto.

“Pronto quando…”

A última linha é um checklist curto, ou seja, uma lista de itens para ir marcando. Exemplo: “abre e funciona bem no celular”, “o treino marcado continua lá depois de recarregar a página”, “um amigo conseguiu se cadastrar sozinho”. Sem essa linha dá para melhorar o projeto para sempre. Com ela, você sabe quando parar e publicar.

Primeiro o plano, depois o código

Passe a especificação para a IA e peça para ainda não escrever código: “Proponha uma estrutura do projeto e divida o trabalho em passos.” Leia a resposta. Se a IA colocou coisa a mais ou entendeu algo errado, corrija o plano agora, enquanto são só umas linhas de texto. Depois, passo a passo: esqueleto, ou seja, a estrutura vazia da página, primeira função, segunda, publicação. Guarde a especificação no projeto e mande para a IA em cada chat novo.

Teste-se

  1. Para que serve a linha “o que não fazemos agora”?
    Resposta certa: Para você e a IA não gastarem esforço com extras. Sem ela, a IA adiciona pagamento, chat e mais por conta própria. Um “não” explícito mantém o projeto pequeno e terminável.
  2. O que é um MVP?
    Resposta certa: A menor versão que já é útil. MVP: produto mínimo viável. Já resolve a tarefa principal; o resto vem depois.
  3. A especificação está pronta. O que pedir primeiro à IA?
    Resposta certa: Propor estrutura e passos, ainda sem código. Primeiro veja como a IA entendeu a tarefa. Corrigir um plano curto é mais fácil que reescrever código pronto.

← Como passar uma tarefa para a IA Chaves e segredos →