CLAUDE.md 設計パターン

優先順位（高→低）
1. プロジェクト CLAUDE.md（リポジトリルートの .claude/CLAUDE.md または CLAUDE.md）
2. グローバル CLAUDE.md（~/.claude/CLAUDE.md）
3. サブディレクトリの CLAUDE.md（作業ディレクトリに近いものが優先）

project-root/
├── CLAUDE.md          ← プロジェクト設定（推奨配置）
├── .claude/
│   └── CLAUDE.md      ← 別の配置オプション
├── src/
│   └── CLAUDE.md      ← サブディレクトリ固有の設定
└── ...

# プロジェクト名 - Claude Code 設定

## 技術スタック
- Node.js 22.x / TypeScript 5.x
- Next.js 14（App Router）
- PostgreSQL + Prisma ORM
- pnpm（npm 不可）

## コーディング規約
- 関数は arrow function で統一
- 型注釈を必ず付ける（`any` 禁止）
- コメントは日本語で書く

## コマンド
- 開発サーバー: `pnpm dev`
- テスト: `pnpm test`
- ビルド: `pnpm build`

## 禁止事項
- `node_modules/` の直接編集
- `.env` ファイルのコミット
- `npm` コマンドの使用（pnpm を使う）

## 自律性
不明な点は作業を止めず、最もよさそうな判断で進めてください。

# チームプロジェクト - Claude Code 設定

> **SSoT（Single Source of Truth）**: このファイルとチームの開発規約が一致していること。
> 矛盾がある場合はこのファイルを更新してください。

## 技術スタック
- Node.js 22.x / TypeScript 5.x
- Next.js 14（App Router）+ Tailwind CSS
- PostgreSQL + Prisma ORM
- pnpm（npm 不可）
- Vitest（テストフレームワーク）

## アーキテクチャルール
- コンポーネントは `src/components/` に配置（atomic design 準拠）
- API Routes は `src/app/api/` に配置
- DB操作は必ず `src/lib/db/` 経由（直接クエリ禁止）
- 環境変数は `src/lib/env.ts` の型安全な wrapper を使う

## コーディング規約
- ESLint + Prettier の設定に従う
- 関数コンポーネントのみ（クラスコンポーネント禁止）
- `any` 型の使用禁止。型が不明な場合は `unknown` を使う
- テストは最低限「ハッピーパス + エラーケース1つ」を作成

## コミット規約（Conventional Commits）
- feat: 新機能
- fix: バグ修正
- refactor: リファクタリング
- docs: ドキュメント変更
- test: テストの追加・修正

## コマンド
- `pnpm dev`: 開発サーバー起動
- `pnpm test`: テスト実行
- `pnpm test:watch`: ウォッチモード
- `pnpm lint`: Lint チェック
- `pnpm build`: 本番ビルド

## PR・レビュー方針
- PR は 1機能 = 1PR（最大200行の変更）
- セルフレビューを必ず実施してから PR を出す
- セキュリティに関わる変更は必ず2名以上のレビューを得る

## 禁止事項
- `node_modules/`, `.env*`, `secrets/` の編集
- main ブランチへの直接 push
- force push（緊急時は Issue 起票してチームに相談）
- 外部 API キーのハードコード

# エンタープライズプロジェクト - Claude Code 設定

> **優先順位**: セキュリティ > SSoT > 品質 > 速度
> **担当**: 迷ったら `CODEOWNERS` を参照してください。

## プロジェクト構造
apps/
├── web/        # Next.js フロントエンド（チームA担当）
├── api/        # Express API サーバー（チームB担当）
└── admin/      # 管理画面（チームC担当）
packages/
├── ui/         # 共有UIコンポーネント
├── shared/     # 共有ユーティリティ・型定義
└── config/     # 共有設定（ESLint/TypeScript等）

## 技術スタック
- Node.js 22.x / TypeScript 5.x（全パッケージ統一）
- pnpm workspaces（monorepo管理）
- Next.js 14 / Express 5 / React 18
- PostgreSQL + Prisma（apps/api のみ直接DB接続可）
- Redis（セッション・キャッシュ）

## アーキテクチャ原則
- フロントエンドからDBに直接アクセス禁止（必ず apps/api 経由）
- packages/ への変更は全チームのレビューが必要
- 環境変数は Vault から取得（ハードコード絶対禁止）
- APIの変更はOpenAPI仕様を先に更新してから実装

## セキュリティルール
- OWASP Top 10 を常時意識すること
- 認証/認可コードは `packages/auth/` 以外に書かない
- ユーザー入力は必ず zod でバリデーション
- SQL クエリは Prisma ORM 経由のみ（生SQL禁止）
- ログにPII（個人識別情報）を出力しない

## コマンド（リポジトリルートで実行）
- `pnpm dev`: 全サービス起動
- `pnpm dev --filter=web`: webのみ起動
- `pnpm test`: 全テスト実行
- `pnpm lint`: 全パッケージLint
- `pnpm build`: 全ビルド

## ブランチ戦略（GitHub Flow）
- `main`: 本番相当（直接 push 禁止）
- `develop`: 統合ブランチ
- `feature/*`: 機能開発
- `hotfix/*`: 緊急修正

## CI/CD
- PR 作成 → 自動テスト → コードレビュー → develop マージ
- develop → main のマージは週次リリース時のみ
- 本番デプロイは GitHub Actions 経由のみ（手動デプロイ禁止）

## 禁止事項
- 本番環境への直接デプロイ
- packages/ の直接編集（PR必須）
- 認証ロジックのコピー（共通ライブラリを使う）
- console.log の本番コミット（logger ライブラリを使う）

## Next.js 固有ルール
- App Router を使用（Pages Router は新規作成禁止）
- Server Components をデフォルトとし、必要な場合のみ 'use client' を付ける
- データ取得は Server Component で行う（クライアントサイドの fetch は例外のみ）
- Image コンポーネントを必ず使う（img タグ禁止）
- `next/font` でフォントを最適化する
- middleware.ts での認証チェックを必須とする
- Route Handlers は `src/app/api/` 配下に配置

## Python 固有ルール
- Python 3.12+ を使用
- パッケージ管理は uv（pip 直接使用禁止）
- 型ヒントを全関数に付ける（mypy strict モード）
- フォーマッタは ruff（black は使わない）
- テストは pytest（unittest 禁止）
- 非同期処理は asyncio / FastAPI のみ
- 環境変数は python-dotenv + pydantic-settings で管理

## コマンド
- `uv run python -m pytest`: テスト実行
- `uv run ruff check .`: Lint
- `uv run ruff format .`: フォーマット
- `uv run mypy .`: 型チェック

## Monorepo ルール
- パッケージ間の依存は `workspace:*` プロトコルを使う
- 共有コードは `packages/shared/` に置く（重複禁止）
- 各パッケージは独自の tsconfig.json を持つが、ルートを extends する
- `pnpm --filter <package>` でパッケージ指定実行
- changesets でバージョン管理（手動バンプ禁止）

## コマンド
- `pnpm --filter web dev`: web パッケージのみ起動
- `pnpm -r test`: 全パッケージのテスト実行
- `pnpm changeset`: バージョン変更を記録

# グローバル設定

## 基本動作
- 出力言語: 日本語
- 説明は簡潔に。実装よりもコードを優先する
- 確認なしで進められる場合は自律的に作業を進める

## 私のプログラミングスタイル
- 関数型プログラミングを好む
- 早期リターンパターン（ガード節）を優先
- 変数名は英語、コメントは日本語

## セキュリティ意識
- 環境変数やシークレットは絶対にコードに含めない
- パブリックリポジトリにプッシュする前に機密情報がないか確認する

- コードをきれいに書く
- セキュリティに注意する
- ベストプラクティスに従う

- 関数の行数は20行以内に収める
- ユーザー入力は必ず zod でバリデーションする
- `any` 型の使用禁止、代わりに `unknown` を使う

## データベース接続
- DB_URL: postgresql://user:password@localhost/mydb
- API_KEY: sk-xxxxx

## 環境変数
- DB_URL: `.env.local` を参照
- 環境変数の取得は `src/lib/env.ts` の型安全な wrapper を使うこと

## 詳細規約
詳細なコーディング規約は `docs/CODING_GUIDE.md` を参照してください。

## メンテナンスノート
- 最終更新: 2026-07-05
- 次回レビュー予定: 技術スタック変更時、または四半期ごと
- 更新担当: チームリード

project/
├── CLAUDE.md          ← 全体共通ルール（短く）
├── frontend/
│   └── CLAUDE.md      ← フロントエンド固有ルール
└── backend/
    └── CLAUDE.md      ← バックエンド固有ルール

- npm を使わない
- console.log を使わない
- any を使わない

- パッケージ管理: pnpm を使う（npm 不可）
- ログ出力: `src/lib/logger.ts` の logger を使う（console.log 不可）
- 型: 不明な型には `unknown` を使う（any 不可）

# [プロジェクト名]

## 技術スタック
- Node.js [バージョン] / TypeScript [バージョン]
- [フレームワーク名]
- pnpm

## コーディングルール
- TypeScript strict モード
- arrow function 統一
- コメントは日本語

## コマンド
- 開発: `pnpm dev`
- テスト: `pnpm test`
- ビルド: `pnpm build`

## 禁止
- node_modules/ 直接編集
- .env のコミット
- npm コマンド使用

# [プロジェクト名] - Claude Code 設定

> 優先順位: セキュリティ > 品質 > 速度

## 技術スタック
- Node.js [バージョン] / TypeScript [バージョン]
- [フロントエンドフレームワーク]
- [バックエンド/DB]
- pnpm

## アーキテクチャ
[ディレクトリ構造と責務を記述]

## コーディング規約
- ESLint + Prettier 設定に従う
- any 型禁止（unknown を使う）
- テスト: ハッピーパス + エラーケース最低1件

## コミット（Conventional Commits）
- feat / fix / refactor / docs / test / chore

## コマンド
- `pnpm dev` / `pnpm test` / `pnpm lint` / `pnpm build`

## 禁止
- main への直接 push
- .env* / secrets/ の編集・コミット
- force push（緊急時は Issue 起票）
- 外部 API キーのハードコード

## PR 方針
- 1機能 = 1PR（最大200行）
- セキュリティ変更は2名以上のレビュー必須

# [プロジェクト名] - Claude Code 設定

> 優先順位: セキュリティ > SSoT > 品質 > 速度
> 詳細は docs/CONTRIBUTING.md を参照

## リポジトリ構造
apps/
├── [サービス名]/  # [担当チーム]
packages/
├── shared/       # 共有ロジック（変更は全チームのレビュー必須）

## 技術スタック
- Node.js [バージョン] / TypeScript [バージョン]（全パッケージ統一）
- pnpm workspaces

## セキュリティルール
- 認証/認可は packages/auth/ 以外に書かない
- ユーザー入力は zod でバリデーション必須
- PII をログに出力しない
- Vault から環境変数取得（ハードコード禁止）

## アーキテクチャルール
- フロントエンドから DB 直接アクセス禁止
- packages/ 変更は全チームの承認必須
- API 変更は OpenAPI 仕様を先に更新

## コマンド
- `pnpm dev`: 全サービス起動
- `pnpm --filter [パッケージ] dev`: 個別起動
- `pnpm -r test`: 全テスト
- `pnpm changeset`: バージョン変更記録

## ブランチ戦略
- main（本番）/ develop（統合）/ feature/* / hotfix/*
- 本番デプロイは GitHub Actions のみ

## 禁止
- 本番への手動デプロイ
- packages/ の直接 push
- console.log の本番コミット（logger を使う）