Marcus Andrey Estudo
Read in English Biblioteca

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.

AltoUsuários e dados reaisBaixo
Produção paralela

Código sem revisão em uso real. A fronteira se rompeu sem ninguém perceber.

ex.: uma demo entregue a dez usuários
Código de produção

Revisado, testado e mantido pela engenharia, e então lançado.

ex.: o recurso reconstruído, no ar
Protótipo

Rá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ários
Robustecimento

A engenharia revisa e reconstrói o que vale a pena manter.

ex.: reaproveitar o layout, reconstruir os dados
BaixaRevisão da engenhariaAlta
O vibe coding fica embaixo à esquerda; a armadilha é subir direto para o uso real sem revisão da engenharia.

Use 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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
Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar