O hook de pre-commit do Git impede que agentes de IA de codificação façam commits com documentação desatualizada.
Problema: Agentes de codificação de IA fazem commit de código com documentação desatualizada
Ao trabalhar com assistentes de codificação de IA como o Claude Code em múltiplas sessões, os desenvolvedores encontram um problema específico: a IA faz alterações no código (adicionando rotas, refatorando componentes, renomeando coisas) mas não atualiza arquivos de documentação como ARCHITECTURE.md e README. Isso faz com que sessões subsequentes comecem com a IA lendo documentação que descreve código de semanas atrás.
As consequências incluem:
- Claude alucinando nomes de funções que não existem mais
- Referenciando endpoints de API que foram renomeados
- Sugerindo padrões que contradizem a arquitetura atual
Avisos de advertência não funcionam porque quando o Claude está fazendo commit, ninguém vê a saída stderr.
Solução: Um hook de pré-commit bloqueador
O desenvolvedor criou um hook de pré-commit do Git com este fluxo de trabalho:
- O hook sabe quais alterações de arquivo devem acionar atualizações de documentação (padrões configuráveis por projeto)
- Quando o Claude Code faz commit, o hook o detecta através de variáveis de ambiente
- O hook evita tentar corrigir automaticamente a documentação (o que causaria um deadlock ao gerar Claude de dentro do Claude)
- Em vez disso, ele sai com código 1 e exibe uma mensagem clara: "docs estão desatualizados, atualize estes arquivos, depois tente novamente"
- Claude lê o erro, atualiza a documentação, tenta o commit novamente, e o commit é realizado
Para commits humanos, o hook chama a API da Anthropic diretamente e corrige as seções relevantes (levando aproximadamente 20 segundos).
Cada commit gera um arquivo session-context.md com um resumo da atividade recente para que a próxima sessão tenha continuidade.
Detalhes de implementação
A ferramenta está disponível como um pacote npm: @mossrussell/agent-guard
Características principais:
- Funciona com Claude Code, Cursor, Windsurf e Copilot
- Zero dependências
- Disponível em: https://www.npmjs.com/package/@mossrussell/agent-guard
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
AgentSwarms: Ambiente Prático Gratuito para Aprender IA Agêntica
AgentSwarms oferece 5 trilhas, mais de 40 lições e mais de 30 agentes executáveis gratuitamente — sem necessidade de configuração ou chaves de API para começar. Aprenda construindo desde prompts até enxames multiagentes.
PromoClock: Rastreador de Fuso Horário para os Horários Fora de Pico 2x do Claude Desenvolvido com Claude 4.6
Um desenvolvedor criou o PromoClock.co, uma ferramenta gratuita que converte automaticamente os horários promocionais de 2x fora do pico do Claude "5-11am PT / 12-6pm GMT" para o horário local, usando o Claude 4.6 para lidar com a lógica de fuso horário, configuração do Next.js 15 e design da interface.
Context-Kit: Ferramenta de Código Aberto para Configuração de Assistente de IA
Context-kit é uma ferramenta gratuita que gera arquivos de configuração e documentação de habilidades para assistentes de codificação de IA. Ele suporta Claude Code, Cursor, Windsurf, GitHub Copilot e Gemini CLI.
A ferramenta GrapeRoot reduz os custos do Claude Code em 45% com contexto de repositório pré-escaneado.
Uma ferramenta gratuita chamada GrapeRoot que pré-escaneia repositórios e constrói gráficos de dependência reduziu os custos do Claude Code em 45% em média em 10 tarefas de engenharia, enquanto melhorou a qualidade das respostas em 13%. A ferramenta elimina loops de exploração que normalmente consomem tokens.