9

Capítulo nove

O Loop de
Construção

Espere imperfeição. Curta o refinamento.
A terceira versão é onde a mágica acontece.

O erro mais comum ao construir com IA não é um prompt ruim. É uma expectativa ruim. Você digita uma descrição longa, aperta enter e espera um produto pronto. Não funciona. Nunca funciona. As pessoas que constroem coisas incríveis com IA sabem um segredo: a primeira versão está sempre errada. A terceira versão é boa. A quinta é ótima. E o processo de ir de uma para cinco? Essa é a habilidade de verdade.

Todo artista itera. Todo arquiteto revisa. Todo cineasta grava múltiplas tomadas. Construir com IA não é diferente. As pessoas que curtem o loop — em vez de se irritar com ele — são as que constroem as melhores coisas.

Especificar, gerar, verificar

Toda sessão produtiva com um agente de código segue o mesmo ritmo. Especifique o que você quer — seja concreto, dê exemplos, descreva como "pronto" se parece. Deixe o agente gerar. Depois verifique: funciona? Parece certo? Faz o que você pediu? Se não, especifique de novo, com mais precisão. Esse é o loop. Não é sinal de fracasso. É o processo.

A jogada poderosa é escrever seus critérios de aceitação antes de começar a construir. "O botão deve ficar verde quando clicado." "A lista deve persistir quando eu atualizar a página." "O formulário de cadastro deve rejeitar e-mails sem @." Essas descrições em português claro do que é "pronto" se tornam seu framework de avaliação. Quando algo está errado, cole seus critérios de volta para o agente e diga "isso não bate." O agente pode testar contra os seus padrões.

O que fazer quando travar

O agente gerou algo quebrado. E agora? Cinco estratégias, na ordem do que tentar primeiro:

1. Descreva o sintoma, não seu diagnóstico

"O botão não responde quando eu clico" é melhor que "Acho que o onClick handler está quebrado."

2. Compartilhe a mensagem de erro na íntegra

Copie e cole o erro exato. É a coisa mais útil que você pode dar ao agente.

3. Peça para o agente explicar o que fez

"Me explique o que você acabou de mudar e por quê." Entender geralmente revela o problema.

4. Peça uma abordagem diferente

"Essa abordagem não está funcionando. Você pode tentar resolver isso de um jeito completamente diferente?"

5. Comece do zero com as lições aprendidas

Às vezes uma conversa nova é mais rápida do que depurar uma enrolada. Leve as decisões-chave com você.

Testes como proteção

Você pode pedir ao agente para escrever testes automatizados — em português. "Escreva um teste que verifica se o formulário de cadastro rejeita e-mails sem @." O agente escreve o teste e o código que passa nele. Isso é desenvolvimento guiado por testes, dirigido por alguém que nunca escreveu um teste. Uma vez que um bug é pego por um teste, ele nunca mais pode voltar.

Pratique a habilidade. Como você descreveria esses bugs para um agente de código?

Debug Detective

How would you report this bug?

0 pts
Scenario 1 of 5

The Button That Does Nothing

Create Account
Submitno response

You asked the agent to build a sign-up form. The form looks great, but the "Submit" button doesn't do anything when you click it.

Submit button is unresponsive
Choose your approach
Share this course
A primeira versão está sempre errada. A terceira é boa. A quinta é ótima. Curta o loop.

Você sabe iterar. Sabe depurar. Mas como saber se o que está construindo é realmente bom? Não só funcional — bom. Isso exige algo que a IA não pode te dar: bom gosto. É o próximo passo.

Eval Framework

New tool unlocked!