Workflows agénticos — Maestría4 / 8
Hooks — Make the Agent Obey Your Rules
A prompt asks the model to remember. A hook makes it happen — deterministically, every time, outside the model's control.
Puedes pedir al agente que ejecute el formateador después de cada edición. O puedes garantizarlo. Los hooks son comandos shell que Claude Code ejecuta automáticamente en puntos definidos de su bucle — convirtiendo "por favor recuerda" en "siempre".
Los eventos que realmente usarás
PostToolUse— después de que una herramienta tenga éxito. Formatea o valida el archivo que acaba de editarse.PreToolUse— antes de que se ejecute una herramienta. Inspecciona y bloquea llamadas peligrosas.UserPromptSubmit— inyecta contexto antes de que el modelo vea tu prompt.SessionStart/Stop— carga contexto al inicio, notifica al final.
Conectando uno
Los hooks viven bajo una clave hooks en settings.json. Cada evento se asigna a matchers (una expresión regular sobre el nombre de la herramienta) y comandos:
{
"hooks": {
"PostToolUse": [
{ "matcher": "Edit|Write",
"hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }] }
]
}
}
Los códigos de salida son el canal de control
0— éxito; el agente continúa.2— error bloqueante; la acción se previene ystderrse retroalimenta para que el agente pueda ajustarse.- otro valor distinto de cero — error no bloqueante, registrado.
Recetas que se pagan solas
- Auto-formateo al editar —
PostToolUse+Edit|Write. - Bloquea
rm -rf/ force-push —PreToolUse+Bash, salida2al encontrar coincidencia. - Escaneo de secretos antes de escribir —
PreToolUse+Write, bloquea si detecta claves. - Ping de escritorio cuando se necesita entrada —
Notification.
Los hooks refuerzan el comportamiento. Después empaquetamos intención — flujos de trabajo de equipo reutilizables — como comandos slash personalizados.
Serie — Workflows agénticos — Maestría
- Parte 01La mentalidad del flujo de trabajo agénticoLa mayoría de los desarrolladores tratan la IA como un autocompletado más inteligente. Los que avanzan la tratan como un compañero que actúa. Aquí está el modelo mental.
- Parte 02MCP Servers 101 — Dale herramientas reales a tu agenteEl Model Context Protocol es cómo tu agente deja de adivinar y comienza a consultar tu base de datos, tus issues, tu navegador. Aquí está el modelo mental y la primera conexión.
- Parte 03Construye tu primer servidor MCP personalizadoLos servidores predefinidos cubren GitHub y Postgres. El de alto impacto es el servidor que solo tú puedes escribir — el puente hacia tu propio sistema.
- Parte 04Hooks — Make the Agent Obey Your Rules — estás aquíA prompt asks the model to remember. A hook makes it happen — deterministically, every time, outside the model's control.
- Parte 05Custom Slash Commands as Team WorkflowsA custom slash command is a reusable prompt you commit to the repo — so the whole team runs the same high-quality instruction instead of re-typing it.
- Parte 06Subagentes — Delegando Trabajo que EscalaUn contexto gigante se vuelve lento y vago. Los subagentes permiten que el agente principal delegue trabajo enfocado a especialistas con su propio contexto y herramientas — y ejecutarlos en paralelo.
- Parte 07The Daily-Driver Setup — Settings, Permissions, Status LineLa diferencia entre luchar contra el agente y fluir con él es veinte minutos de configuración que haces una sola vez. Aquí está la configuración.
- Parte 08Multi-Tool Pipelines — Ticket to Reviewed BranchThe payoff: chain MCP, hooks, commands and subagents into one flow that takes a ticket to a reviewed branch — with you in the loop only where it counts.