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-verifye--force push. Avisa sobrereset --hardeclean -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).
📖 Leia o código-fonte completo: r/ClaudeAI
👀 See Also
OpenClaw PARA Habilidade Organizacional Classifica Automaticamente Arquivos em Projetos, Áreas, Recursos, Arquivos
Um desenvolvedor criou uma habilidade OpenClaw que aplica o método PARA (Projetos, Áreas, Recursos, Arquivos) para organizar arquivos, classificando automaticamente o conteúdo em vez de despejar tudo no diretório raiz.
VibeSmith: Ferramenta Local para Detectar Conflitos de Habilidades em Projetos de Código Claude
VibeSmith é um aplicativo de desktop local para macOS que fornece visibilidade unificada em projetos Claude Code, detectando conflitos quando componentes globais e de nível de projeto compartilham nomes, visualizando dependências como DAGs e rastreando o uso de tokens de contexto.
O OmniCoder-9B ajustado demonstra um desempenho robusto para codificação autônoma em sistemas com 8GB de VRAM.
Um usuário do Reddit testou o OmniCoder-9B, um ajuste fino do Qwen3.5-9B em traços do Opus, com o OpenCode e relatou velocidades de mais de 40 tokens por segundo usando a quantização Q4_K_M GGUF com comprimento de contexto de 100k em um sistema com 8GB de VRAM.
Semble: Busca de Código para Agentes de IA Usando 98% Menos Tokens que grep+read
Semble é uma biblioteca de busca de código open-source para agentes de IA que combina embeddings estáticos Model2Vec com BM25, executando inteiramente em CPU. Ela indexa um repositório em ~250ms e responde a consultas em ~1.5ms, alcançando 0.854 NDCG@10 — 99% da qualidade de um transformer de 137M de parâmetros — enquanto usa 98% menos tokens do que grep+read.