Cómo funcionan los hooks
Cuando un agente de programación modifica un archivo:- El hook ejecuta un análisis AST rápido en memoria sobre los archivos cambiados (
runScopedScan). - Las tareas lentas (auditorías de red, chequeo de tipos con
tsco formateadores pesados) se omiten para mantener la respuesta casi instantánea. - Si el cambio introduce defectos (como excepciones silenciadas o conversiones
as any), el hook devuelve el diagnóstico en el turno del propio agente. - El asistente lee la respuesta estructurada y se autocorrige en el mismo turno antes de que tú veas el fallo.
Instalación de hooks
Instala los hooks para todos los asistentes detectados en tu máquina:--project para limitar los hooks exclusivamente al repositorio actual en lugar de aplicarlos a nivel global.
Estado, líneas base y seguridad
Comprobar estado e integridad
Revisa los hooks activos y sus firmas de integridad SHA-256:Capturar la línea base (baseline)
Registra la deuda técnica actual antes de activar comprobaciones incrementales:.raigal/baseline.json. Las ediciones posteriores del asistente se comparan contra esta base para evitar falsas alertas por código heredado.
Desinstalación limpia
Elimina los hooks sin modificar tus configuraciones personalizadas del editor:Para conectar las herramientas de Raigal directamente al flujo de llamadas de herramientas del agente en lugar de usar hooks de archivos, consulta el Servidor MCP.