Los hooks, o ganchos, son puntos donde conectas un comando propio en medio del funcionamiento de un agente de código. Cuando ocurre el evento, el comando se ejecuta solo.
El concepto viene de la programación en general y hoy aparece en herramientas como Claude Code, que permite configurar hooks en archivos de configuración.
Como funciona
El agente trabaja por etapas: recibe una solicitud, decide usar una herramienta, la ejecuta y responde. En algunos de esos momentos, la herramienta puede llamar a un hook que configuraste.
Los eventos típicos incluyen antes de usar una herramienta, después de usar una herramienta y al terminar una respuesta. Los nombres exactos dependen de la herramienta, así que consulta la documentación oficial.
El hook recibe información sobre el evento y ejecuta un script. Ese script puede solo registrar algo o puede bloquear la acción, dependiendo de lo que permita la herramienta.
Lo importante es que el hook es código normal. No depende de que el modelo interprete bien una instrucción.
Exemplo prático
Tu equipo quiere que todo archivo Python editado por el agente pase por un formateador. En lugar de repetirlo en el prompt, creas un hook para después de la edición.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [{ "type": "command", "command": "ruff format ." }]
}
]
}
}El formato de arriba es un ejemplo ilustrativo. Revisa el esquema actual en la documentación de la herramienta que uses.
Otro uso común es bloquear comandos de riesgo, como borrar carpetas enteras, antes de que se ejecuten.
Para que serve
Los hooks sirven para imponer reglas que no pueden fallar: formateo, pruebas, verificación de secretos y registro de acciones para auditoría.
En flujos con varios agentes, como los que organizas en bridgecode, los hooks ayudan a mantener el mismo estándar de calidad independientemente de qué agente hizo la tarea.
Diferença entre hooks e slash commands
Los slash commands son atajos que escribes para disparar una instrucción. Los hooks se disparan solos por causa de un evento. Uno depende de que lo llames tú, el otro ocurre automáticamente.