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
Función de Memoria de Sesión Introducida en Claude Code
Claude Code ahora incluye una función de 'Memoria de Sesión', generando y manteniendo resúmenes de sesión en archivos summary.md. Desbloquéala con tweakcc para sesiones interactivas que superen umbrales específicos de tokens y llamadas a herramientas.
Problemas y Soluciones de Compactación de Sesiones de Claude AI
La compactación predeterminada en las sesiones de Claude AI puede degradar la precisión de recuperación de ~9.75/10 a ~5/10, causando alucinaciones. El usuario probó con 418K tokens y encontró que la compactación manual usando Opus mantiene la precisión mientras que la compactación predeterminada falla.
La habilidad de escaneo de seguridad para agentes de codificación de IA verifica implementaciones automáticamente.
Un desarrollador creó un archivo de habilidad que permite a los agentes de codificación con IA escanear automáticamente sus propias implementaciones en busca de archivos .env expuestos, puertos abiertos, encabezados de seguridad faltantes y código fuente filtrado. El escaneo se ejecuta después de cada implementación y tarda unos 30 segundos.
Usando pre-commit para mejorar la calidad y seguridad del código generado por IA
Un desarrollador comparte su configuración de pre-commit para proyectos en Go y Java, utilizando herramientas como golangci-lint, govulncheck y checkov para detectar vulnerabilidades y problemas de calidad en código generado por IA antes del commit.