Una hook reacciona a algo que ocurre en Coroid. Tú eliges un evento, escribes las instrucciones en lenguaje sencillo y la hook se ejecuta cuando se produce el evento.
Encuéntralas en Configuración → Automatización → Automatizaciones.
Eventos a los que puedes reaccionar
| Categoría | Ejemplos |
|---|---|
| Tarea | Creada, cambio de estado, cambio de fase, completada, fallida |
| Agente | Iniciado, iteración, llamada a herramienta, completado, error |
| Repositorio | Commit enviado, rama creada, pull request abierta, pull request fusionada |
| Análisis | Dependencia encontrada, problema de seguridad, análisis completado |
| Sincronización | Fuente externa actualizada |
| Despliegue | Iniciado, completado, fallido |
De forma predeterminada son de solo lectura
Las hooks analizan e informan. Pueden crear trabajo de seguimiento; no modifican tu código directamente.
Esa configuración predeterminada es lo que las hace seguras para adoptar. Una automatización que edita código en respuesta a un evento actúa en el momento menos probable de ser supervisada. Una hook que abre una tarea produce el mismo resultado a través del proceso habitual: especificación, planificación, verificación, revisión y pull request.
Escribir buenas instrucciones
Las instrucciones de las hooks las procesa un modelo, por lo que se leen como indicaciones para un compañero en lugar de código. El estándar de calidad es el mismo que para una especificación: indica qué observar, qué importa y qué hacer.
Sé específico sobre el caso de "no hacer nada". Sin ello, una hook encontrará algo que decir cada vez que se ejecute, y las hooks que se activan siempre son ignoradas por los usuarios.
Límites de seguridad
Existen tres protecciones porque la automatización basada en eventos falla de maneras previsibles:
Límites de velocidad. Por minuto, hora y día, configurables por hook. Una hook en un evento de alta frecuencia podría activarse cientos de veces durante una fusión intensa.
Profundidad de cadena. Las hooks pueden disparar eventos que activan más hooks. Una profundidad máxima de cadena evita que se convierta en un bucle.
Permisos de herramientas. Lo que una hook puede acceder está controlado: el acceso de solo lectura, las llamadas MCP y la creación de tareas se gestionan por separado.
Permisos
La gestión de hooks es exclusiva de los administradores; todos los miembros pueden ver las hooks y su historial de ejecución. Dado que una hook opera a nivel de organización, esa asimetría es intencionada.
Supervisándolas
Cada hook mantiene un registro de entregas y análisis. Revisa el registro después de habilitar una nueva hook: el modo de fallo no es un error, sino activarse constantemente sin producir nada en lo que nadie actúe.
Hooks, programaciones y Sentinel
| Mecanismo | Se activa por |
|---|---|
| Hook | Un evento de la plataforma |
| Programación | Hora |
| Sentinel | Una condición que se está observando |