~/VibeHandbook
PDF grátis

Capítulo 15 · 09

Quando um guardrail grita: faça a triagem antes de corrigir

Guardrails só são úteis se você reage bem a eles, e o modo de falha é previsível: a build fica vermelha, você entra em pânico um pouco, e cola o erro para a IA com "conserta isso". Às vezes isso funciona. Muitas vezes produz uma correção que faz o texto vermelho sumir sem resolver o que estava realmente errado — a IA enfraquece o teste, amplia um tipo, ou envolve a chamada que falha em um try/catch que engole o problema.

Antes de deixá-la "consertar" qualquer coisa, gaste dez segundos em triagem. Na prática, existem apenas três tipos de falha de guardrail:

  • Um bug real que você acabou de introduzir. A verificação está fazendo o seu trabalho. Corrija o código, não a verificação.
  • Um teste que agora está desatualizado. Você mudou o comportamento de propósito, e a asserção antiga não corresponde mais. Atualize o teste para afirmar o novo comportamento correto — deliberadamente, não por reflexo.
  • Uma verificação instável ou errada. Genuinamente raro. Desconfie de si mesmo aqui; esse é o balde onde as pessoas jogam bugs reais porque é o que permite seguir em frente.

A instrução que mantém a IA honesta é fazê-la diagnosticar antes de mudar qualquer coisa:

The test "never discounts below zero" is failing.
First, tell me WHY it fails — what does the code do now vs. what
the test expects. Then tell me which is correct: the code or the
test. Do NOT change anything until I confirm.

Essa pausa é a diferença entre um guardrail que te protege e um guardrail que você treinou silenciosamente a IA a driblar. Uma verificação vermelha é informação; a pior coisa que você pode fazer é pagar para deixá-la verde sem ler o que ela estava te dizendo.

Quer offline?

Baixe o livro inteiro em PDF ou EPUB — grátis.