Kiro Hooks s\u00e3o automa\u00e7\u00f5es event-driven integradas ao Kiro IDE da AWS que executam agentes de IA ou comandos shell em resposta a eventos do ciclo de desenvolvimento. Em vez de lembrar de rodar scripts manualmente ou esperar o CI\/CD pegar o problema, os Kiro Hooks agem no exato momento em que o evento acontece, diretamente no IDE.<\/p>\n\n\n\n
O conceito \u00e9 similar a webhooks ou git hooks, mas com duas diferen\u00e7as fundamentais: a interface de configura\u00e7\u00e3o \u00e9 linguagem natural (voc\u00ea descreve o que quer que aconte\u00e7a, e o Kiro gera a automa\u00e7\u00e3o) e as a\u00e7\u00f5es podem usar a intelig\u00eancia do agente de IA para tarefas que exigem compreens\u00e3o de contexto, como atualizar testes ou documenta\u00e7\u00e3o.<\/p>\n\n\n\n
Neste artigo, voc\u00ea vai entender como os Kiro Hooks funcionam, quais tipos de evento est\u00e3o dispon\u00edveis e como configurar hooks que resolvem problemas reais do dia a dia de times de engenharia.<\/p>\n\n\n\n
Os Kiro Hooks (tamb\u00e9m chamados de Agent Hooks) s\u00e3o regras de automa\u00e7\u00e3o que conectam eventos do IDE a a\u00e7\u00f5es executadas por IA ou por comandos shell. A documenta\u00e7\u00e3o oficial<\/a> define hooks como “automated triggers that execute predefined agent actions when specific events occur.” Na pr\u00e1tica, funcionam como um “se isso acontecer, fa\u00e7a aquilo” \u2014 mas com IA que entende o c\u00f3digo e o contexto do projeto.<\/p>\n\n\n\n Cada hook \u00e9 composto por tr\u00eas elementos: um evento<\/strong> que dispara a automa\u00e7\u00e3o (salvar um arquivo, criar um componente, enviar um prompt), um padr\u00e3o de arquivos<\/strong> que define o escopo (ex: O Kiro suporta seis tipos de eventos que podem disparar hooks, conforme a documenta\u00e7\u00e3o de Hook Types<\/a>:<\/p>\n\n\n\n File Save<\/strong> \u2014 dispara quando um arquivo que corresponde ao padr\u00e3o definido \u00e9 salvo. O tipo mais usado para hooks de testes e documenta\u00e7\u00e3o.<\/p>\n\n\n\n File Create<\/strong> \u2014 dispara quando um novo arquivo \u00e9 criado no padr\u00e3o especificado. \u00datil para validar padr\u00f5es de arquitetura (ex: verificar se um novo componente React segue Single Responsibility Principle).<\/p>\n\n\n\n File Delete<\/strong> \u2014 dispara quando um arquivo \u00e9 removido. \u00datil para limpar refer\u00eancias, remover imports \u00f3rf\u00e3os ou atualizar \u00edndices.<\/p>\n\n\n\n Prompt Submit<\/strong> \u2014 dispara quando o usu\u00e1rio envia um prompt ao agente. Permite adicionar contexto automaticamente a cada intera\u00e7\u00e3o.<\/p>\n\n\n\n Pre\/Post Tool Use<\/strong> \u2014 dispara antes ou depois que o agente invoca uma ferramenta (leitura de arquivo, escrita, shell, AWS). Hooks de Pre Tool Use podem bloquear a execu\u00e7\u00e3o de uma ferramenta se detectarem um problema. Hooks de Post Tool Use podem rodar formata\u00e7\u00e3o de c\u00f3digo ap\u00f3s cada escrita, por exemplo.<\/p>\n\n\n\n Manual<\/strong> \u2014 hooks acionados sob demanda pelo desenvolvedor. Ideais para revis\u00f5es de c\u00f3digo completas antes de um PR ou escaneamento de seguran\u00e7a antes de um deploy.<\/p>\n\n\n\n Cada Kiro Hook executa um dos dois tipos de a\u00e7\u00e3o, e a escolha impacta custo e performance:<\/p>\n\n\n\n Agent Prompt (“Ask Kiro”)<\/strong> \u2014 envia um prompt em linguagem natural ao agente de IA, que analisa o contexto e executa a tarefa. Ideal para a\u00e7\u00f5es que exigem compreens\u00e3o de c\u00f3digo (atualizar testes, gerar documenta\u00e7\u00e3o, sugerir refatora\u00e7\u00e3o). Consome cr\u00e9ditos do plano Kiro, pois dispara um novo loop do agente.<\/p>\n\n\n\n Shell Command (“Run Command”)<\/strong> \u2014 executa um comando shell local (linter, formatter, script de build). N\u00e3o consome cr\u00e9ditos, \u00e9 mais r\u00e1pido e determin\u00edstico. Ideal para a\u00e7\u00f5es que n\u00e3o dependem de contexto de IA.<\/p>\n\n\n\n A documenta\u00e7\u00e3o de Hook Actions<\/a> recomenda usar Shell Command para tarefas determin\u00edsticas e Agent Prompt para tarefas que exigem interpreta\u00e7\u00e3o de contexto. Uma boa pr\u00e1tica \u00e9 combinar os dois: um hook de Shell Command que roda o linter ap\u00f3s cada save, e um hook de Agent Prompt que atualiza testes quando um componente muda.<\/p>\n\n\n\n O hook mais popular entre times que usam TDD. Configure uma vez e nunca mais esque\u00e7a de atualizar testes ao modificar um componente:<\/p>\n\n\n\n Evento:<\/strong> File Save <\/p>\n\n\n\n Padr\u00e3o:<\/strong> A\u00e7\u00e3o:<\/strong> Agent Prompt <\/p>\n\n\n\n Instru\u00e7\u00e3o:<\/strong> “Quando este arquivo for salvo, verifique se existe um arquivo de teste correspondente em Evita que credenciais, tokens e chaves de API entrem acidentalmente no reposit\u00f3rio:<\/p>\n\n\n\n Evento:<\/strong> Manual (antes do commit) <\/p>\n\n\n\n A\u00e7\u00e3o:<\/strong> Agent Prompt <\/p>\n\n\n\n Instru\u00e7\u00e3o:<\/strong> “Escaneie todos os arquivos modificados em busca de padr\u00f5es que possam ser credenciais expostas: chaves de API, tokens JWT, senhas hardcoded, URLs com credenciais embutidas. Se encontrar algo suspeito, liste os arquivos e linhas com uma descri\u00e7\u00e3o do risco.”<\/p>\n\n\n\n Mant\u00e9m a documenta\u00e7\u00e3o sincronizada com o c\u00f3digo sem esfor\u00e7o manual:<\/p>\n\n\n\n Evento:<\/strong> File Save <\/p>\n\n\n\n Padr\u00e3o:<\/strong> A\u00e7\u00e3o:<\/strong> Agent Prompt <\/p>\n\n\n\n Instru\u00e7\u00e3o:<\/strong> “Quando um arquivo de endpoint de API for modificado, atualize a se\u00e7\u00e3o correspondente no README.md com os novos par\u00e2metros, tipos de retorno e exemplos de uso.”<\/p>\n\n\n\n Este \u00e9 um exemplo de Kiro Hook que usa Shell Command em vez de Agent Prompt, ou seja, n\u00e3o consome cr\u00e9ditos. Roda o formatter ap\u00f3s cada escrita de arquivo pelo agente:<\/p>\n\n\n\n Evento:<\/strong> Post Tool Use (filtro: A\u00e7\u00e3o:<\/strong> Shell Command <\/p>\n\n\n\n Comando:<\/strong> Os Kiro Hooks tamb\u00e9m suportam integra\u00e7\u00e3o com MCP servers externos. A documenta\u00e7\u00e3o de exemplos<\/a> mostra um hook que valida se arquivos HTML\/CSS seguem os padr\u00f5es de um design do Figma via Figma MCP.<\/p>\n\n\n\n Um dos maiores benef\u00edcios dos Kiro Hooks n\u00e3o \u00e9 a automa\u00e7\u00e3o em si \u2014 \u00e9 a padroniza\u00e7\u00e3o de qualidade independente do n\u00edvel de experi\u00eancia do desenvolvedor. Um junior e um senior que salvam o mesmo tipo de arquivo recebem o mesmo feedback autom\u00e1tico, as mesmas verifica\u00e7\u00f5es de seguran\u00e7a e a mesma documenta\u00e7\u00e3o atualizada.<\/p>\n\n\n\n Hooks s\u00e3o uma forma de institucionalizar o conhecimento do time. Quando um desenvolvedor senior identifica um padr\u00e3o de erro recorrente, ele cria um hook, e esse conhecimento passa a ser aplicado automaticamente para todos, sempre, sem depender de code review.<\/p>\n\n\n\n Para configurar o contexto que guia o comportamento dos hooks, leia: Steering Files no Kiro: como dar contexto persistente ao agente<\/a><\/strong>. E para entender como hooks se integram ao fluxo de specs, leia: Spec-Driven Development com Kiro<\/a><\/strong>.<\/p>\n\n\n\nsrc\/**\/*.tsx<\/code>) e uma a\u00e7\u00e3o<\/strong> que o Kiro executa em resposta. Os hooks ficam armazenados na pasta .kiro\/hooks\/<\/code> do projeto e devem ser versionados no Git para que toda a equipe compartilhe as mesmas automa\u00e7\u00f5es.<\/p>\n\n\n\nTipos de eventos que disparam Kiro Hooks<\/strong><\/h2>\n\n\n\n
Dois tipos de a\u00e7\u00e3o: Agent Prompt vs Shell Command<\/strong><\/h2>\n\n\n\n
Exemplos pr\u00e1ticos de Kiro Hooks essenciais<\/strong><\/h2>\n\n\n\n
Hook de atualiza\u00e7\u00e3o de testes<\/strong><\/h3>\n\n\n\n
src\/**\/*.tsx<\/code> ou src\/**\/*.ts<\/code> <\/p>\n\n\n\ntests\/<\/code>. Se existir, atualize os testes para refletir as mudan\u00e7as. Se n\u00e3o existir, crie um arquivo de testes b\u00e1sico com os principais casos de uso do componente.”<\/p>\n\n\n\nHook de seguran\u00e7a pr\u00e9-commit<\/strong><\/h3>\n\n\n\n
Hook de documenta\u00e7\u00e3o de API<\/strong><\/h3>\n\n\n\n
src\/api\/**\/*.ts<\/code> ou routes\/**\/*.js<\/code> <\/p>\n\n\n\nHook de formata\u00e7\u00e3o autom\u00e1tica (Shell Command)<\/strong><\/h3>\n\n\n\n
fs_write<\/code>) <\/p>\n\n\n\nnpx prettier --write {file}<\/code> ou cargo fmt --all<\/code><\/p>\n\n\n\nHook de valida\u00e7\u00e3o de design com Figma<\/strong><\/h3>\n\n\n\n
Como Kiro Hooks padronizam a qualidade em times<\/strong><\/h2>\n\n\n\n