Claude Code Hook Monitora o Acúmulo de WIP em Fluxos de Trabalho de Codificação com IA

Monitorando WIP em Fluxos de Trabalho de Codificação com IA

Um desenvolvedor criou um hook UserPromptSubmit para o Claude Code que aborda um problema comum no desenvolvimento assistido por IA: os agentes de IA não têm visibilidade sobre o acúmulo de trabalho em andamento. Enquanto a IA se concentra no prompt atual, as alterações não commitadas podem crescer, os commits podem se acumular sem serem enviados, os changesets podem não ser escritos e os PRs de release podem permanecer abertos por períodos prolongados.

Como o Hook Funciona

O hook implementa quatro verificações que monitoram diferentes pontos onde o código se acumula entre o editor e a produção:

• Verificação 1: Alterações não commitadas excedendo 200 linhas (tanto rastreadas quanto não rastreadas)
• Verificação 2: Três ou mais commits não enviados
• Verificação 3: Commits enviados sem um arquivo de changeset (o que impede a criação de PRs de release)
• Verificação 4: PRs de release que estão abertos há mais de 24 horas

As verificações 1 e 2 são executadas localmente usando comandos git e executam a cada envio de prompt, fornecendo feedback quase instantâneo. As verificações 3 e 4 exigem chamadas à API do GitHub, portanto, são executadas uma vez após cada operação de push.

Filosofia de Design

A principal decisão de design foi implementar essas verificações como sugestões em vez de bloqueios. O hook não impede a IA de trabalhar, mas fornece visibilidade através de dois canais:

• additionalContext injetado no contexto da IA
• Uma systemMessage impressa no terminal do usuário

Essa abordagem significa que não há um componente permissionDecision - tanto a IA quanto o desenvolvedor podem ver o estado atual do fluxo de trabalho sem interromper o processo de codificação.

Esse tipo de ferramenta é útil para desenvolvedores que desejam manter uma melhor supervisão de seus fluxos de trabalho de desenvolvimento assistido por IA, especialmente ao trabalhar em projetos maiores onde o WIP pode facilmente se acumular sem ser notado.