Vibecoding
Como estruturar um projeto antes de pedir a primeira linha pra IA
Trinta minutos decidindo cinco coisas antes de abrir o chat economizam semanas de retrabalho. É a parte que todo mundo pula porque parece que não está produzindo.
A vontade é abrir o chat e pedir o sistema. Entendo, eu também sinto.
Só que existe meia hora antes disso que muda o projeto inteiro. E é a meia hora que todo mundo pula, porque parece que não está produzindo nada.
São cinco decisões. Nenhuma envolve código.
1. Quem usa isso
Não "o público". As pessoas concretas que vão abrir a tela.
É o aluno e o professor. É o cliente e o atendente. É só você.
Isso importa porque define quem enxerga o quê, que é a decisão de permissão mais cara de mudar depois. Sistema nascido sem papéis definidos vira sistema em que todo mundo vê tudo, e consertar isso mais tarde significa mexer em cada tela.
Escreve os papéis em uma linha cada. Aluno vê as próprias notas. Professor vê a turma dele. Admin vê tudo.
2. A única coisa que isso precisa fazer
Uma frase. Se precisar de duas, ainda não está decidido.
"Aluno faz simulado e recebe correção." Pronto.
Tudo que não serve a essa frase é candidato a ficar de fora da primeira versão. E vai ter muita coisa querendo entrar.
Sem essa frase, cada conversa com a IA puxa uma funcionalidade nova, e três semanas depois você tem meio sistema de cinco coisas em vez de um sistema inteiro de uma.
3. Quais dados existem e quais são sensíveis
Lista os tipos de informação que o sistema guarda. Usuário, simulado, resposta, nota, pagamento.
Marca quais são sensíveis: identifica pessoa, é financeiro, é de saúde, é jurídico.
Essa marcação decide onde a checagem de permissão precisa ser rígida e o que nunca pode sair do servidor. É a matéria-prima da camada de blindagem do Protocolo de 5 Camadas, e ela fica muito mais barata quando é decidida antes.
4. O que acontece quando falha
Escolhe agora, não no dia do problema:
- o pagamento confirma mas o e-mail não sai: o que o usuário vê
- a IA que corrige a prova não responde: fila ou erro na tela
- o upload cai na metade: o arquivo some ou fica pela metade
Você não precisa resolver os três hoje. Precisa ter decidido, porque se não decidir, a IA decide por você. E o padrão dela é sempre o mesmo: fingir que deu certo.
5. O que fica de fora
A lista mais valiosa e a que ninguém escreve.
Escreve o que a primeira versão não vai ter. Sem relatório. Sem app de celular. Sem login social. Sem painel de administração bonito.
Serve pra duas coisas. Te protege de você mesmo daqui a duas semanas, e vira instrução explícita pra IA, que por padrão sempre entrega mais do que você pediu.
Como isso vira prompt
As cinco respostas cabem em uma página. Essa página é o contexto que você cola antes de cada pedido.
A diferença é grosseira. Sem contexto, você pede "faça um sistema de simulado" e recebe o sistema genérico da internet. Com contexto, você pede a mesma coisa e recebe algo que já nasce com os papéis certos, o dado sensível marcado e o escopo cortado.
É o mesmo princípio de dar contexto pra IA, aplicado no momento em que ele rende mais: antes da primeira linha.
O custo real de pular
Pular parece economia de meia hora. Não é.
O preço aparece na terceira semana, quando você descobre que precisa mudar quem enxerga o quê e isso encosta em todas as telas. Ou quando o dado sensível está no lugar errado e mover significa refazer.
Meia hora antes, ou semanas depois. Essa é a troca de verdade.
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Isso não é burocracia que atrasa?
São trinta minutos contra semanas. Sem essas decisões, a IA assume as dela por padrão, e você descobre qual foi só quando o sistema cresce ou quebra. Refazer estrutura depois custa muito mais que pensar antes.
+Preciso escrever documento formal?
Não. Uma página com cinco respostas curtas resolve. O valor está em ter decidido, não no formato. Essa página vira o contexto que você entrega para a IA em cada pedido.
+Como uso essas decisões no prompt?
Cole a página inteira antes do pedido: papel que a IA deve assumir, o que o sistema faz, quais dados existem, o que é sensível e o que está fora do escopo. Pedido com contexto devolve código que cabe no seu caso.
+E se eu ainda não souber alguma resposta?
Escreva a dúvida em vez de fingir que decidiu. Dúvida explícita é um item de trabalho; dúvida implícita vira decisão tomada pela IA sem você saber.
Continue lendo
Como não virar refém de uma ferramenta de IA
A ferramenta que você ama hoje pode dobrar de preço, mudar de dono ou fechar amanhã. Não construa em cima de uma só.
VibecodingComo refatorar código bagunçado com IA sem quebrar tudo
Refatorar é melhorar a estrutura sem mudar o comportamento. A palavra-chave é 'sem mudar o comportamento'.
VibecodingO que fazer quando a IA te dá código que você não entende
A tentação é apertar aceitar e seguir. Não faça. Código que você não entende é código que você não mantém.