Une longue liste de préférences ne rend pas Claude Code prévisible. Une règle utile indique le changement autorisé, la limite et la preuve : fichier, diff, commande et code de sortie.

Petit contrat


# Project rules

Goal

Keep changes limited to the requested feature.

Checks

Run npm test and report the command, exit code, and changed files.

Forbidden

Do not read .env or run deploy.

Scope

packages/payments/CLAUDE.md wins only inside that directory.
Root security rules always apply.



« Écrire du bon code » n'est pas vérifiable. « Lancer `npm test` et rapporter commande, code et fichiers modifiés » l'est.

Secrets et conflits

Ne placez ni API Key, ni token CI, ni donnée personnelle réelle dans CLAUDE.md. Utilisez des placeholders et passez les valeurs nécessaires par l'environnement ou un coffre CI. Les règles générales restent à la racine, celles d'un package près du package. Une exception locale ne doit pas annuler la sécurité globale.

Test réversible

Demandez de renommer une variable locale dans un seul fichier de test.
Lancez git diff --check et examinez git diff --stat.
Exécutez le test indiqué dans le contrat.
Refusez le résultat si un autre fichier change ou si la commande et son code manquent.

Pour un flux API Claude Code distinct, vérifiez Base URL et modèle dans la documentation BetterToken.

CLAUDE.md pour Claude Code : règles vérifiables