Hooks en Cursor: guardianes automáticos para tu código
Contenido del curso
Kenneth Angulo L
Kenneth Angulo L
Kenneth Angulo L
Nicolás Alejandro Vargas Cárdenas
Daniel Alfredo García Serna
¿Cuándo debería ejecutar un hook de seguridad?
Los momentos ideales son justo antes de acciones críticas o al finalizar una tarea. Piensa en ellos como puntos de control de seguridad en un aeropuerto antes de abordar un vuelo.
Puedes configurarlos al iniciar una sesión, justo antes de que el agente ejecute un comando en la terminal, o al terminar un turno para validar que el código generado no rompa tu aplicación.
¿Es posible usar bash para estos hooks?
Totalmente. De hecho, la verdadera magia detrás de estos guardianes automatizados son simples comandos de bash que se ejecutan silenciosamente en segundo plano mientras trabajas.
Esto te otorga una flexibilidad técnica enorme. Cualquier validación, script personalizado o regla de seguridad que puedas escribir en una terminal tradicional, puedes integrarla directamente dentro de tu directorio .cursor-hooks.
📚 CLASE: HOOKS EN CURSOR: GUARDIANES AUTOMÁTICOS PARA TU CÓDIGO
━━━━━━━━━━━━━━━━━━
🎯 IDEA PRINCIPAL
🟡 Los hooks permiten colocar controles automáticos alrededor de las acciones que ejecuta un agente.
🔵 Funcionan como guardianes: validan, permiten o bloquean acciones según reglas definidas por ti.
━━━━━━━━━━━━━━━━━━
⚡ RESUMEN ULTRA RÁPIDO
🔵 Un hook es un punto de control que se ejecuta durante momentos específicos del ciclo del agente.
🟡 Puede activarse al iniciar sesiones, llamar herramientas, iniciar subagentes o ejecutar comandos shell.
🟢 Puedes usar hooks para ejecutar tests, formateadores, análisis de seguridad o validaciones automáticas.
🔴 También pueden bloquear operaciones peligrosas, como comandos destructivos sobre archivos.
🟣 La clase muestra hooks aplicados antes y después de acciones para proteger un proyecto durante desarrollo agéntico.
━━━━━━━━━━━━━━━━━━
🔑 LO IMPORTANTE
🔵 Los hooks se configuran dentro de .cursor/hooks y utilizan comandos ejecutados en segundo plano.
🟡 Un hook stop puede ejecutar type-checking y tests cuando termina el turno del agente.
🟡 Un hook beforeShellExecution puede inspeccionar comandos antes de permitir su ejecución.
🔴 Nunca permitas automáticamente comandos destructivos solo porque el agente los solicita.
🟢 Define condiciones concretas: qué se valida, cuándo se valida y qué ocurre si falla.
🟡 La clase utiliza un límite de tres reintentos cuando las validaciones automáticas encuentran errores.
🟣 Los hooks convierten controles que normalmente harías manualmente en guardrails repetibles.
━━━━━━━━━━━━━━━━━━
🧩 MODELO MENTAL
🔵 Agente → Hook → Validación → ¿Cumple? → Continuar / Bloquear
🟡 Piensa en cada hook como una puerta de seguridad colocada justo antes o después de una acción crítica.
🟣 La regla práctica es simple: automatiza controles repetitivos y conserva intervención humana para decisiones importantes.
━━━━━━━━━━━━━━━━━━
🚀 ACCIONES PARA HOY
🟢 Identifica una acción peligrosa que un agente podría ejecutar accidentalmente en tu proyecto.
🟢 Crea primero un hook que bloquee operaciones destructivas sobre archivos.
🟢 Añade un hook posterior que ejecute type-checking y tests después del trabajo del agente.
🟢 Define un número máximo de reintentos para evitar loops automáticos interminables.
🟢 Ejecuta deliberadamente un comando bloqueado y comprueba que el hook realmente lo rechaza.
🟢 Revisa los logs del hook para confirmar qué acción recibió y qué decisión tomó.
━━━━━━━━━━━━━━━━━━
🟣 VENTAJA PROFESIONAL
🟣 El salto importante es pasar de “recuerdo decirle a la IA que tenga cuidado” a “el sistema impide automáticamente ciertas acciones”.
🟣 Combina Rules + MCP + Hooks: Rules establecen comportamiento, MCP proporciona contexto real y Hooks controlan acciones.
🟣 Hack: empieza por hooks de lectura/validación antes de crear hooks capaces de modificar o bloquear recursos.
🟣 Aplica mínimo privilegio: cada hook debería controlar únicamente el riesgo que realmente necesitas cubrir.
🟣 En proyectos con múltiples agentes, estos controles son especialmente útiles porque las mismas protecciones se aplican independientemente del agente utilizado.
━━━━━━━━━━━━━━━━━━
📝 CIERRE
🟡 El principiante confía en que el agente seguirá las instrucciones; el profesional añade controles que hagan cumplir esas reglas.
🟢 El primer hook que deberías pensar no es el más complejo: es el que evita automáticamente el error más costoso de tu proyecto.
