Antes da IA, eu escrevia descrições de commit bem longas para mudanças importantes, levando de cinco a dez minutos para redigir e reler. Eu fazia isso para incluir todas as informações úteis, explicar o quê e o porquê, e ajudar meu eu futuro a entender o raciocínio. Escrever em primeira pessoa, como "eu fiz isso porque…", tornava o processo mais pessoal e reflexivo. Não era só sobre a mensagem; a escrita me ajudava a reavaliar minhas decisões de código, às vezes levando a mudanças diferentes ou melhores.

Agora, com a codificação agêntica, a IA escreve código e descrições de commit. O debate foca em ler código escrito por IA, mas acho as descrições de commit escritas por IA mais difíceis. Agentes não têm o contexto completo espalhado por ferramentas, e quando não sabem o 'porquê', fabricam raciocínio, o que é perigoso. Dar aos agentes todo o contexto via chat ou ferramentas ajuda a explicar o 'porquê' claramente, mas não resolve o problema de verificação: só eu posso confirmar que o código corresponde à descrição.

Então, eu mesmo escrevo a mensagem de commit. Isso me força a refletir sobre as mudanças feitas pela IA e garantir que tudo esteja como pretendido. Se não consigo explicar o 'porquê', estou enviando algo que não entendo. A descrição do commit serve como ferramenta de pensamento, ajudando-me a completar frases como "estou fazendo isso até que…" com critérios de saída que a IA não pode inferir. Escrever o 'porquê' revela se você realmente entende o que está enviando.