Claude Code用CLAUDE.md：検証できるプロジェクトルール

長い希望一覧だけではClaude Codeの動作は予測しやすくなりません。良いルールは、許可する変更、境界、確認方法をファイル・diff・コマンド・終了コードで示します。

小さな契約

# 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.

「良いコードを書く」は検証できません。「npm testを実行し、コマンド、終了コード、変更パスを報告する」なら確認できます。

秘密情報と競合

API Key、CI token、実際の個人情報をCLAUDE.mdへ書かないでください。placeholderを使い、必要な値は環境変数やCIのsecret storeから渡します。共通ルールはルート、package固有ルールはpackageの近くに置きます。ローカル例外で全体のsecurityルールを無効にしてはいけません。

可逆テスト

1. 一つのtest fileでlocal variableだけを変更させます。
2. git diff --checkとgit diff --statを確認します。
3. 契約に書いたtest commandを実行します。
4. 別ファイルが変わった、またはcommandと終了コードがない場合は却下します。

Claude CodeのAPI設定はBetterTokenドキュメントで確認できます。