Objetivos de aprendizaje
- Distinguir instrucciones blandas de controles obligatorios.
- Diseñar hooks para comandos, tests, logs y protección de ramas.
- Usar hooks sin convertir cada acción en una trampa de mantenimiento.
En cristiano: hook. Es un comando o verificación que se ejecuta automáticamente en un punto del flujo, por ejemplo antes de usar una herramienta o después de editar.
Cuándo usar hooks
- Bloquear `git push` directo a `main`.
- Ejecutar lint o tests tras editar archivos críticos.
- Registrar comandos sensibles en un log.
- Impedir lectura de `.env`, claves o dumps privados.
- Forzar aprobación humana para deploy, borrados o migraciones.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "$CLAUDE_PROJECT_DIR/.claude/hooks/deny-dangerous.sh"
}
]
}
],
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [
{
"type": "command",
"command": "npm run lint"
}
]
}
]
}
} Idea clave. La regla práctica: si el fallo sería caro, no lo dejes solo en el prompt. Ponlo en un hook, un test o una aprobación.
Cuidado. Un hook demasiado agresivo puede bloquear el trabajo normal. Empieza con avisos y registros; convierte en bloqueo solo las acciones de alto riesgo.
Comprueba que funciona. Escribe una lista de comandos que nunca quieres que un agente ejecute sin permiso: borrados, pushes, migraciones, exposición de puertos y lectura de secretos.
Guardar y reabrir el proyecto.
Hooks son cinturón de seguridad, no volante. El agente decide el camino; el hook evita que cruce líneas rojas.
Siguiente misión recomendada
Si has guardado la evidencia de esta lección, continúa con «Skills seguras». Si no, repite la comprobación antes de avanzar.