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
Mike: IA legal de código abierto con autoalojamiento y soporte multimodelo
Mike es una alternativa de código abierto a Harvey y Legora, que ofrece chat de documentos, extracción tabular y plantillas de flujo de trabajo, todo autogestionable con tus propias claves API de Claude o Gemini.
CLI del Navegador: Una Herramienta de Automatización de Navegadores Eficiente en Tokens para Agentes de IA de Programación
Browser CLI es un demonio persistente de Chromium sin interfaz que proporciona automatización del navegador mediante comandos simples de Bash, logrando un ahorro de ~95% de tokens en comparación con Playwright MCP al reducir las llamadas de ~1,500 tokens a ~75 tokens.
El complemento HomeClaw conecta Apple HomeKit con OpenClaw.
HomeClaw es un complemento de OpenClaw que conecta dispositivos Apple Home/HomeKit a OpenClaw. Requiere una cuenta de desarrollador de Apple para compilar y ejecutar debido a las restricciones de Apple HomeKit para distribuciones notarizadas.
Construyendo un Sistema de Conocimiento Automejorable con Claude Code y Obsidian
Un desarrollador construyó un sistema de 25 herramientas que le da a Claude Code memoria persistente mediante búsqueda semántica, grafos de conocimiento y repetición espaciada sobre una bóveda de Obsidian. El sistema indexa contenido con incrustaciones bge-m3, detecta contradicciones, poda automáticamente notas obsoletas y genera mapas de Obsidian Canvas de forma automática.