À mesure que les agents IA deviennent des participants réguliers des projets logiciels, la documentation doit évoluer pour servir à la fois les lecteurs humains et machines. Cette étude de cas montre comment une équipe a convergé vers un plan de gouvernance à travers des problèmes réels, une expérience délibérée et deux séries de discussions sur les compromis. Le défi central : aider les personnes et les agents à comprendre rapidement l'état actuel du projet tout en préservant le contexte de pourquoi les changements ont eu lieu, comment ils ont été exécutés et vérifiés. Le cadre résultant équilibre le contexte historique avec la clarté opérationnelle, évitant le piège de la sur-documentation. Les principales idées incluent le traitement de la documentation comme un système vivant, l'utilisation de preuves issues d'incidents réels pour guider les décisions, et la conception pour la lisibilité humaine et la parsabilité par les agents. Les équipes adoptant des flux de travail assistés par IA trouveront ici une référence utile pour leur propre stratégie documentaire.
Un cadre pratique de gouvernance documentaire qui sert à la fois les développeurs humains et les agents IA, développé à travers des incidents réels et des expériences itératives.