.claude/rules/

Le répertoire .claude/rules/ est un emplacement pour organiser les instructions spécifiques au projet en plusieurs fichiers markdown, plutôt qu'un seul grand CLAUDE.md. Chaque fichier dans ce répertoire représente un sujet distinct, tel que testing.md ou api-design.md. Ces fichiers sont découverts récursivement, permettant une organisation plus poussée dans des sous-répertoires.

Les règles placées dans .claude/rules/ sans champ paths dans le frontmatter sont chargées par défaut au début d'une session, similaire au fichier CLAUDE.md principal. Cependant, les règles qui incluent un champ paths sont considérées comme limitées au chemin. Ces règles limitées au chemin ne sont chargées que lorsque Claude travaille activement avec des fichiers qui correspondent aux modèles globaux spécifiés, par exemple, src/**/*.{ts,tsx}. Ce mécanisme aide à gérer la fenêtre de contexte en chargeant les instructions pertinentes uniquement lorsque nécessaire, améliorant ainsi l'efficacité. Les règles limitées au chemin sont déclenchées lorsque Claude lit des fichiers correspondant au modèle, pas nécessairement à chaque utilisation de l'outil.

Les règles personnelles peuvent être placées dans ~/.claude/rules/. Ces règles globales s'appliquent à tous les projets et sont chargées avant les règles spécifiques au projet, donnant effectivement aux règles du projet une priorité plus élevée. Le système prend en charge les liens symboliques, permettant l'utilisation d'un ensemble de règles partagées à travers plusieurs projets en les liant dans le répertoire .claude/rules/ de chaque projet.

Il est important de distinguer ces règles des skills. Les règles sont chargées dans le contexte soit au début d'une session, soit lorsque des fichiers correspondants sont ouverts. Pour les instructions spécifiques à une tâche et ne nécessitant pas une présence constante dans le contexte, une skill est le mécanisme le plus approprié. Similaire aux règles, les fichiers SKILL.md ont également un champ paths dans leur frontmatter, qui contrôle quand une compétence s'active automatiquement en fonction de la correspondance des fichiers.