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.