Framework · IA e design · 4 min de leitura
Vibe coding vs. código de produção
Código rápido gerado por IA é ótimo para protótipos e arriscado como código de produção sem revisão. Use isto para deixar a fronteira explícita: onde os protótipos ficam, como são rotulados e quem decide o que vai para produção.
Código sem revisão em uso real. A fronteira se rompeu sem ninguém perceber.
ex.: uma demo entregue a dez usuáriosRevisado, testado e mantido pela engenharia, e então lançado.
ex.: o recurso reconstruído, no arRápido, rotulado, só com dados de exemplo. O lugar certo para o vibe coding.
ex.: um protótipo em código para testes com usuáriosA engenharia revisa e reconstrói o que vale a pena manter.
ex.: reaproveitar o layout, reconstruir os dadosUse quando
- Os designers agora conseguem construir protótipos em código que funcionam com IA, e os stakeholders perguntam "dá para colocar isso no ar logo?"
- Um protótipo começou a ser usado por usuários reais ou com dados reais, e ninguém revisou o código.
- Você está montando um fluxo de prototipação do time e precisa combinar as regras com a engenharia.
Como usar
- Combine a fronteira com a engenharia. Escreva um conjunto curto de regras com o seu líder de engenharia: o que conta como protótipo, onde ele fica e quem decide o que avança. O UX lead define a fronteira do lado do design; a engenharia é dona da arquitetura e da produção. Resultado: algumas linhas acrescentadas às suas diretrizes de uso de IA.
- Mantenha os repositórios de protótipos separados. Construa protótipos em repositórios ou pastas próprios, não no código de produção, a menos que a engenharia decida outra coisa. Resultado: um lugar com nome para os protótipos.
- Rotule todo protótipo. Coloque um rótulo visível de "protótipo, não produção" em todo protótipo gerado, e no link ou no título da demo. Use só dados de exemplo anonimizados, nunca dados de produção. Resultado: um rótulo e um conjunto de dados de exemplo.
- Use protótipos para aprender. Use o protótipo para aquilo em que ele é bom: testar fluxos com usuários, mostrar uma direção aos stakeholders, achar estados e casos extremos. Registre o que você aprendeu na especificação. Resultado: achados de teste e uma especificação atualizada.
- Entregue pela especificação, não pelo código. Quando a direção estiver certa, dê à engenharia a especificação, os achados e o protótipo como referência. A engenharia decide se algum código é reaproveitado, e que revisão e testes ele precisa. Resultado: uma decisão da engenharia: reconstruir, robustecer ou reaproveitar partes.
Exemplo prático
Uma plataforma interna de operações com 6 times de produto. Uma designer constrói em dois dias um protótipo em código, funcionando, de um novo quadro de despacho. O gerente de operações adora e pede para entregá-lo a dez despachantes na semana seguinte.
| Pergunta | Protótipo feito com vibe coding | O que a produção precisa |
|---|---|---|
| Dados | Dados de exemplo anonimizados | Pedidos reais, com controle de acesso e auditoria |
| Revisão de código | Nenhuma | Revisão da engenharia, testes, verificações de segurança |
| Acessibilidade | Conferida em screenshots | Testes completos de teclado e leitor de tela |
| Tratamento de erros | Só o caminho feliz | Erros, timeouts, falhas parciais |
| Dono | A designer | Um time de produto que faz a manutenção |
O UX lead diz sim a um teste supervisionado com três despachantes usando dados de exemplo, e não ao uso real. A engenharia revisa o protótipo, reaproveita os componentes de layout e reconstrói a camada de dados. O quadro de despacho vai ao ar seis semanas depois, e o protótipo continua rotulado no próprio repositório.
Cuidado com
- "Funciona, coloca no ar." Um protótipo que funciona numa demo não tratou erros, segurança, desempenho nem acessibilidade. Funcionar não é o mesmo que estar pronto.
- Dados reais em protótipos. Conectar um protótipo a dados de produção o transforma num sistema de produção sem revisão. Use só dados fictícios anonimizados.
- Protótipos no repositório de produção. Código gerado misturado ao código de produção é difícil de achar e remover depois. Mantenha separado.
- Designers decidindo sobre produção. Os designers são donos da experiência; a engenharia decide que código vai para produção. Deixe isso claro antes da primeira demo.
Modelo
Copie isto para as diretrizes do seu time e combine com o seu líder de engenharia.
Regras de protótipo Combinado com: Em:
Um protótipo é: código gerado por IA ou feito à mão para aprender ou mostrar uma direção
Fica em: <repositório ou pasta de protótipos>, nunca no código de produção
Rótulo: "Protótipo, não produção" visível na tela e no título
Dados: só dados de exemplo anonimizados; nunca dados de produção
Usado para: testes com usuários, demos para stakeholders, achar estados e casos extremos
Não usado para: trabalho real de usuários reais
Caminho para a produção
Entrega: especificação + achados + protótipo como referência
Decidido por: líder de engenharia
Opções: reconstruir / robustecer / reaproveitar partes
Obrigatório antes do lançamento: revisão de código · testes · segurança · acessibilidade