Hooks, ou ganchos, são pontos em que você pluga um comando seu no meio do funcionamento de um agente de código. Quando o evento acontece, o comando roda sozinho.
O conceito vem da programação em geral e hoje aparece em ferramentas como o Claude Code, que permite configurar hooks em arquivos de configuração.
Como funciona
O agente trabalha em etapas: recebe um pedido, decide usar uma ferramenta, executa, responde. Em alguns desses momentos, a ferramenta pode chamar um hook que você configurou.
Eventos típicos incluem antes de usar uma ferramenta, depois de usar uma ferramenta e ao terminar uma resposta. Os nomes exatos dependem da ferramenta, então consulte a documentação oficial.
O hook recebe informações sobre o evento e executa um script. Esse script pode apenas registrar algo, ou pode barrar a ação, dependendo do que a ferramenta permitir.
O ponto importante é que o hook é código normal. Ele não depende de o modelo interpretar bem uma instrução.
Exemplo prático
Seu time quer que todo arquivo Python editado pelo agente passe por um formatador. Em vez de repetir isso no prompt, você cria um hook para depois da edição.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [{ "type": "command", "command": "ruff format ." }]
}
]
}
}O formato acima é um exemplo ilustrativo. Confira o esquema atual na documentação da ferramenta que você usa.
Outro uso comum é bloquear comandos de risco, como apagar pastas inteiras, antes de eles rodarem.
Para que serve
Hooks servem para impor regras que não podem falhar: formatação, testes, verificação de segredos e registro de ações para auditoria.
Em fluxos com vários agentes, como os que você organiza no bridgecode, hooks ajudam a manter o mesmo padrão de qualidade independentemente de qual agente fez a tarefa.
Diferença entre hooks e slash commands
Slash commands são atalhos que você digita para disparar uma instrução. Hooks disparam sozinhos por causa de um evento. Um depende de você chamar, o outro acontece automaticamente.