CLAUDE.md

なぜ学ぶか： 毎回「このプロジェクトはNext.jsで、秘密はサーバーに置いて…」と説明するのは非効率で、忘れればAIは同じミスを繰り返します。CLAUDE.mdは「プロジェクトの取扱説明書をAIに常に持たせる」仕組み。前のトピックの『制約』を、毎回の指示から常設ルールに格上げできます。

CLAUDE.md＝AIへの常設メモ

リポジトリ直下に置くと、Claude Codeが作業のたびに自動で読みます。プロジェクト固有のルールや前提を、毎回書かずに済みます。

書くべき：迷いやすい前提とルール

技術スタック・命名の方針・「やってはいけないこと」（例:秘密はクライアントに置かない）。レビュー観点をルール化すると特に効きます。

書かなくていい：コードを読めば分かること

個々の関数の中身やファイル一覧など。それはAIがコードを読めば分かります。CLAUDE.mdには『コードから読み取れない意図』を書きます。

簡潔に、育て続ける

長すぎると読まれ方が薄まります。要点を絞り、罠を踏んだり方針を決めたりするたびに追記して育てます。

CLAUDE.mdはAIに書かせてもいい

「今回の決めごとをCLAUDE.mdに追記して」と頼めます。ルールを決めたその場で追記する習慣が、育て続けるコツです。

CLAUDE.mdの例

# CLAUDE.md（プロジェクトの取扱説明書・AIが毎回読む）

## 技術スタック
- Next.js (App Router) / TypeScript / Tailwind CSS
- 認証・DB: Supabase

## 守ること（ガードレール）
- 秘密（APIキー等）はクライアントに置かない。Route Handler 経由で使う
- Supabase のテーブルには必ず RLS を設定する
- as any は使わない。型は絞り込みか zod で

## 方針
- コンポーネントは役割ごとに分割し、既存の @/components を再利用する
- データ取得は Server Component で行う（useEffect 初期取得はしない）

## 完了の目安
- npm run build が通る / 型エラーなし
- データ表示は loading・error・空・正常の4状態を実装

書くのは「コードを読んでも分からない意図とルール」。Phase 01〜06で学んだ危険が、そのまま『守ること』の項目になります。レビュー観点を先に書けば、AIが自分でチェックしてくれます。

ステップ 1 / 2

← カリキュラム一覧へ戻る

※ カリキュラムの内容はAIが生成しており、誤りが含まれる場合があります。正確な情報は公式ドキュメント等でご確認ください。