O que é vibe coding e como usar com critério

Vibe coding descreve uma forma de criar software conversando com uma inteligência artificial (IA). Andrej Karpathy popularizou o termo em 2025 para um estilo guiado pelo modelo. Num fluxo responsável, a pessoa mantém o objetivo, os limites e a decisão final.

Vamos acompanhar um caso concreto: uma página de inscrição para um workshop presencial. A primeira versão vai pedir nome, e-mail e sessão escolhida, recusar dados inválidos e mostrar uma confirmação. Cada seção retoma essa mesma função para separar velocidade de improviso.

Vibe coding transforma intenção em iterações

O processo começa ao descrever um resultado em linguagem natural e pedir que a ferramenta proponha código. Depois você observa o que existe, aponta uma mudança e repete. O valor não está em aceitar toda resposta, e sim em reduzir o tempo entre uma decisão e um teste.

Para a inscrição no workshop, «crie uma plataforma de eventos» abre frentes demais. «Adicione um formulário com nome, e-mail e sessão; valide os campos e confirme a vaga» define uma primeira iteração. Seu primeiro bom prompt mostra como transformar esse escopo em instruções verificáveis.

Começar por tarefas pequenas é uma heurística, não uma garantia. Algumas mudanças exigem coordenar uma migração inteira ou revisar um contrato compartilhado antes de editar. O tamanho certo depende do risco e da possibilidade de verificar o resultado.

A ideia precisa de uma pessoa e de um problema

Uma ideia útil nomeia quem age e qual dificuldade resolve. No nosso caso, uma pessoa interessada quer escolher uma sessão e saber se a inscrição foi registrada. Quem organiza precisa de dados completos, sem duplicidades nem endereços inválidos.

Escreva esse contexto antes de pedir uma interface. Assim você evita uma tela decorativa que não prevê confirmação, vagas ou mensagens de erro. Também dá para adiar funções que não pertencem ao primeiro percurso, como pagamentos, lista de espera ou acesso administrativo.

A pergunta central não é qual tecnologia parece nova. Defina qual comportamento precisa mudar para quem usa o produto. A IA pode propor componentes, mas não conhece sozinha a prioridade do workshop.

Um escopo pequeno protege a próxima decisão

O escopo estabelece o que entra e o que fica de fora. Na primeira volta, inclua campos, validação e confirmação; deixe de fora pagamentos, contas e sincronização com um provedor externo. Essa fronteira torna possível revisar a mudança numa única sessão.

Separe o trabalho quando duas tarefas não compartilham o mesmo contrato. Você pode desenhar a mensagem de confirmação enquanto outra pessoa prepara dados de exemplo, mas não convém que dois agentes alterem ao mesmo tempo o esquema de inscrição. O guia de agentes de IA explica como aplicar permissões mínimas e aprovações.

Anote também os arquivos ou áreas que devem permanecer intactos. Se o aplicativo já tem botões, campos ou regras de estilo, peça para reutilizá-los. Evitar uma segunda implementação reduz inconsistências futuras.

O primeiro rascunho é material de revisão

A ferramenta gera uma hipótese de solução, não uma verdade. Abra o formulário, faça uma inscrição e leia o código que trata os dados. Confira se a mensagem visível corresponde ao estado real e não aparece antes de salvar.

Teste entradas que contrariam o caminho feliz. Use um e-mail sem arroba, deixe o nome vazio, troque de sessão e envie duas vezes. Se o formulário aceitar um dado inválido, devolva o retorno com a ação, o resultado observado e o esperado.

Mantenha a correção dentro do mesmo escopo. Não peça uma animação ou um painel novo enquanto conserta a validação. Uma variável de cada vez permite reconhecer qual mudança resolveu a falha.

A verificação fecha cada volta

Um teste automático cobre uma regra repetível, enquanto o navegador confirma a experiência integrada. Para o workshop, um teste pode conferir que o envio sem e-mail exibe um erro; o percurso real precisa confirmar além disso o foco, o texto e o comportamento em 390 px. As duas camadas respondem perguntas diferentes.

Verifique console e rede quando o fluxo usar serviços externos. Uma confirmação visível não basta se a requisição falhar ou duplicar registros. Documente o que foi conferido e o que ficou de fora, para que a próxima iteração não parta de uma suposição.

Se a evidência estiver correta, integre a mudança e escolha a próxima tarefa. Se falhar, volte ao escopo ou ao rascunho com informação nova. O ciclo termina por critérios de aceitação, não por cansaço nem pela segurança verbal do modelo.

A responsabilidade inclui dados e permissões

O formulário lida com nomes e e-mails, então você precisa de uma finalidade clara, uma política de retenção e acesso limitado. Não cole dados reais no prompt nem use credenciais como contexto. Trabalhe com exemplos fictícios e configure segredos fora do conteúdo gerado.

A IA também não deve publicar, enviar e-mails ou alterar permissões sem autorização explícita. Ações externas podem afetar outras pessoas e são mais difíceis de reverter. Mantenha uma aprovação humana antes do deploy e de qualquer comunicação.

Em áreas como saúde, pagamentos ou decisões jurídicas, uma revisão visual é insuficiente. Some especialistas, testes de segurança e controles do domínio. Vibe coding muda a interface de criação, não o nível de responsabilidade exigido.

As falhas mais comuns têm sinais visíveis

A primeira falha é ampliar o produto antes de validar o núcleo. Se a inscrição ainda duplica registros, adicionar perfis apenas multiplica estados defeituosos. Conserte primeiro o contrato que já existe.

Outra falha é aceitar dependências ou arquitetura sem entendê-las. Peça uma explicação da mudança, avalie sua manutenção e rode os comandos do projeto. Uma solução que só funciona na sessão do agente não está pronta.

Também pode surgir código plausível com testes fracos. Leia o que cada teste afirma e force um caso que deveria falhar. Uma suíte verde só é evidência se ela verificar o comportamento combinado.

Confira a iteração antes de ampliá-la

Use estas caixas ao fechar cada volta do caso prático. Não abra a próxima tarefa antes de justificar cada resposta.

• A iteração resolve uma necessidade concreta da inscrição no workshop.
• O escopo exclui pagamentos, contas e mudanças não autorizadas.
• Estados válidos, vazios e com erro foram testados.
• O percurso funciona com teclado e em tela estreita.
• Os dados usados são fictícios e as permissões são mínimas.
• Uma pessoa revisou e autorizou o resultado antes da publicação.

Vibe coding funciona como disciplina de iteração, não como atalho para pular controles. Se você repetir ideia, escopo, rascunho e verificação com evidência, cada volta produz uma base mais clara para a decisão seguinte.