Prova de que a tarefa foi feita no vibe coding: exija o print

No vibe coding, terminei nao e entregavel. O agente orquestrador reescreveu o criterio de aceite depois da 2a falha: so vale screenshot com o texto na tela do emulador.

Martin estava construindo o Fumava, um app para parar de fumar, e pediu ao agente uma tela de onboarding. O agente entregou uma tela desenhada, Martin olhou e pediu que o agente de design melhorasse o contraste. Na segunda tentativa a tela ficou melhor, e Martin aproveitou a interação para reescrever o critério de aceite.

Antes ele era genérico: "Tela de onboarding". Depois ficou específico: "Screenshot da tela de onboarding no emulador, com o texto legível".

Essa mudança de critério vale porque nomeia o que Martin precisa ver para acreditar que a entrega funcionou. Não é qualquer opinião sobre a qualidade, é o artefato que prova que ela existe. E é específico o bastante para o agente entender que não vale entregar um arquivo Figma bonito sem comprovar que o app renderiza aquilo. Isso aparece também em spec driven development.

A palavra que completa o acordo

Como o critério nasceu dentro da sessão de trabalho, Martin pôde reescrevê-lo sem parar para buscar um documento. Ele olhou o que tinha vindo, propôs uma melhoria, depois de ver a melhoria reescreveu o critério em voz alta, e o agente ouviu tudo e entendeu. A próxima entrega veio com o screenshot já dentro.

Essa é a parte que costuma faltar quando alguém manda o critério escrito sem passar pelo artefato real. Alguém escreve "o app tem que ser rápido", o agente devolve um app, e aí aparece a discussão sobre o que rápido significa.

Martin acertou a ordem: viu o artefato, propôs mudança, reescreveu o critério tendo a realidade na frente, e colou o novo critério no prompt do agente. É assim que o vibe coding funciona na prática. Por isso a próxima coisa que voltou já passou no que ele pediu.

Essa também é a prática de vibe coding para escolher nome de app disponível, de criação de conta de desenvolvedor Google Play, de vibe coding para começar do zero sem ideia, de vibe coding para checar contraste de cor, de vibe coding para copiar onboarding de concorrente, de estimativa no vibe coding, e de como usar vibe coding para planejar antes de delegar, onde validar antes de escalar economiza retrabalho. Isso aparece também em vibe coding para quando a ferramenta nao suporta a tarefa. O mesmo problema apareceu em checklist de tarefa manual no vibe coding.

Quando o critério vira ferramenta de debate

Há outra camada. Martin continuou pedindo melhoria na tela de onboarding depois de reescrever o critério:

A próxima tentativa, eu quero que o texto seja bem maior

Quando o critério está escrito na boca de quem está construindo, pedidos adicionais como esse chegam num contexto que o agente já entende. Ele sabe que Martin quer prova visual, então oferecerá screenshot. Ele sabe que Martin quer o texto legível, e agora acrescenta "bem maior" no critério anterior, sem derrubar as outras exigências.

O efeito colateral de um critério bem escrito é que ele vira uma ferramenta de conversa. Ao invés de Martin dizer "isto ficou ruim", ele diz "o texto precisa estar bem maior", e o agente sabe como medir se acertou: perguntando se aquilo bate com a prova visual que o critério pediu.

O que fica para quem faz vibe coding sozinho

Depois que uma tarefa volta, leia-a de verdade. Não apenas confirme se funciona, leia a forma como funciona, e se perceber que o que voltou não faz aquilo no nível que você esperava, reescreva o critério tendo o artefato na sua frente.

Pergunta que economiza tempo: qual é a prova de que isto funcionou? Se a resposta é "eu diria que funcionou", o critério precisa de uma prova objetiva. Se a resposta é "ele me mandaria um print", já é. Escreva isso no critério, deixe claro para o agente o que você precisa receber, e a próxima entrega já vai vir com a prova.

Na sequência de telas do Fumava, cada uma que sai diferente faz Martin recalibrar o que deve chegar, e dá para ver a conversa inteira na live onde ele constrói o app ao vivo com o agente.