CLAUDE.md Guide スキル
CLAUDE.md に記載すべき内容と構成のベストプラクティスを提供。
Instructions
このスキルは CLAUDE.md の適切な構成と内容について詳しく説明します。
CLAUDE.md とは
プロジェクトのルートに配置する Markdown ファイル。Claude Code がセッション開始時に自動的に読み込み、プロジェクト固有のコンテキストとして使用します。
配置場所: ./CLAUDE.md（プロジェクトルート）
推奨構成
基本テンプレート
# プロジェクト名
## 概要
プロジェクトの目的と主要機能の簡潔な説明。
## 技術スタック
- 言語: TypeScript
- フレームワーク: Next.js 15
- データベース: PostgreSQL
- パッケージマネージャー: pnpm
## ディレクトリ構造
src/
├── app/ # Next.js App Router
├── components/ # React コンポーネント
├── lib/ # ユーティリティ
└── types/ # 型定義
## 開発コマンド
| コマンド | 説明 |
|---------|------|
| `pnpm dev` | 開発サーバー起動 |
| `pnpm build` | 本番ビルド |
| `pnpm test` | テスト実行 |
| `pnpm lint` | リント実行 |
## コーディング規約
- 変数名・関数名は英語（camelCase）
- コメントは日本語
- 型定義は明示的に記述
## 重要な制約
- 本番環境への直接デプロイは禁止
- `.env` ファイルはコミットしない
推奨サイズ
| 規模 |
推奨行数 |
説明 |
| 小規模 |
50-100行 |
シンプルなプロジェクト |
| 中規模 |
150-300行 |
一般的なプロジェクト |
| 大規模 |
300行以下 |
超えたら rules に分離 |
警告: 300行を超えたら rules フォルダへの分離を検討してください。
記載すべき内容
必須項目
| 項目 |
内容 |
例 |
| プロジェクト概要 |
目的と主要機能 |
「ECサイトのバックエンドAPI」 |
| 技術スタック |
使用技術一覧 |
言語、フレームワーク、DB |
| 開発コマンド |
日常的に使うコマンド |
dev, build, test, lint |
推奨項目
| 項目 |
内容 |
例 |
| ディレクトリ構造 |
主要ディレクトリの説明 |
src/, tests/, docs/ |
| コーディング規約 |
命名規則、スタイル |
camelCase, 日本語コメント |
| 重要な制約 |
守るべきルール |
禁止事項、セキュリティ |
オプション項目
| 項目 |
内容 |
| アーキテクチャ概要 |
全体構成図や設計方針 |
| API エンドポイント概要 |
主要な API の一覧 |
| 環境変数一覧 |
必要な環境変数（値は除く） |
避けるべき内容
rules に移動すべき
| 内容 |
理由 |
移動先 |
| 詳細な実装パターン |
肥大化防止 |
rules/patterns.md |
| 特定ファイル形式のルール |
paths 条件活用 |
rules/typescript.md |
| テスト規約（詳細） |
独立管理 |
rules/testing.md |
| セキュリティ規約（詳細） |
独立管理 |
rules/security.md |
記載すべきでない
| 内容 |
理由 |
| 秘密情報（API キーなど） |
セキュリティリスク |
| 一時的なメモ |
メモリを汚染 |
| 変更履歴 |
Git で管理 |
| 冗長な説明 |
トークン効率低下 |
imports の活用
巨大な CLAUDE.md を避けるため、imports を活用:
# プロジェクト名
## 概要
...
## 詳細ドキュメント
アーキテクチャの詳細は @./docs/architecture.md を参照。
API 設計は @./docs/api-design.md を参照。
階層別 CLAUDE.md
サブディレクトリにも CLAUDE.md を配置可能:
project/
├── CLAUDE.md # プロジェクト全体
├── src/
│ ├── CLAUDE.md # src 固有のルール
│ └── components/
│ └── CLAUDE.md # コンポーネント固有
└── tests/
└── CLAUDE.md # テスト固有
注意: 階層が深いほどスコープが限定される。
Examples
最小構成
# my-project
## 概要
シンプルな TODO アプリ。
## 技術スタック
- TypeScript
- React
- Vite
## コマンド
- `npm run dev` - 開発
- `npm test` - テスト
規約付き構成
# my-project
## 概要
...
## コーディング規約
### 命名規則
- 変数・関数: camelCase
- クラス・型: PascalCase
- 定数: UPPER_SNAKE_CASE
### コメント
- 公開 API には JSDoc 必須
- 複雑なロジックには説明コメント
