Idée principale

Ce dont un produit est fait — ses objets, les états qu'ils traversent, ce qui est interdit et à partir de quand — vit dans le code et dans la tête de quelques personnes. Cet arrangement tenait tant qu'on pouvait frapper à la porte du bon collègue : la règle manquante s'obtenait en trois minutes, et personne n'avait besoin de l'écrire.

Un agent à qui l'on confie une évolution ne frappe à aucune porte. Il reçoit quelques phrases de consigne et ce qu'il arrive à lire dans le code ; tout le reste, il le comble — de façon plausible, cohérente, et parfois fausse. Il ne signale pas qu'il a comblé, parce qu'il ne sait pas qu'il l'a fait.

D'où une mesure inattendue : l'écart entre ce qu'on voulait et ce qu'on récupère est exactement la part du modèle mental qu'on n'avait pas écrite. Chaque reprise après une évolution déléguée désigne une règle restée orale.

Pourquoi c'est important

Cela change la justification d'écrire le modèle du produit. L'argument classique — la mémoire d'entreprise, le départ d'un expert — a toujours perdu contre l'urgence, parce que son échéance est lointaine. Ici l'échéance est la semaine prochaine : ce qui n'est pas écrit se paie en reprises immédiates, visibles, attribuables.

Cela donne aussi un instrument de diagnostic gratuit. Plutôt que de deviner ce qu'il faudrait documenter, on laisse un agent travailler et on écrit ce qu'il a inventé. La liste des trous se fabrique toute seule.

Et la taille de l'artefact compte : quelques centaines de fiches d'objets entrent dans un contexte là où des milliers de fichiers de code n'y entrent pas — l'agent lit ce qu'il faut au lieu de fouiller.

Nuances et limites

Écrire le modèle ne rend pas l'agent plus intelligent : cela l'empêche seulement d'inventer là où une règle existe. Sur les zones où aucune règle n'a jamais été posée, il continuera de combler, et c'est alors une décision produit qui manque, pas une ligne de documentation.

Rien de tout cela n'est mesuré tant qu'on n'a pas comparé deux lots de demandes, traitées avec et sans le référentiel en contexte : le mécanisme est solide, le gain reste une attente.

Questions ouvertes

• Comment reconnaître, dans une sortie d'agent, ce qui a été comblé — sans relire la zone concernée aussi attentivement que si on l'avait écrite soi-même ?