Workflows agênticos — Maestria4 / 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.
Você pode pedir ao agente para executar o formatter após cada edição. Ou você pode garantir isso. Hooks são comandos shell que o Claude Code executa automaticamente em pontos definidos de seu loop — transformando "por favor, lembre-se" em "sempre".
Os eventos que você realmente vai usar
PostToolUse— depois que uma tool tem sucesso. Formate ou faça lint no arquivo que foi editado.PreToolUse— antes de uma tool ser executada. Inspecione e bloqueie chamadas perigosas.UserPromptSubmit— injete contexto antes do modelo ver seu prompt.SessionStart/Stop— carregue contexto no início, notifique ao final.
Configurando um
Hooks ficam sob uma chave hooks em settings.json. Cada evento mapeia para matchers (uma regex sobre o nome da tool) e comandos:
{
"hooks": {
"PostToolUse": [
{ "matcher": "Edit|Write",
"hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }] }
]
}
}
Exit codes são o canal de controle
0— sucesso; o agente continua.2— erro de bloqueio; a ação é prevenida estderré retornado para que o agente possa se ajustar.- outro não-zero — erro não-bloqueante, registrado.
Recipes que se pagam
- Auto-format ao editar —
PostToolUse+Edit|Write. - Bloqueie
rm -rf/ force-push —PreToolUse+Bash, exit2em correspondência. - Secret scan antes de escrever —
PreToolUse+Write, bloqueie em chaves detectadas. - Ping na desktop quando entrada é necessária —
Notification.
Hooks aplicam comportamento. A seguir, empacotamos intenção — fluxos de trabalho de equipe reutilizáveis — como slash commands customizados.
Série — Workflows agênticos — Maestria
- Parte 01A Mentalidade do Fluxo de Trabalho AgenticA maioria dos desenvolvedores trata IA como um autocomplete mais inteligente. Os que saem na frente a tratam como um colega de trabalho que age. Aqui está o modelo mental.
- Parte 02MCP Servers 101 — Dê Ferramentas Reais ao Seu AgentO Model Context Protocol é como seu agent para de adivinhar e começa a consultar seu banco de dados, seus issues, seu navegador. Aqui está o modelo mental e a primeira conexão.
- Parte 03Build Your First Custom MCP ServerOff-the-shelf servers cover GitHub and Postgres. The high-leverage one is the server only you can write — the bridge to your own system.
- Parte 04Hooks — Make the Agent Obey Your Rules — você está aquiA 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 Trabalho que EscalaUm contexto gigante fica lento e vago. Subagentes deixam o agente principal delegar trabalho focado para especialistas com seu próprio contexto e ferramentas — e executá-los em paralelo.
- Parte 07The Daily-Driver Setup — Settings, Permissions, Status LineA diferença entre lutar contra o agent e fluir com ele é vinte minutos de configuração que você faz uma vez. Aqui está o setup.
- 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.