El hook de pre-commit de Git evita que los agentes de codificación con IA realicen commits con documentación desactualizada.
Problema: Los agentes de codificación con IA realizan commits con documentación desactualizada
Al trabajar con asistentes de codificación con IA como Claude Code a lo largo de múltiples sesiones, los desarrolladores encuentran un problema específico: la IA realiza cambios en el código (agrega rutas, refactoriza componentes, renombra elementos) pero no actualiza los archivos de documentación como ARCHITECTURE.md y README. Esto hace que las sesiones posteriores comiencen con la IA leyendo documentación que describe código de semanas atrás.
Las consecuencias incluyen:
- Claude alucina nombres de funciones que ya no existen
- Hace referencia a endpoints de API que fueron renombrados
- Sugiere patrones que contradicen la arquitectura actual
Las advertencias de asesoramiento no funcionan porque cuando Claude está realizando un commit, nadie ve la salida de stderr.
Solución: Un hook de pre-commit bloqueante
El desarrollador creó un hook de pre-commit de Git con este flujo de trabajo:
- El hook sabe qué cambios de archivo deberían activar actualizaciones de documentación (patrones configurables por proyecto)
- Cuando Claude Code realiza un commit, el hook lo detecta a través de variables de entorno
- El hook omite intentar corregir automáticamente la documentación (lo que causaría un punto muerto al generar Claude desde dentro de Claude)
- En su lugar, sale con el código 1 y muestra un mensaje claro: "la documentación está desactualizada, actualiza estos archivos y luego reintenta"
- Claude lee el error, actualiza la documentación, reintenta el commit, y el commit se realiza
Para commits humanos, el hook llama directamente a la API de Anthropic y corrige las secciones relevantes (tomando aproximadamente 20 segundos).
Cada commit genera un archivo session-context.md con un resumen de la actividad reciente para que la siguiente sesión tenga continuidad.
Detalles de implementación
La herramienta está disponible como un paquete npm: @mossrussell/agent-guard
Características clave:
- Funciona con Claude Code, Cursor, Windsurf y Copilot
- Cero dependencias
- Disponible en: https://www.npmjs.com/package/@mossrussell/agent-guard
📖 Read the full source: r/ClaudeAI
👀 Ver también
Sistema de Memoria Persistente Sin Código para Claude Usando Notion y MCP
Un radiólogo construyó un 'Centro Cognitivo' en Notion que Claude lee y escribe a través de MCP, creando una base de conocimiento estructurada con una tabla de enrutamiento para cargar solo información relevante por conversación. El sistema ha crecido a más de 70 páginas después de un mes de uso diario.
Tether: Un Servidor MCP para Compartir Contexto Entre Modelos de IA a través de SQLite
Tether es una herramienta de código abierto que comprime datos JSON en identificadores direccionables por contenido de 28 bytes, permitiendo que múltiples modelos de IA compartan contexto a través de una base de datos SQLite compartida. Funciona como un servidor MCP, facilitando la comunicación directa entre modelos como Claude y MiniMax sin necesidad de copiar y pegar.
Kanban CLI: Un gestor de tareas local y orientado a agentes para la terminal
Kanban CLI es una herramienta de terminal basada en Rust que proporciona gestión estructurada de tareas con integración completa de git, diseñada para flujos de trabajo impulsados por agentes de IA.
RTX 5060 Ti 16GB en Pruebas de LLM Local: Los Modelos de 30B Siguen Liderando en Codificación
Los benchmarks en una RTX 5060 Ti 16GB muestran que Unsloth Qwen3-Coder-30B UD-Q3_K_XL alcanza 76.3 tok/s en Ubuntu con una puntuación de calidad de 8.14, lo que lo convierte en el modelo de codificación recomendado por defecto. El Unsloth Qwen3.5-35B UD-Q2_K_XL alcanza 80.1 tok/s pero con puntuaciones de calidad más bajas.