Intégrer un agent dans le travail d'équipe

Jusqu'ici, tout ce cours vous concernait seul devant votre machine. Le passage à l'équipe change trois choses à la fois, et c'est là que la plupart des adoptions se dégradent : le volume de code proposé augmente sans que la capacité de relecture bouge, les conventions du projet ne sont plus dans une seule tête, et la question de savoir qui répond du code livré cesse d'être théorique.

Le symptôme est reconnaissable. Trois mois après l'arrivée de l'outil, l'équipe produit plus de demandes de fusion, elles sont plus grosses, la revue devient un tampon, et les incidents en production augmentent sans que personne sache lesquels imputer à quoi. Aucune de ces trois évolutions n'est causée par l'agent : elles viennent de ce que le processus n'a pas été ajusté à un débit de production multiplié.

Le fichier de conventions est un artefact d'équipe

Vous avez utilisé CLAUDE.md comme un carnet personnel. En équipe, il change de nature : il devient le seul endroit où les conventions implicites du projet sont écrites, et il est versionné avec le code.

Ce déplacement a un effet secondaire souvent plus précieux que le gain de productivité. Écrire une convention pour une machine oblige à la formuler sans ambiguïté, ce que la transmission orale entre développeurs permet d'éviter pendant des années. La première rédaction sérieuse de ce fichier fait généralement apparaître deux ou trois désaccords dont l'équipe ignorait l'existence.