Mneme: Um Gancho PreToolUse que Bloqueia Edições do Claude Code que Violam Decisões de Arquitetura

Marcus Dillavou construiu Mneme, um hook PreToolUse que intercepta edições do Claude Code e as verifica contra um arquivo de decisões de arquitetura registradas antes de serem gravadas no disco. O objetivo: evitar que bibliotecas proibidas, padrões rejeitados e convenções esquecidas reapareçam em novos arquivos.

Instalação

pip install mneme
python scripts/install_claude_code.py

Isso escreve a entrada do hook em .claude/settings.json e instala quatro comandos de barra:

• /mneme-check — executar uma verificação de violação
• /mneme-context — obter contexto para o arquivo atual
• /mneme-record — registrar uma nova decisão
• /mneme-review — revisar decisões existentes

Como Funciona

Quando Claude tenta uma edição, Mneme compara a operação com decisões indexadas por palavra-chave. Se uma violação for detectada, o hook bloqueia a operação e retorna o ID da decisão como feedback. Claude vê a restrição, entende o motivo e ajusta sua saída — sem necessidade de intervenção manual.

O hook falha abertamente: se Mneme não estiver no PATH ou exceder o tempo limite, ele sai com código 0 e o Claude Code prossegue normalmente. Ele só bloqueia quando mneme check realmente retorna um veredito de violação.

Casos Extremos

A recuperação é baseada em palavras-chave, então o escopo das decisões é importante. O autor está ativamente buscando feedback do mundo real sobre se o hook dispara corretamente em projetos de produção.