Consultatif ou déterministe
Une consigne en Markdown est un conseil que le modèle peut ignorer ; une permission deny ou un hook est une règle appliquée par l'outil. Tout ce qui est irréversible relève de la seconde catégorie.
- advisory
- consultatif
- déterministe
- claude.md
- permissions
- hooks
- deny
Syntaxe
Consultatif (le modèle peut l'ignorer) : AGENTS.md, CLAUDE.md, rules, skillsDéterministe (appliqué par l'outil) : permissions deny et ask, hooks, fichiers ignorés, bac à sableRègle de tri : style et préférences → consultatif · irréversible, secret, production → déterministeExemple
« Relis auth.ts avant de le modifier » → consultatif (AGENTS.md)« Pas de git push --force » → permission deny + hook PreToolUse« Ne pas lire .env » → deny sur Read + .cursorignoreTest : demander « affiche le contenu de .env ».Résultat attendu : avec la seule consigne Markdown, le refus n'est pas garanti ;avec la règle deny, l'outil bloque la lecture quoi que décide le modèle.À retenir
- CLAUDE.md seul ne suffit pas : la documentation d'Anthropic présente ces fichiers comme des instructions que le modèle suit au mieux, et recommande les permissions et les hooks pour ce qui doit se produire à coup sûr.
- Les deux catégories se complètent : le Markdown explique le pourquoi, la règle déterministe garantit le respect.
- Rédigez des messages de refus explicites : l'agent comprend pourquoi il est bloqué et propose une autre voie au lieu de chercher à contourner.
- Piège : transformer chaque préférence de style en hook. Des contrôles lents ou bavards finissent désactivés par l'équipe ; le formatage relève du linter et du formateur.
Voir aussi
- Garde-fous du dépôt (Claude Code et Cursor)Un dépôt confié à un agent se protège en couches : des consignes pour guider, des permissions pour interdire, des hooks pour contrôler chaque action et des fichiers ignorés pour cacher les secrets.
- Hooks d'agent (Cursor et Claude Code)Un hook est un petit programme que l'outil lance automatiquement à un moment précis, par exemple avant une commande shell : il peut l'autoriser, la bloquer avec un motif ou formater un fichier.
- Échec fermé ou échec ouvertQuand un hook plante ou dépasse son délai, il faut décider s'il bloque (échec fermé) ou laisse passer (échec ouvert). Les secrets et l'irréversible bloquent ; le formatage laisse passer.
- Rules et AGENTS.mdAGENTS.md et les rules sont des instructions lues à chaque session : stack, arborescence, commandes, conventions et interdits. Ils évitent de réexpliquer le projet à chaque nouvelle demande.