Mneme: Un gancho de PreToolUse que bloquea las ediciones de Claude Code que violan las decisiones de arquitectura

Marcus Dillavou construyó Mneme, un hook PreToolUse que intercepta las ediciones de Claude Code y las verifica contra un archivo de decisiones de arquitectura registrado antes de que lleguen al disco. El objetivo: evitar que bibliotecas prohibidas, patrones rechazados y convenciones olvidadas reaparezcan en nuevos archivos.

Instalación

pip install mneme
python scripts/install_claude_code.py

Esto escribe la entrada del hook en .claude/settings.json e instala cuatro comandos slash:

• /mneme-check — ejecutar una verificación de violación
• /mneme-context — obtener contexto para el archivo actual
• /mneme-record — registrar una nueva decisión
• /mneme-review — revisar decisiones existentes

Cómo Funciona

Cuando Claude intenta una edición, Mneme compara la operación con las decisiones indexadas por palabras clave. Si se detecta una violación, el hook bloquea la operación y devuelve el ID de la decisión como retroalimentación. Claude ve la restricción, entiende por qué y ajusta su salida — sin necesidad de anulación manual.

El hook falla abierto: si Mneme no está en PATH o agota el tiempo de espera, sale con 0 y Claude Code procede normalmente. Solo bloquea cuando mneme check realmente devuelve un veredicto de violación.

Casos Especiales

La recuperación se basa en palabras clave, por lo que el alcance de las decisiones es importante. El autor busca activamente retroalimentación del mundo real sobre si el hook se activa correctamente en proyectos de producción.