IA: geração de mensagens de commit e documentação
O curso trata de como entregar a um assistente de IA o material certo para escrever mensagens de commit, descrições de pull request e documentação de projeto. O ponto de partida é o histórico de commits do próprio repositório e a convenção que ele revela. As aulas mostram como passar a saída de git diff --staged e git status em vez da lembrança da mudança, e como colar o git log recente para a IA seguir o padrão do projeto. Também tratam das quatro partes de uma boa descrição de PR e de afirmações sobre CI baseadas nos jobs do ci.yml. A última aula leva um diff por todas as etapas.
O que você vai aprender
- ✓Ler a convenção de commits de um projeto no histórico do git log
- ✓Montar prompts para a IA com a saída de git diff --staged e git status
- ✓Pedir uma descrição de PR com o que mudou, o porquê, como foi verificado e o alcance do estrago
- ✓Escrever afirmações sobre o CI que nomeiam os jobs do ci.yml
- ✓Basear documentação gerada no código-fonte e apontar comandos que conferem de novo
O que um histórico de commits já ensina
Leia o histórico recente deste projeto, deixando de fora os commits de merge, e um padrão aparece sem que ninguém precise explicá-lo. Este é o main em 2026-10-05, a partir de logo abaixo dos dois commits mais novos, que corrigiram um bug de área de transferência:
Ler a aula completa grátis →Currículo
7 aulasO que um histórico de commits já ensina
O histórico de commits revela uma convenção que nenhum arquivo de configuração registra e que padrões genéricos de IA ignoram.
Dando à IA o diff, não a memória
Montar o prompt com git diff --staged e git status mantém a mensagem de commit presa ao que mudou.
Seguindo a convenção do projeto, e não um modelo genérico
Colar o git log recente permite à IA seguir a convenção do projeto, ou usar um padrão genérico quando não há nenhuma.
Do commit à descrição do pull request
Uma descrição de PR responde o que mudou, por que, como foi verificado e o alcance do estrago se estiver errado.
Baseando a descrição do PR no que o CI confere
O CI deste repositório roda Brakeman, auditoria do importmap e RuboCop, sem job de RSpec, então o PR deve citar essas verificações em vez de dizer "todos os testes passam".
Aplicando a mesma disciplina a documentos gerados
Documentação gerada precisa do artefato original, de estrutura clara e de um comando que confira de novo o que envelhece.
Um diff, da mensagem de commit à descrição do pull request
Uma migration de índice passa por todas as etapas, da coleta do diff até uma descrição de PR bem fundamentada.