LLVM ouvre le débat sur l'AGENTS.md, et le consensus n'est pas là

Un fichier Markdown à la racine d’un dépôt, qui explique à un agent IA les règles de la maison : c’est tout ce que recouvre AGENTS.md. De nombreux projets open source en hébergent déjà un, et l’affaire est en général réglée en une pull request. Chez LLVM, non. La discussion ouverte le 2 septembre 2026 sur le Discourse du projet par Nick Desaulniers, développeur de longue date de LLVM, a reçu un accueil que Phoronix, qui la relate le 3 septembre, résume par un mot : mitigé.

Le fichier qui dit bonjour aux agents

L’idée est modeste. Plutôt que de laisser chaque agent IA deviner les conventions d’un projet, on les lui écrit noir sur blanc. Desaulniers a d’ailleurs ouvert une pull request en brouillon avec une version minimale : elle se contente de renvoyer l’agent vers la documentation LLVM sur la politique de contribution des outils IA, et vers les standards de codage. Rien de plus. Pas de recette, pas de prompt secret : un panneau indicateur.

La proposition mentionne aussi un CLAUDE.md, la déclinaison propre à un assistant en particulier. Ce qui pose au passage la question du nombre de fichiers de ce type qu’une racine de dépôt peut accueillir avant de ressembler à un couloir d’agence bancaire tapissé d’affichettes.

Le camp du bruit et le camp du principe

Certains développeurs sont pour. D’autres estiment que ces fichiers produisent surtout du bruit, sans efficacité démontrée — argument qu’on entend rarement formulé aussi calmement dans une discussion sur l’IA.

L’objection la plus intéressante est ailleurs : héberger un tel fichier irait à l’encontre du principe, en vigueur dans LLVM, de ne pas imposer dans le dépôt le workflow privé d’un développeur. Un AGENTS.md n’est pas de la documentation technique, c’est un réglage d’outil. Et le dépôt d’un projet n’est traditionnellement pas l’endroit où l’on range les préférences de son éditeur. Argument renforcé par un détail relevé dans la discussion : plusieurs contributeurs utilisent déjà leur propre matériel AGENTS.md, dans leurs dépôts privés. Le besoin existe, il est simplement déjà satisfait ailleurs.

La taille du projet, obstacle très concret

S’ajoute une difficulté qui n’a rien de philosophique : LLVM, ce n’est pas un projet, c’est un ensemble de sous-projets aux périmètres différents. Un fichier unique à la racine parlerait au nom de tous, avec la précision qu’on imagine. Un fichier par sous-projet multiplierait les documents à maintenir — et un fichier d’instructions qui n’est plus à jour ne rend pas l’agent neutre, il le rend confiant et faux.

C’est probablement pour cela que la version proposée est minimale au point d’être presque vide de contenu propre : elle ne dit pas comment contribuer, elle dit où c’est écrit. Difficile de faire plus prudent.

Ce que le débat teste réellement

Derrière le fichier, la vraie question posée à LLVM est celle de l’accueil : jusqu’où un projet d’infrastructure de cette taille souhaite-t-il faciliter le travail de contributeurs qui ne lisent pas la documentation mais avalent le dépôt. Aucune position n’a été arrêtée au 3 septembre 2026, et rien n’indique qu’elle le sera vite.

La version soumise se résume pourtant à demander poliment à l’agent d’aller lire la doc. Si même ce point ne fait pas consensus, c’est que le débat n’a jamais porté sur le fichier.