Clawback: Implementação baseada em hooks dos loops de verificação vazados do Claude

Clawback é um projeto do GitHub que implementa os loops de verificação do mapa de origem vazado do Claude como ganchos mecânicos em vez de prompts. A abordagem aborda a limitação em que a verificação baseada em prompt (como "você está PROIBIDO de completar sem executar tsc" do iamfakeguru/claude-md) pode ser ignorada pelo modelo sob pressão de contexto.

Arquitetura de ganchos

O sistema divide o problema em duas camadas:

• Ganchos (mecânicos, não podem ser ignorados):
  • Gancho de parada: Executa verificação de tipos + lint quando Claude tenta completar. Se falhar, sai com código 2, forçando Claude a continuar corrigindo. Três blocos falhados consecutivos acionam um disjuntor.
  • PostToolUse: Formata e faz lint automaticamente após cada edição de arquivo.
  • PreToolUse: Bloqueia edições de .env e lockfiles antes que Claude os toque.
  • PostCompact: Reinjeta o estado do git e gotchas.md após a compactação de contexto.
• CLAUDE.md (comportamental): Para o que os ganchos não podem impor, incluindo execução em fases (≤5 arquivos por fase), separação de plano vs construção, consciência de deterioração de contexto e registro de erros.

Detalhes técnicos

A ferramenta detecta automaticamente a pilha procurando arquivos de configuração: tsconfig.json, go.mod, Cargo.toml, pyproject.toml e composer.json. Não requer configuração e tem zero dependências. Clawback funciona junto com o projeto CLAUDE.md do iamfakeguru, não em vez dele.

A implementação é baseada nos loops de verificação vazados que estavam protegidos por USER_TYPE === 'ant' no mapa de origem. O repositório do GitHub está disponível em https://github.com/LZong-tw/clawback.