Vendredi, 14h00. Un nouveau développeur a repris le projet hier. Le client signale un bug de production - quelque chose ne va pas avec un travailleur de file d'attente personnalisé. Par le passé, ce scénario signifiait retrouver le développeur précédent qui connaît le code. Consultations, explications de contexte, perte de temps. Tout cela un vendredi.
Maintenant ? Le développeur ouvre Cursor, demande à l'IA à propos du travailleur de file d'attente, et l'IA répond par des réponses utiles parce qu'elle connaît le projet. Elle sait que vous utilisez DDEV, que le cache est configuré d'une certaine manière, que vous avez des préfixes de modules personnalisés. Comment est-ce possible ? Il suffit d'un seul fichier dans votre projet : AGENTS.md.
Problème : L'IA ne connaît pas votre projet
Vous reconnaissez probablement ce scénario : vous demandez de l'aide à l'IA (Cursor, Copilot, Claude) pour Drupal et obtenez un code qui… ne correspond pas.
L'IA ne sait pas que vous utilisez Paragraphs. Elle ne sait pas que votre thème a un nom différent de celui qu'elle suppose. Elle ne connaît pas votre structure de répertoires spécifiques. Elle ne connaît pas vos normes de codage.
Vous devez expliquer le contexte. À chaque conversation, à partir de zéro. L'IA hallucine parce qu'elle n'a pas de source d'information et ne sait pas à quoi ressemble votre projet.
Solution : AGENTS.md
AGENTS.md est un fichier dans le répertoire racine de votre projet que l'IA lit automatiquement au début de chaque session. Il contient tout ce que l'IA doit savoir sur le projet.
Il inclut des informations telles que : - Les versions de Drupal et PHP, - la structure du répertoire (web/, docroot/, ou autre chose), - les modules personnalisés et leurs préfixes, - le thème et son organisation, - les normes de codage (PHPStan, PHPCS), - le flux de travail (DDEV, Git, Composer), - les types de contenu, les entités, les intégrations de Drupal.
Ça semble beaucoup de travail ? Pour éviter cela, nous avons construit un outil simple qui génère automatiquement ce fichier.
Comment fonctionne notre outil AGENTS.md en pratique
Le processus entier prend environ 5 minutes :
- Téléchargez
AGENTS-TEMPLATE.mddepuis le dépôt (une commande curl dans README). - Copiez l'invite de README dans votre outil d'IA.
- L'IA scanne votre projet - elle vérifie composer.json, la configuration, les modules, le thème.
- Vous obtenez un
AGENTS.mdprêt à l'emploi et personnalisé pour votre projet.
Vous faites cela une fois et vous en bénéficiez dans chaque session d'IA.
L'outil fonctionne avec des assistants comme : Cursor, Copilot, Claude Code, Codex, Aider, Gemini CLI, Roo Code, Zed, Devin - et probablement d'autres que nous n'avons pas encore testés.
Dépôt : github.com/droptica/drupal-agents-md
Qu'est-ce qui change après avoir ajouté AGENTS.md ?
Je ne vais pas prétendre que "la productivité a augmenté de 47%" parce que je ne l'ai pas mesuré. Mais voici ce que j'ai remarqué sur les projets avec AGENTS.md :
L'intégration de nouvelles personnes est plusieurs fois plus rapide. Les nouveaux développeurs n'ont pas à demander "quelles sont les conventions ?", "comment s'appelle le thème ?", "qu'utilisez-vous pour le cache ?". L'IA le sait déjà et suggère en fonction du projet.
Le débogage avec contexte. Lorsque vous signalez un problème, vous n'avez pas besoin d'écrire une description élaborée de l'architecture. L'IA sait que vous avez des Paragraphs, que vous utilisez un module spécifique pour les files d'attente, que le cache fonctionne d'une certaine manière.
Moins d'explications, plus de codage. Au lieu de commencer chaque conversation par "nous utilisons DDEV, nous avons web/ comme racine, les préfixes des modules sont xyz_" - vous écrivez simplement ce que vous voulez faire. Cela améliore l'expérience de développement de la même manière que de meilleurs outils améliorent les flux de travail de l'édition de contenu.
Moins d'hallucinations. L'IA n'invente pas des choses qui ne sont pas dans le projet. Elle sait ce qui est installé, quelles entités existent, quelles dépendances sont là - de la même manière que les modules AI de Drupal utilisent le contexte du projet pour générer du contenu.
3 éléments d'AGENTS.md que nous sommes encore en train de peaufiner
Pour être clair, AGENTS.md n'est pas tout en superlatifs. Il y a quelques choses sur lesquelles nous travaillons encore :
- Les grands projets génèrent de gros fichiers. Si vous avez 50 modules personnalisés et une architecture complexe, AGENTS.md peut être long. Nous travaillons à ce que l'IA prenne seulement ce qui est nécessaire dans un contexte donné.
- Le fichier a besoin de mises à jour avec des changements majeurs. Vous ajoutez un nouveau module, changez la structure - il vaut la peine de régénérer le fichier. Ce n'est pas automatique (encore).
- Il dépend de l'organisation de votre projet. Si votre code est chaotique, AGENTS.md documentera ce chaos. L'IA saura qu'il y a un désordre, mais elle ne corrigera pas le désordre elle-même.
Que contient le modèle AGENTS.md prêt à l'emploi ?
Le modèle couvre la plupart des choses qui comptent dans un projet Drupal :
- Environnement : DDEV, flux de travail Git, Composer.
- Normes de codage : PHPStan, PHPCS, PHPUnit, Codeception, Xdebug.
- Développement : normes de codage, entités, modules, formulaires, base de données.
- Drupal moderne : headless/API, SEO, multilingue.
- Frontend : thèmes, SCSS, optimisation JS/CSS, mise en cache.
- Opérations : gestion de configuration, performances et sécurité du site web, dépannage, audits automatiques.
Si quelque chose manque pour votre projet, vous pouvez ajouter vos propres sections. C'est juste un fichier de démarque ordinaire.
Outil AGENTS.md - résumé
En quelques minutes, vous pouvez ajouter AGENTS.md à votre projet Drupal et voir immédiatement la différence dans la précision des suggestions de l'IA.
Dépôt : github.com/droptica/drupal-agents-md
Et si vous cherchez une agence Drupal qui s'occupera du développement de votre projet en utilisant les dernières technologies, contactez-nous.
