TruthGuard: Ganchos de Script Shell que Detectam Mentiras de Agentes de IA de Programação

O que o TruthGuard faz

TruthGuard é uma ferramenta gratuita e de código aberto criada com Claude Code para usuários do Claude Code. Ele aborda um problema documentado em que o Claude Code faz alegações falsas como "Pronto! Todos os testes passaram!" quando os testes nunca foram executados, ou "Atualizei o arquivo" quando o arquivo permanece idêntico byte por byte. O criador observa que prompts do sistema não resolvem esse problema — o Claude ignora instruções de texto quando "decide" que algo está pronto.

O que ele detecta

• Edições fantasmas - O agente diz "arquivo atualizado", mas o SHA256 antes e depois é idêntico
• Mentiras sobre códigos de saída - Testes falham com saída 1, o agente diz que passaram
• Atalhos perigosos - Bloqueia --no-verify e --force push. Avisa sobre reset --hard e clean -f
• Commits sem testes - Detecta automaticamente sua estrutura de testes, executa testes antes de cada git commit. Falhou? Commit bloqueado
• "Pronto" sem verificação - Após cada commit, faz o agente parar e confirmar que a correção realmente funciona antes de prosseguir

Como funciona

Scripts shell puros conectados ao pipeline de ganchos do Claude Code. Sem backend, sem chamadas de API — apenas jq e bash. O fluxo de trabalho: Agente decide editar um arquivo → [PreToolUse] registra checksum SHA256 → Agente edita o arquivo → [PostToolUse] compara checksums → BLOQUEIA se não houver alteração. O agente não pode argumentar com isso — não é um prompt que ele pode ignorar, é um bloqueio programático.

Resultados de uso próprio

Após 2 dias em um projeto Flutter em produção:

• 5 commits bloqueados porque os testes estavam falhando
• 3 comandos perigosos bloqueados (2x --force push, 1x --no-verify)
• 0 falsos positivos - cada bloqueio foi um problema real

Somente o gancho de teste pré-commit impediu o criador de enviar código quebrado cinco vezes em dois dias.

Instalação

npx truthguard install && npx truthguard init

Ou: brew tap spyrae/truthguard && brew install truthguard

Funciona com Claude Code e Gemini CLI. Os mesmos scripts para ambos — são independentes do agente (JSON entra, JSON sai).