毎回の注意を、
ファイル1枚に置き換える。

確認日：2026年7月／Claude Code での利用を前提

CLAUDE.md は、プロジェクトのフォルダに置いておくと Claude Code が自動で読み込む、ただのテキストファイルです。特別な形式はありません。Markdownで書いた普通のメモです。

ここに「このプロジェクトではこうしてほしい」を書いておくと、毎回の会話で説明しなくても効くようになります。

• コーディング規約：命名規則、使ってよいライブラリ、書いてはいけない書き方。
• プロジェクトの前提：ディレクトリ構成、ビルドとテストの実行方法、動作環境。
• 社内固有のルール：レビューの通し方、コミットメッセージの形式、触ってはいけないファイル。

置き場所によって適用範囲が変わります。ここを理解しておくと、チーム運用の設計が楽になります。

• プロジェクトのルート：そのプロジェクトで作業するとき全員に効きます。リポジトリにコミットして共有するのが基本です。チーム共通のルールはここ。
• サブディレクトリ：そのディレクトリ以下の作業で効きます。フロントエンドとバックエンドでルールが違う場合など、部分的な上書きに使えます。
• ホームディレクトリ側（個人設定）：自分のすべての作業に効きます。個人の好みはここに書きます。チームで共有すべきでない内容の置き場です。

分け方の基準はシンプルです。「他の人にも守ってほしいこと」はプロジェクト側、「自分がそうしてほしいだけのこと」は個人側。

長く書くほど効く、というものではありません。むしろ**長いほど個々のルールは守られにくくなります。**効く書き方には型があります。

30行程度の出発点です。自社の内容に置き換えて使ってください。

プロジェクトのルートに置く CLAUDE.md

このプロジェクトについて

社内の受注管理システム。バックエンドは PHP / Laravel、フロントエンドは TypeScript / Vue。

開発コマンド

• 依存関係のインストール：（自社のコマンドを書く）
• テスト実行：（自社のコマンドを書く）
• ビルド：（自社のコマンドを書く）

守ってほしいこと

• 型宣言は必須。戻り値の型も省略しない。
• 比較は厳密比較を使う。あいまい比較は使わない。
• 1つの関数は50行以内。超える場合は分割を提案する。
• コメントは日本語で書く。自明なコメントは書かない。

やってほしくないこと

• 新しいライブラリを勝手に追加しない。必要なら先に提案する。
• 既存のテストを、通すために書き換えない。実装のほうを直す。
• 依頼されていないリファクタリングをしない。
• config/ 配下と本番用の設定ファイルは変更しない。

修正するときの手順

• 変更対象の関数の呼び出し元を先に確認し、影響範囲を把握する。
• 修正後は関連する既存テストを実行し、退行がないことを確認する。
• 影響範囲に他の修正が必要な場合は、既存の動作を維持する形で合わせて修正する。

「書いたのに守られない」という相談の原因は、ほぼ3つに絞られます。

• 長すぎる：100行を超えたあたりから守られない項目が増えます。まず削ってください。詳細な規約は別ファイルに切り出し、CLAUDE.md本体には要約と「詳細は◯◯を参照」だけを書く構成にすると扱いやすくなります。
• 矛盾している：「積極的に改善提案をして」と「依頼された範囲だけやって」が同居していないか。継ぎ足しで書いていると気づかないうちに矛盾が入ります。
• 抽象的すぎる：「きれいに書いて」「適切に処理して」は判定できません。数値や具体的な条件に置き換えてください。

直すときは一度に1点だけ変えてください。まとめて直すと、何が効いたのか分からなくなります。

個人で使う分にはここまでで十分ですが、チームで使うなら3つ決めてください。