A IA disse que está pronto. Como conferir sem saber ler código

Existe uma palavra que a IA diz com muita facilidade: “pronto”. E existe uma palavra que custa caro quando ela está errada: “pronto”. Se você usa uma IA que trabalha dentro da pasta do projeto, como o Claude Code, vai ouvir essa palavra o tempo todo. Este texto mostra como conferir de verdade, sem ler uma linha de código.

Eu não sou programador. Minha maior causa de retrabalho foi receber “pronto” quando só os testes automáticos tinham passado. Ninguém tinha aberto o sistema e clicado. Eu abria, o botão não fazia nada, e voltava para a conversa explicar tudo de novo. Perdi muitas horas assim, até exigir que “pronto” só valesse depois de testado de verdade. Este texto é independente e não tem vínculo com a Anthropic, criadora do Claude Code.

Por que “pronto” engana

Quando a IA diz “pronto”, ela quer dizer que terminou de escrever. Escreveu o arquivo, não deu erro de leitura, seguiu em frente.

Para você, “pronto” quer dizer outra coisa: eu abro, uso e funciona. A distância entre as duas frases é onde mora o retrabalho.

Testes automáticos são pequenos programas que a própria IA escreve para conferir se o código se comporta como ela espera. Ajudam, mas conferem o que ela imaginou, não o que você precisa.

A escada do pronto

Pense em uma escada de quatro degraus.

1. Escreveu. A IA criou ou alterou os arquivos. Prova de que algo existe, nada mais.
2. Testes passaram. As conferências automáticas deram verde. Prova de que não quebrou o que ela previu.
3. Abriu e clicou. Alguém rodou o sistema de verdade, fez o caminho completo e viu o resultado na tela.
4. Pessoa real usou. Alguém que não construiu o sistema, no aparelho em que ele será usado, fez a tarefa sem ajuda.

Só o quarto degrau conta como pronto. O terceiro já serve para dizer “pronto para você testar”. Os dois primeiros não autorizam essa palavra.

Na Gráfica Aurora, a Lúcia, do administrativo, aprendeu a ler o relatório da IA com essa escada na cabeça. “Escrevi a tela de cadastro” é degrau 1. “Os testes passaram” é degrau 2. Ela só relaxa quando a frase é “cadastrei um pedido de 500 cartões, apareceu na lista como Recebido e exportei a planilha”.

Exija o bloco “Como testar”

A forma mais simples de forçar a escada é pedir, em toda entrega, um bloco chamado Como testar, escrito para quem não programa. Ele deve trazer o endereço exato para abrir, os passos na ordem e o que deve aparecer na tela.

Ao terminar qualquer entrega, não escreva apenas "pronto". Termine com um bloco "Como testar" para quem não programa: o endereço exato para abrir, os passos numerados, e o que eu devo ver na tela em cada passo. Diga também o que você já testou de verdade e o que ainda depende de mim. Se algo não foi testado, escreva "não testado".

Repare no final: “não testado”. Uma IA que pode admitir isso erra de forma menos perigosa do que uma que só sabe dizer “pronto”. Se você usa o arquivo CLAUDE.md, o manual que o Claude Code lê no início de cada sessão, coloque essa exigência nele para valer sempre.

Teste com dado real

Dado inventado esconde problema. Um cliente chamado “Teste 1” nunca tem acento, nunca tem nome comprido, nunca vem com espaço sobrando no fim.

O primeiro teste honesto usa pedidos do próprio caderno: “Marília Gonçalves Confecções”, 1.250 folhetos, prazo na sexta. Com a vida real aparecem o til que sumiu, o nome que não coube na coluna e a data digitada de um jeito que o sistema não entendeu. Se você já tem uma planilha de verdade, entregue-a à IA como ponto de partida.

Um cuidado: se a planilha tem CPF, telefone ou endereço de clientes, pense duas vezes antes de colar qualquer coisa em lugar público.

Teste o caminho do erro

O caminho feliz é quando tudo dá certo: você preenche tudo direitinho e salva. A IA quase sempre acerta esse. O que quebra é o outro caminho. Tente, você mesmo:

• salvar o pedido com a quantidade em branco;
• digitar letras onde deveria ter número;
• colocar um prazo que já passou;
• cadastrar o mesmo pedido duas vezes;
• abrir a lista quando ainda não há nenhum pedido;
• perder a conexão no meio de salvar.

Em cada caso, a pergunta é: o que aparece na tela? A resposta certa é uma mensagem em português claro, como “Informe a quantidade”. As erradas são tela em branco, botão que não reage ou texto técnico ilegível.

Quando aparecer um erro estranho, não tente interpretar. Tire um print, copie a mensagem inteira, crua, e cole na conversa. O erro original vale mais do que a sua descrição dele.

Repare também em campos vazios. Prefira que apareça um sinal claro, como um traço, em vez de espaço em branco que parece falha de carregamento.

Teste no aparelho de uso

Funcionar no computador da IA não é funcionar no seu. E funcionar no seu computador não é funcionar no celular do balcão.

Já troquei componentes prontos de terceiros, como o calendário e a assinatura na tela. No computador funcionavam. No tablet, quebraram: o toque não pegava. Hoje testo sempre no aparelho em que o sistema será usado.

Se o operador da máquina vai atualizar o status do pedido pelo celular, o teste precisa acontecer no celular dele, com o dedo, não com o mouse. Botões pequenos, listas largas demais e campos escondidos pelo teclado só aparecem ali.

Depois de cada correção, teste de novo

Uma correção também sobe a escada. Muita correção conserta um ponto e desmonta outro. Por isso, peça que a IA refaça o caminho completo:

Antes de dizer que corrigiu, refaça o caminho completo no sistema aberto: cadastrar um pedido, mudar o status até Entregue, filtrar a lista e exportar a planilha. Conte o que viu na tela em cada passo, inclusive o que não mudou.

E repita você o mesmo caminho, mesmo que seja só uma vez. Se ela responder que não conseguiu abrir o sistema, o teste fica com você: siga o “Como testar” e conte a ela o que funcionou e o que não, porque ela não enxerga a sua tela.

O limite desta conferência

Este método pega a maior parte dos problemas do dia a dia, mas não torna o sistema seguro por si só. Se o sistema lida com pagamento, com dado sensível de outras pessoas ou com muitos usuários ao mesmo tempo, chame um profissional para revisar. Quem publica responde pelo que publicou.

Quer o método completo?

A regra “Pronto é testado” é uma das quatro que organizam o guia “Equipe de IA sem programar”, também independente e não oficial. Se quiser conhecer o restante, com pedidos prontos e um projeto de exemplo, o botão está abaixo.