CLAUDE.md に書いたのに Claude が従わない — 原因を6つに切り分ける

Claude Code のCLAUDE.mdファイルに「pnpmを使え」と書いても、実際にはnpmが走る。「コミット前にテスト」と指示しても実行されない。こうした「指示が効かない」という症状は、原因が6つに分かれるという実態について、技術者向けに整理した記事だ。最も多い原因は、そもそもCLAUDE.mdが「設定ファイル」ではなく「毎回渡されるお願いの文書」だという誤解。設定ファイルなら100%効くが、お願いの文書は確率的にしか効かない。これはAIツール導入時の落とし穴としてAIの鬼が最も警告したいポイントである。なぜなら、中小企業がAIを導入する際、大抵は「これを書けば自動化される」という期待を持つからだ。実際には、ナレッジベースに詰め込んだ指示、プロンプトに埋め込んだルール、これらはすべて確率的であり、100%の強制力を持たないのだ。一方、確実に効く方法もある。permission設定やhookという仕組みを使えば、モデルの判断を通さずに強制できる。つまり、AIツール導入の現場設計において「これは指示では強制できない領域」という線引きを予め理解しておくことが、後々の工数ロスを防ぐ。AIツール導入は単なる技術導入ではなく、「AIの限界を理解した上で、別の手段で補う」という運用設計がセットで必要なのである。