3.4.3 · Testes como portão e a segunda opinião

O portão de saída

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "./.claude/scripts/portao-teste.sh" }
        ]
      }
    ]
  }
}

#!/usr/bin/env bash
# Recusa o encerramento se o teste de regressão falhar.
# ATENÇÃO: só exit 2 bloqueia. exit 1 NÃO bloqueia (aula 3.2.4).
if ! npm run test:regressao --silent; then
  echo "Teste de regressão falhou. Corrija antes de encerrar." >&2
  exit 2
fi
exit 0

O ciclo que isso produz, sem intervenção humana:

1. O Claude conclui que terminou e tenta encerrar
2. O hook Stop roda os testes
3. Falhou → exit 2 → o stderr volta para o Claude como contexto
4. O Claude lê a falha, corrige e tenta encerrar de novo
5. Passou → exit 0 → a sessão encerra

O passo 4 é o que diferencia isto de um alerta. Não é um aviso para você ler amanhã — é uma cobrança que o Claude atende agora.

As camadas, e o que cada uma cobre

Nenhuma linha dessa tabela é redundante com outra. É por isso que "os testes passaram" não encerra a conversa.

O que teste não pega, em contexto SAP

A aula 2.8.T2 já listou para ABAP: comportamento de user exit ou BAdI sem teste unitário, autorização, integração com sistema externo indisponível em ambiente de teste. Some a isso o que não é código:

Para as três últimas linhas, a segunda opinião fria é a verificação — não é um extra. Não existe portão automático para uma regra de alçada escrita errada.

A segunda opinião fria, aplicada

O mecanismo é o da aula 2.7.3: um subagente sem histórico do processo revisa o entregável. Ele não sabe quais alternativas foram descartadas nem quais dúvidas foram resolvidas por cansaço, e é justamente por isso que ele acha o que a sessão original deixou passar.

Aplique em: FS antes de entrar no fluxo de aprovação do cliente (2.8.F2), refatoração antes de sair de DEV (2.8.T2), material de comitê antes da reunião (2.8.P3), e qualquer resultado de execução desassistida que vá para o cliente.

Regra Wayon Repositório de projeto de cliente com suíte de teste roda com stop hook de teste ativo — e o hook usa exit 2, conferido na revisão de par (aula 3.2.4). Para entregável sem teste automático — spec, proposta, status report, documentação — a segunda opinião fria é obrigatória antes do envio ao cliente, e não é substituível por "os testes passaram", porque não há teste.

📖 Hooks — Stop e exit codes · A segunda opinião fria — módulo 2.7.3