検証できるClaude Code向けCLAUDE.mdルール

長い希望リストではagentは予測可能になりません。ruleには許可、禁止、検証可能な結果が必要です。workflowがAPIを使うなら、BetterToken Claude Code現行ガイドを開いて自分のAPI Keyを設定し、短いtestを実行します。Dashboardに期待するmodel、status、token usageが出ることを確認し、KeyはCLAUDE.mdではなく環境に置いてください。

小さな契約から始める

## Goal
- Keep changes limited to the requested feature.
## Checks
- Run `npm test` after code changes.
## Forbidden
- Do not read, print, or commit `.env`.

「quality code」は検証不能ですが、commandとexit codeは検証できます。

scopeと階層

現在のClaude Code Memoryドキュメントは、異なるscopeのinstructionsを発見する仕組みを説明しています。この例の「local package ruleは通常のroot ruleより優先できるがroot securityは無効にしない」は、projectが記述した契約であり、Claude Codeの普遍的な組み込み例外ではありません。見えているruleを確認してduplicateを削除します。

ruleの種類を分ける

種類	例	確認
goal	profileを読む	対象moduleだけ変更
boundary	migration禁止	diffにない
check	npm test	exit 0
style	既存名を使う	不要refactorなし

長い説明はlink付きでdocs/へ移します。

conflictと具体例

編集前にpackage.json、task files、local instructionsを読みます。存在しないcommandを作りません。二つのruleが違うcheckを要求するなら、検証可能なlocal ruleを一つ残します。

reversible test

test fileのlocal variableをrenameして次を実行します。

git diff --check
git diff --stat
npm test

別fileが変わった、またはcheckが無い場合はrejectします。

secretとmaintenance

API Key、CI token、個人data、.envをCLAUDE.mdに入れません。API_KEY=your_api_key_hereを使い、実値はenvironmentまたはsecret storeで渡します。test、package、directoryが変われば契約を見直します。

Sources

• Claude Code memory
• BetterToken Claude Code documentation