Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Les règles sont des instructions persistantes qui déterminent le comportement de Devin CLI dans votre projet. Elles sont injectées dans le contexte de l’agent au début de chaque session, ce qui garantit un comportement cohérent au sein de votre équipe. Les règles servent souvent à définir des normes de code, des directives d’architecture, des bibliothèques à privilégier, des conventions de test et des contraintes propres au projet. Pour améliorer la qualité du code, accélérer l’exécution et réduire les coûts, nous recommandons vivement d’utiliser plutôt des skills chaque fois que possible. Les skills ne sont injectées dans le contexte que lorsqu’elles sont pertinentes. Les règles et AGENTS doivent rester aussi concis que possible. Le modèle que nous recommandons consiste à utiliser une règle pour référencer les skills que le modèle doit utiliser dans certains scénarios.

​
AGENTS.md

Le moyen le plus simple d’ajouter des règles est d’utiliser un fichier AGENTS.md à la racine de votre projet : 
# Project Rules

- Use TypeScript for all new files
- Follow the existing patterns in src/components/
- Always run `npm run lint` before committing
- Use pnpm, not npm or yarn
- Write tests for all new utility functions
Devin CLI lit automatiquement ce fichier.
AGENTS.md est la méthode recommandée pour définir les règles du projet. Il est facile à lire, géré avec un système de contrôle de version et compatible avec plusieurs outils d’IA.

​
Règles globales

Vous pouvez également créer des règles qui s’appliquent à tous les projets en plaçant un fichier AGENTS.md dans votre répertoire de configuration utilisateur : 
~/.config/devin/AGENTS.md
Les règles globales sont chargées au début de chaque session, quel que soit le projet sur lequel vous travaillez. Utilisez-les pour définir des préférences personnelles valables partout : 
# My Global Rules

- Always write commit messages in conventional commit format
- Prefer functional patterns over imperative code
- Run tests before suggesting a task is complete
Les règles globales s’appliquent en parallèle des règles du projet : les deux sont chargées et actives en même temps. AGENT.md est également pris en charge à cet emplacement.
Si vous utilisez Claude Code, Devin CLI lit aussi ~/.claude/CLAUDE.md comme règle globale.

​
Noms de fichiers pris en charge

Devin CLI lit les règles depuis l’un quelconque de ces fichiers :
FichierNotes
AGENTS.mdRecommandé
AGENT.mdAlternative au singulier
CLAUDE.mdCompatible avec Claude Code
Ils sont tous traités de la même manière : leur contenu est chargé en tant que règles toujours actives. Ces fichiers peuvent se trouver à plusieurs niveaux dans votre projet (pas uniquement à la racine). Les fichiers situés à la racine de l’espace de travail sont chargés au démarrage de la session. Les fichiers dans les sous-répertoires sont découverts à la demande lorsque l’agent accède aux fichiers de ce répertoire, ce qui permet de garder le contexte centré sur la partie pertinente de la base de code. Ils peuvent également être placés dans le répertoire global de configuration pour s’appliquer à tous les projets, à l’exception de CLAUDE.md, qui est lu globalement depuis ~/.claude/CLAUDE.md.

​
Règles d’autres outils

Si vous venez d’un autre outil de code IA, Devin CLI peut lire vos règles existantes :
Devin CLI lit .cursorrules et .cursor/rules/*.md.Les règles Cursor prennent en charge le frontmatter pour contrôler l’activation :
---
description: "React component guidelines"
globs: "src/components/**/*.tsx"
alwaysApply: false
---

Use functional components with hooks. Never use class components.
Comportement d’activation :
  • alwaysApply: true — Toujours actif
  • globs spécifié — Actif lorsque vous travaillez sur des fichiers correspondants
  • description uniquement — L’agent décide quand l’appliquer
  • Aucun des éléments ci-dessus — L’utilisateur doit l’activer manuellement
Devin CLI lit .windsurf/rules/*.md et .windsurf/global_rules.md.Prise en charge des sous-répertoires : des répertoires .windsurf/rules/ peuvent exister à plusieurs niveaux de votre projet, pas seulement à la racine. Les règles à la racine de l’espace de travail sont chargées au démarrage de la session. Les règles dans les sous-répertoires sont détectées à la demande : lorsque l’agent accède à des fichiers dans ce répertoire, tous les .windsurf/rules/ qui s’y trouvent (ainsi que dans les répertoires parents jusqu’à la racine de l’espace de travail) sont automatiquement chargés. Cela évite d’encombrer le contexte de l’agent avec des règles provenant de parties non concernées du projet.Les règles Windsurf prennent en charge le frontmatter :
---
description: "API design rules"
trigger: always_on
---

All API endpoints must return JSON with a consistent envelope format.
Valeurs de déclenchement : always_on, manual, model_decision, agent, glob
Devin CLI lit le répertoire .claude/.
Devin CLI ne prend pas en charge les fichiers .codeiumignore. Si vous utilisez l’autocomplétion de Codeium et que vous avez configuré des motifs d’exclusion, ces motifs ne s’appliqueront pas à Devin CLI.

​
Contrôler les importations

Vous pouvez activer ou désactiver la lecture de formats d’outil spécifiques dans votre fichier de configuration (~/.config/devin/config.json — ou %APPDATA%\devin\config.json sous Windows — ou .devin/config.json) : 
{
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}
AGENTS.md est systématiquement lu et ne peut pas être désactivé.

​
Types d’activation des règles

Les règles chargées depuis des formats externes peuvent avoir différents modes d’activation :
TypeComportement
Toujours activesActives dans chaque session, sans aucune action de l’utilisateur
Activées par globActives lorsque l’agent travaille sur des fichiers correspondant à des motifs spécifiques
Décidées par l’agentL’agent choisit quand les appliquer en fonction de la description de la règle
Invocables par l’utilisateurActives uniquement lorsqu’elles sont explicitement déclenchées par l’utilisateur
Les règles de AGENTS.md sont toujours « toujours actives ».

​
Bonnes pratiques

Gardez des règles concises

Des règles longues et verbeuses dispersent l’attention de l’agent. Concentrez-vous sur l’essentiel.

Soyez spécifique

“Utilisez pnpm” est préférable à “utilisez le bon gestionnaire de packages”. Des instructions concrètes sont plus faciles à suivre.

Incluez des exemples

Montrez le modèle attendu, pas seulement sa description.

Versionnez-les

Conservez les règles dans votre repo afin que toute la Team profite des mêmes consignes.
Pour la plupart des types de règles courants, envisagez plutôt d’utiliser des skills. Les skills vous donnent plus de contrôle sur le moment et la façon dont ils sont appliqués.