$ man context-wiki/claude-md

CLAUDE.md ファイルはプロジェクトルートに配置されます。Claude がセッションを開始するとき、最初に読み込むファイルです。AIチームメイトのためのオンボーディングドキュメントだと考えてください。Claude が他のファイルを読む前に、あなたのプロンプトを処理する前に、コードを確認する前に、まず CLAUDE.md を読みます。これにより、システム全体で最も優先度の高いコンテキストとなります。ここに書いた内容が、その後のすべてのやり取りに影響を与えます。

パターン

AIの設定には3つの階層があり、順番に読み込まれます。 CLAUDE.md が最初に読み込まれます。環境のデフォルト値、パッケージ管理ルール、コードスタイルの設定、言語のデフォルト設定。これが基盤です。作業内容に関係なく、すべてのセッションに適用されます。 スキルは呼び出し時に読み込まれます。/deploy と入力すると、デプロイスキルファイルがコンテキストに読み込まれます。/tracker と入力すると、トラッカースキルが読み込まれます。スキルはワークフロー固有のもので、トリガーしない限り読み込まれません。 ルールは対応するファイルを開いたときに読み込まれます。ブログ記事を開くと、ブログのフォーマットルールが読み込まれます。コンポーネントを編集すると、コンポーネントパターンルールが読み込まれます。ルールはファイル固有のもので、編集中の内容に基づいて有効になります。 この階層は重要です。CLAUDE.md がベースラインを設定します。スキルがワークフローのコンテキストを追加します。ルールがファイル固有のコンテキストを追加します。これらが組み合わさることで、あなたが何も説明しなくても、Claude は全体像を把握できます。

プロのコツ

CLAUDE.md は、すべてのセッションに適用される内容に集中させましょう。環境の詳細：OS、シェル、主要なプログラミング言語。パッケージ管理ルール：インストール方法、権限の扱い方、バージョンの確認方法。コードスタイルのデフォルト：JavaScript より TypeScript 優先、フォーマットの設定、インポートの規約。 ワークフロー固有の指示を CLAUDE.md に入れてはいけません。それはスキルファイルに属します。ファイル固有のパターンを CLAUDE.md に入れてはいけません。それはルールファイルに属します。CLAUDE.md は短く、汎用的であるべきです。特定の場面でしか適用されないルールは、ここには属しません。 私の CLAUDE.md は数段落です。環境情報、パッケージ管理ルール、言語のデフォルト設定。それだけです。それ以外はすべてスキルとルールに配置し、毎回のセッションでコンテキストウィンドウを消費するのではなく、必要に応じて読み込まれるようにしています。

アンチパターン

ワークフローのドキュメント全体、コーディング標準、スタイルガイド、プロジェクトアーキテクチャをすべて CLAUDE.md に入れている人を見たことがあります。ファイルが500行以上に膨れ上がります。問題は、Claude が毎回のセッションでそのすべてを読み込むことです。たとえ90%が現在のタスクと無関係でも。これはコンテキストウィンドウの空間を無駄にし、異なるワークフローの指示が互いに矛盾する場合、実際にモデルを混乱させることがあります。 CLAUDE.md はスリムに保ちましょう。汎用的なデフォルトのみ。それ以外はすべてスキル（ワークフロー用）とルール（ファイルパターン用）に移動しましょう。こうすることで、Claude は記録したすべての情報の洪水ではなく、現在のタスクに必要なコンテキストだけを取得します。