Aller au contenu
Pratique agentique

Les quatre couches d'instructions

Les consignes d'un agent viennent de quatre couches : vos règles personnelles, le fichier du projet, les rules ciblées par chemin et les skills chargés à la demande. Chaque consigne a sa place.

  • user rules
  • project rules
  • agents.md
  • skills
  • instructions
  • couches

Syntaxe

Modèle
1. Règles personnelles (User Rules, ~/.claude/CLAUDE.md) : vous suivent partout, non partagées2. Projet (AGENTS.md, CLAUDE.md, rules toujours actives)  : versionné, lu à chaque session3. Rules ciblées (globs sur des chemins)                   : chargées quand on touche ces fichiers4. Skills                                                 : chargés si la tâche correspond à leur descriptionÀ part : permissions et hooks, appliqués quoi que disent les quatre couches

Exemple

Exemple concret
« L'interface est en français »            → projet (AGENTS.md)« Réponds-moi de façon concise »           → règles personnelles« Conventions des fichiers prisma/ »       → rule ciblée sur prisma/**« Procédure d'ajout d'un plan Stripe »     → skill« Ne jamais pousser sans demande »         → projet + permission denyRésultat attendu : chaque consigne est écrite à un seul endroit.

À retenir

  1. Test du clone : si un nouvel équipier qui clone le dépôt a besoin de la consigne, elle va dans les fichiers versionnés, pas dans vos règles personnelles.
  2. Gardez les couches toujours actives courtes (deux ou trois rules au plus) et déplacez le détail dans des rules ciblées ou des skills.
  3. Quand deux couches se contredisent, le comportement devient imprévisible : supprimez la contradiction plutôt que d'ajouter une consigne « prioritaire ».
  4. Piège : recopier la même interdiction dans les quatre couches. Le jour où elle change, une copie oubliée contredit les autres.

Voir aussi