プロジェクト別CLAUDE.mdテンプレート集 ― コピペで使える10パターン

# CLAUDE.md

## プロジェクト概要
**[アプリ名]** - [一言説明]
- [主要機能1]
- [主要機能2]
- [主要機能3]

## 技術スタック
- **言語**: TypeScript 5.x
- **フレームワーク**: React 18
- **ビルドツール**: Vite 5
- **状態管理**: Zustand / Redux Toolkit
- **スタイリング**: CSS Modules / Tailwind CSS
- **テスト**: Vitest + React Testing Library
- **リンター**: ESLint + Prettier

## プロジェクト構成
```
src/
├── components/        # 共通コンポーネント
│   ├── ui/           # ボタン、入力等の基礎UI
│   └── layout/       # Header, Footer等
├── features/          # 機能単位のモジュール
│   └── [feature]/
│       ├── components/
│       ├── hooks/
│       ├── api/
│       └── types.ts
├── hooks/             # 共通カスタムフック
├── lib/               # ユーティリティ
├── types/             # 共通型定義
└── App.tsx            # ルートコンポーネント
```

## コーディング規約
- 関数コンポーネント + hooks のみ使用
- コンポーネントファイルは PascalCase (例: UserCard.tsx)
- hooks は use プレフィックス (例: useAuth.ts)
- 型定義は interface 優先（type は union 等に限定）
- CSS Modules のクラス名は camelCase

## 開発コマンド
- `npm run dev` — 開発サーバー起動
- `npm run build` — プロダクションビルド
- `npm run test` — テスト実行
- `npm run lint` — ESLint実行
- `npm run preview` — ビルド結果プレビュー

# CLAUDE.md

## プロジェクト概要
**[アプリ名]** - [一言説明]

## 技術スタック
- **フレームワーク**: Next.js 14 (App Router)
- **言語**: TypeScript 5.x
- **DB**: PostgreSQL + Prisma ORM
- **認証**: NextAuth.js v5
- **スタイリング**: Tailwind CSS
- **デプロイ**: Vercel

## プロジェクト構成
```
src/
├── app/
│   ├── (auth)/          # 認証グループ
│   ├── (dashboard)/     # ダッシュボード
│   ├── api/             # Route Handlers
│   ├── layout.tsx       # Root Layout
│   └── page.tsx         # トップページ
├── components/
│   ├── ui/              # shadcn/ui コンポーネント
│   └── features/        # 機能別コンポーネント
├── lib/
│   ├── db.ts            # Prisma client
│   ├── auth.ts          # 認証設定
│   └── utils.ts         # ユーティリティ
├── prisma/
│   ├── schema.prisma    # スキーマ定義
│   └── migrations/      # マイグレーション
└── types/               # 型定義
```

## 重要な注意点
- App RouterのServer Components優先（use clientは最小限に）
- データ取得はServer Componentsでfetchまたはprisma直接
- 環境変数は .env.local に配置（コミット禁止）

## 開発コマンド
- `npm run dev` — 開発サーバー
- `npx prisma migrate dev` — マイグレーション
- `npx prisma studio` — DB GUI
- `npm run build` — ビルド

# CLAUDE.md

## プロジェクト概要
**[API名]** - [一言説明]

## 技術スタック
- **言語**: Python 3.12
- **フレームワーク**: FastAPI 0.110+
- **ORM**: SQLAlchemy 2.0
- **DB**: PostgreSQL 16
- **マイグレーション**: Alembic
- **テスト**: pytest + httpx
- **パッケージ管理**: Poetry / uv

## プロジェクト構成
```
app/
├── api/
│   ├── routes/          # エンドポイント定義
│   ├── deps.py          # 依存性注入
│   └── middleware.py    # ミドルウェア
├── models/              # SQLAlchemyモデル
├── schemas/             # Pydanticスキーマ
├── services/            # ビジネスロジック
├── core/
│   ├── config.py        # 設定管理
│   ├── security.py      # 認証・認可
│   └── database.py      # DB接続
├── tests/               # テスト
├── alembic/             # マイグレーション
└── main.py              # エントリポイント
```

## コーディング規約
- 型ヒントを必ず付ける
- docstringはGoogle Style
- 非同期処理はasync/awaitを使用
- 環境変数はpydantic-settingsで管理

## 開発コマンド
- `uvicorn app.main:app --reload` — 開発サーバー
- `pytest` — テスト
- `alembic upgrade head` — マイグレーション適用
- `ruff check .` — リンター

# CLAUDE.md

## プロジェクト概要
**[アプリ名]** - [一言説明]

## 技術スタック
- **言語**: PHP 8.3
- **フレームワーク**: Laravel 11
- **DB**: MySQL 8.0
- **フロント**: Blade + Alpine.js + Tailwind (Vite)
- **テスト**: PHPUnit + Pest
- **キャッシュ**: Redis

## プロジェクト構成
```
app/
├── Http/
│   ├── Controllers/     # コントローラー
│   ├── Middleware/       # ミドルウェア
│   └── Requests/        # フォームリクエスト
├── Models/              # Eloquentモデル
├── Services/            # ビジネスロジック
├── Repositories/        # データアクセス層
resources/
├── views/               # Bladeテンプレート
├── js/                  # JavaScript
└── css/                 # スタイル
database/
├── migrations/          # マイグレーション
├── seeders/             # シーダー
└── factories/           # ファクトリー
```

## コーディング規約
- PSR-12 準拠
- Fat Model, Skinny Controller
- FormRequestでバリデーション
- Repositoryパターンでデータアクセスを抽象化

## 開発コマンド
- `php artisan serve` — 開発サーバー
- `php artisan migrate` — マイグレーション
- `php artisan test` — テスト
- `npm run dev` — Vite開発サーバー

# CLAUDE.md

## プロジェクト概要
**[API名]** - [一言説明]

## 技術スタック
- **ランタイム**: Node.js 20 LTS
- **フレームワーク**: Express 4
- **言語**: TypeScript 5.x
- **DB**: MongoDB + Mongoose / PostgreSQL + Knex
- **認証**: JWT (jsonwebtoken)
- **テスト**: Jest + Supertest
- **バリデーション**: Zod

## プロジェクト構成
```
src/
├── routes/              # ルート定義
├── controllers/         # コントローラー
├── services/            # ビジネスロジック
├── models/              # データモデル
├── middleware/           # ミドルウェア
├── utils/               # ユーティリティ
├── types/               # 型定義
├── config/              # 設定ファイル
└── app.ts               # Express設定
```

## 開発コマンド
- `npm run dev` — ts-node-dev で開発
- `npm run build` — TypeScriptビルド
- `npm test` — テスト実行
- `npm run lint` — ESLint実行

# CLAUDE.md

## プロジェクト概要
**[サイト名]** - [一言説明]
- コーポレートサイト / LPページ

## 技術スタック
- HTML5 + CSS3 + JavaScript (ES6+)
- CSSフレームワーク: なし（カスタムCSS）
- ビルドツール: なし（そのまま配信）

## プロジェクト構成
```
├── index.html           # トップページ
├── about.html           # 会社概要
├── services.html        # サービス紹介
├── contact.html         # お問い合わせ
├── css/
│   └── style.css        # メインCSS
├── js/
│   └── main.js          # メインJS
└── images/              # 画像ファイル
```

## デザイン要件
- ブランドカラー: [メインカラー], [サブカラー]
- レスポンシブ対応（モバイルファースト）
- フォント: Noto Sans JP

## デプロイ
- FTPでサーバーにアップロード
- ドキュメントルート: /public_html/

# CLAUDE.md

## プロジェクト概要
**[プロジェクト名]** - [分析目的]

## 技術スタック
- **言語**: Python 3.11
- **分析**: pandas, numpy, scipy
- **可視化**: matplotlib, seaborn, plotly
- **ML**: scikit-learn, XGBoost
- **ノートブック**: Jupyter Lab
- **環境管理**: conda / venv

## プロジェクト構成
```
├── notebooks/           # Jupyterノートブック
│   ├── 01_eda.ipynb    # 探索的データ分析
│   ├── 02_preprocess.ipynb # 前処理
│   └── 03_modeling.ipynb   # モデリング
├── src/                 # 再利用可能なコード
│   ├── data/           # データ読込・変換
│   ├── features/       # 特徴量エンジニアリング
│   └── models/         # モデル定義
├── data/
│   ├── raw/            # 生データ（Git管理外）
│   └── processed/      # 加工済みデータ
└── reports/            # レポート・図表
```

## 注意事項
- data/raw/ はGit管理外（.gitignoreに含む）
- ノートブックは実行結果をクリアしてからコミット
- 再現性のためrandom_stateは42を使用

# CLAUDE.md

## プロジェクト概要
**[アプリ名]** - [一言説明]
- iOS / Android 対応モバイルアプリ

## 技術スタック
- **フレームワーク**: React Native 0.73 (Expo)
- **言語**: TypeScript
- **ナビゲーション**: React Navigation v6
- **状態管理**: Zustand
- **API通信**: TanStack Query
- **ストレージ**: AsyncStorage / SecureStore

## プロジェクト構成
```
src/
├── screens/            # 画面コンポーネント
├── components/         # 共通コンポーネント
├── navigation/         # ナビゲーション設定
├── hooks/              # カスタムフック
├── services/           # API通信
├── stores/             # 状態管理
├── utils/              # ユーティリティ
└── types/              # 型定義
```

## 開発コマンド
- `npx expo start` — 開発サーバー
- `npx expo run:ios` — iOSビルド
- `npx expo run:android` — Androidビルド
- `npm test` — テスト

# CLAUDE.md

## プロジェクト概要
**[プラグイン名]** - [機能説明]
- WordPress 6.4+ 対応プラグイン

## 技術スタック
- **言語**: PHP 8.0+
- **JS**: ES6+（WP Scriptsでビルド）
- **CSS**: SCSS
- **WordPress API**: REST API, Settings API, Hooks

## プロジェクト構成
```
plugin-name/
├── plugin-name.php      # メインプラグインファイル
├── includes/
│   ├── class-admin.php  # 管理画面
│   ├── class-public.php # フロント表示
│   └── class-api.php    # REST API
├── assets/
│   ├── js/             # JavaScript
│   └── css/            # スタイルシート
├── templates/           # テンプレートファイル
├── languages/           # 翻訳ファイル
└── tests/               # PHPUnitテスト
```

## コーディング規約
- WordPress Coding Standards準拠
- プレフィックス: [yourprefix]_ を全関数・クラスに付与
- フック名: [yourprefix]/hook_name 形式
- テキストドメイン: [plugin-text-domain]

## 開発コマンド
- `npm run build` — アセットビルド
- `npm run start` — ウォッチモード
- `composer test` — PHPUnit実行

# CLAUDE.md

## プロジェクト概要
**[拡張機能名]** - [機能説明]
- Manifest V3 対応Chrome拡張機能

## 技術スタック
- **言語**: TypeScript
- **ビルド**: Webpack 5 / Vite
- **UI**: React（popup / options）
- **ストレージ**: chrome.storage API
- **API**: Chrome Extensions API (Manifest V3)

## プロジェクト構成
```
src/
├── background/          # Service Worker
│   └── index.ts
├── content/             # Content Script
│   └── index.ts
├── popup/               # ポップアップUI
│   ├── Popup.tsx
│   └── index.html
├── options/             # 設定ページ
│   ├── Options.tsx
│   └── index.html
├── shared/              # 共通モジュール
│   ├── storage.ts
│   └── messaging.ts
├── types/               # 型定義
└── manifest.json        # 拡張機能マニフェスト
```

## 重要な注意点
- Manifest V3ではService Workerを使用（バックグラウンドページ廃止）
- Content Scriptはページのコンテキストで実行される
- chrome.storage.syncは100KBまで、localは5MBまで

## 開発コマンド
- `npm run dev` — ウォッチモード
- `npm run build` — プロダクションビルド
- `chrome://extensions/` で読み込み（デベロッパーモード）