Inclua os resumos de projeto do Claude no seu repositório — eles são melhores que documentos humanos

Um desenvolvedor no HN compartilha um fluxo de trabalho prático: após usar o Claude em um projeto, peça a ele para escrever um resumo estruturado e de alto nível sobre o que foi resolvido e o que mudou, revise-o e faça commit no repositório. Os resumos são comparáveis em qualidade ao que o desenvolvedor escreveria, mas levam 10 segundos em vez de uma hora — e a revisão não leva nem perto de uma hora.

Pontos principais do post:

• Não descarte os documentos de handoff do Claude. Faça commit deles como PROJECT.md ou similar.
• O Claude também pode escrever uma visão geral nova do zero no final de um projeto.
• O desenvolvedor revisa e edita pessoalmente antes de commitar — o mesmo que faria com o trabalho de um programador humano.
• Um problema: o Claude copiou um parágrafo "Aprovado por" de um resumo anterior para o novo. Adicione instruções no CLAUDE.md para evitar isso.
• A dica não é óbvia, mas o autor considerou revolucionária para a continuidade do projeto.

Conclusão prática: ao final de qualquer projeto intensivo em Claude, peça a ele para gerar um resumo e faça commit. Pode economizar horas do próximo desenvolvedor — ou do seu futuro eu — vasculhando o histórico do git.