Contexte historique

Avant l’avènement des agents génératifs, l’auteur consacre entre cinq et dix minutes à rédiger une description de commit détaillée. Cette pratique vise à regrouper l’ensemble des informations utiles, à expliciter le quoi et, surtout, le pourquoi du changement. Le texte est souvent rédigé à la première personne (« I did this because… »), ce qui facilite la relecture ultérieure et la compréhension par le futur lecteur, y compris le développeur lui‑même.

Enjeux de l’IA générative

Avec les outils d’« agentic coding », le code et les messages de commit sont produits automatiquement. Le problème majeur identifié est l’absence de contexte complet : les agents ne disposent pas toujours des discussions, tickets ou décisions hors ligne qui justifient une modification. En l’absence de ce why réel, l’IA génère une justification factice, ce qui peut conduire à des descriptions incohérentes avec la motivation réelle du changement.

Rôle du message de commit comme outil de réflexion

Écrire soi‑même le message oblige le développeur à relire le code, à résumer les modifications et à réévaluer les décisions prises. Ce processus de rédaction agit comme un outil de pensée : si l’auteur ne parvient pas à formuler le « why », il signale qu’il ne maîtrise pas pleinement la modification, augmentant ainsi le risque de livrer un composant incompris. De plus, les phrases temporaires (« I am doing this until we… ») permettent de consigner des critères de sortie qui ne sont généralement pas codés ni documentés ailleurs.

Limites et bonnes pratiques

Confier entièrement la rédaction à l’IA ne résout pas le besoin de vérification humaine. Même avec un contexte enrichi via chat ou outils, l’agent peut produire un message convaincant mais erroné ; seul le développeur peut confirmer que le code correspond à la description. La recommandation de l’auteur consiste donc à maintenir la rédaction manuelle du commit, même lorsque le code est généré automatiquement, afin de garantir une double validation : code + description. Cette approche prévient les dérives liées à des justifications artificielles et conserve une trace explicative fiable pour les mainteneurs futurs.