Meu fluxo de trabalho Git do código Claude: pequenos commits, histórico limpo, medo zero

Antes de construir esse fluxo de trabalho, minhas sessões assistidas por IA produziam exatamente o que você temeria: commits de 800 linhas intitulados 'consertar coisas'. Claude Code escreve excelentes mensagens de commit, mas somente se você estruturar a sessão de forma que cada commit seja uma mudança coerente.

A unidade de trabalho é a tarefa, e eu afirmo isso explicitamente: 'Estamos fazendo uma coisa: extrair a validação do e-mail para um módulo compartilhado. Nada mais.' Claude fica feliz em corrigir os outros três bugs que detecta, e cada um desses desvios bem-intencionados é como você consegue uma diferença que ninguém pode revisar. Bugs relacionados vão para uma lista para mais tarde, no papel, fora da sessão.

Entre as tarefas, faço com que Claude execute o ritual: testes, depois prepare o diff e depois 'escreva a mensagem de commit do diff, commits convencionais, com menos de 72 caracteres.' Como o contexto da sessão contém exatamente uma tarefa, a mensagem é precisa. Como a diferença é pequena, a mensagem é específica. Este é o truque e é inteiramente uma questão de disciplina da sessão.

A estratégia da filial é mais importante para um agente, e não menos. Eu trabalho em ramificações de recursos e faço de Claude o revisor antes da fusão: 'revisar a diferença completa da ramificação em relação ao principal como um engenheiro sênior cético.' Ele detecta os problemas de commit cruzado que as revisões de diferença única deixam passar, como um auxiliar adicionado no commit dois e abandonado no commit cinco.

O benefício surpresa foi arqueológico. Seis meses depois, minha história parece um projeto humano bem administrado: cada mudança explicável em uma linha, cada reversão cirúrgica. Quando as sessões do Claude Code são estruturadas como pequenas tarefas comprometidas, a tendência da IA ​​para a amplitude é canalizada para a documentação em vez de se tornar uma dívida tecnológica.