AGENTS.md permettent simplement de fournir à Cascade des instructions adaptées au contexte, qui s’appliquent automatiquement selon l’emplacement du fichier dans votre projet. C’est particulièrement utile pour définir des directives de code propres à un répertoire, des décisions architecturales ou des conventions de projet.
Comment ça fonctionne
AGENTS.md (ou agents.md), Devin Desktop le détecte automatiquement et l’intègre au même moteur de Règles que celui utilisé par .devin/rules/ (et l’ancien .windsurf/rules/) — à ceci près que le mode d’activation est déduit de l’emplacement du fichier plutôt que du frontmatter :
- Répertoire racine : traité comme une règle toujours active — l’intégralité du contenu est incluse dans le prompt système de Cascade à chaque message.
- Sous-répertoires : traités comme une règle glob avec un motif généré automatiquement de
<directory>/**— le contenu n’est appliqué que lorsque Cascade lit ou modifie des fichiers dans ce répertoire.
AGENTS.md un excellent moyen de fournir des indications ciblées sans encombrer un unique fichier de configuration global.
Création d’un fichier AGENTS.md
AGENTS.md ou agents.md dans le répertoire souhaité. Le fichier est rédigé en Markdown simple, sans frontmatter particulier.
Exemple de structure
Exemple de contenu
AGENTS.md pour un répertoire de composants React :
Découverte et périmètre
AGENTS.md dans tout votre espace de travail :
- Analyse de l’espace de travail : tous les fichiers
AGENTS.mdprésents dans votre espace de travail et ses sous-répertoires sont détectés - Prise en charge des dépôts Git : pour les dépôts Git, Devin Desktop recherche également dans les répertoires parents jusqu’à la racine du dépôt Git
- Insensible à la casse :
AGENTS.mdetagents.mdsont tous deux reconnus
Périmètre automatique
AGENTS.md est le périmètre automatique en fonction de l’emplacement du fichier :
Cela signifie que vous pouvez avoir plusieurs fichiers
AGENTS.md à différents niveaux, chacun fournissant des consignes de plus en plus spécifiques pour les répertoires correspondants.
Bonnes pratiques
AGENTS.md :
- Gardez des instructions ciblées : chaque
AGENTS.mddoit contenir des instructions pertinentes pour le rôle de son répertoire - Utilisez une mise en forme claire : les listes à puces, les en-têtes et les blocs de code permettent à Cascade de suivre plus facilement les instructions
- Soyez précis : des exemples concrets et des conventions explicites sont plus efficaces que des consignes vagues
- Évitez les redondances : ne répétez pas les instructions globales dans les fichiers de sous-répertoire ; ils héritent de celles des répertoires parents
Directives relatives au contenu
Comparaison avec les règles
AGENTS.md et les Règles fournissent tous deux des instructions à Cascade, ils répondent à des besoins différents :
Utilisez
AGENTS.md si vous souhaitez des instructions simples basées sur l’emplacement. Utilisez les Règles si vous avez besoin de mieux contrôler quand et comment les instructions sont appliquées.