CLAUDE.md は1枚で書くな — グローバル/ハブ/プロジェクトの3層分離、実運用ファイルを実物公開

CLAUDE.md をプロジェクト直下に1枚だけ置く運用は、項目が20を超えたあたりで壊れ始める。無関係な指示が常時コンテキストに乗る、別プロジェクトの手順が漏れ込む、どこを直せばいいか分からなくなる。こうした破綻の原因は「書き方」ではなく「置き場所の分類」だ。この記事は筆者が実際に運用している3層構成を公開している。グローバル（個人の好みと受け取り方）、ハブ（プロジェクトの入口管理）、プロジェクト（その仕事の手順）に分けることで、各層が肥大化を防ぎ、効きが安定する仕組みだ。

AIの鬼から見て面白いのは、この分類思想だ。ほとんどの人は CLAUDE.md を「指示ファイル」と思う。だが筆者はそれを「情報の置き場所の設計問題」として捉えた。グローバルには「敬語をやめる」「図は SVG で描く」といった個人スタイルだけを置き、「この台帳を必ず読む」といったプロジェクト固有の手順は隔離する。その結果、AIは迷わずに指示を適用し、別プロジェクトでは無関係な指示に邪魔されない。これは「同じAIモデルなのに使い勝手が変わる」という現象の正体を示している。AIの行動は指示の内容ではなく、構造で決まるということだ。

中小企業がAIを組織に組み込むなら、この3層分離は必須になる。各部門が勝手に CLAUDE.md を足し算していれば、AI の挙動は予測不能になり、結果の再現性は失われる。逆に「グローバルは組織スタイル、ハブは部門の入口、プロジェクトはその仕事の手順」と決めておけば、新人がどのプロジェクトに入っても AI の応答は安定する。つまり、AI導入のコストは技術ではなく「情報設計」なのだ。その設計を一度きちんとやれば、後の効きは自動的に高まる。