第4章 — CLAUDE.md: プロジェクトの憲法

<!-- ❌ 悪い例 -->
- コードを綺麗に書いてください
 
<!-- ✅ 良い例 -->
- 変数名は camelCase、型名は PascalCase
- 関数は20行以内を目安に分割する
- `any` 型の使用禁止。`unknown` + 型ガードを使う

<!-- ❌ 検証できない -->
- パフォーマンスに気をつける
 
<!-- ✅ 検証できる -->
- バンドルサイズが 200KB を超える import は使わない
- N+1 クエリを書かない。必ず JOIN か eager loading を使う

<!-- ❌ 理由がない -->
- dayjs を使う。moment.js は使わない
 
<!-- ✅ 理由がある -->
- 日付操作には dayjs を使う（moment.js はバンドルサイズが大きすぎるため非推奨）

<!-- グローバル CLAUDE.md（~/.claude/CLAUDE.md）-->
- 日本語で回答する
- git commit は明示的な指示があるまで実行しない
 
<!-- プロジェクト CLAUDE.md -->
- スタック: Next.js 14 + TypeScript + Prisma
- テストは Vitest を使用
- コンポーネントは src/components/ に配置
 
<!-- .claude/rules/testing.md（paths: src/**/*.test.ts）-->
- describe ブロックはファイルごとに1つ
- mock は最小限に。実DBを使うインテグレーションテストを優先

# my-startup-app
 
## プロジェクト概要
- SaaS の顧客管理ツール（B2B）
- スタック: Next.js 14 (App Router) + TypeScript + Prisma + PostgreSQL
- デプロイ: Vercel
 
## セットアップ
pnpm install && pnpm dev
 
## コーディング規約
- TypeScript strict mode。any 禁止
- コンポーネントは src/components/ に配置（default export 禁止）
- API ルートは src/app/api/ に配置
- DB アクセスは src/lib/db/ の repository パターン経由のみ
- 直接 prisma.xxx.findMany() を呼ばない
 
## テスト
- pnpm test で Vitest 実行
- 新機能には必ずテストを書く
- DB テストは testcontainers で実 PostgreSQL を使う
 
## セキュリティ
- ユーザー入力は zod でバリデーション必須
- SQL は Prisma 経由のみ（生SQL禁止）
- 環境変数は .env.example に型定義を書く
- API レスポンスに内部エラーの詳細を含めない

<!-- .claude/rules/api-routes.md -->
---
paths:
  - "src/app/api/**/*.ts"
---
 
# API ルート規約
- すべてのエンドポイントで認証チェックを実施
- リクエストボディは zod スキーマでバリデーション
- レスポンスは { data, error, meta } の統一形式
- エラーは AppError クラスを throw（try-catch で握りつぶさない）

<!-- .claude/rules/components.md -->
---
paths:
  - "src/components/**/*.tsx"
---
 
# コンポーネント規約
- named export のみ（default export 禁止）
- Props 型は同ファイルで定義し export する
- クライアントコンポーネントは先頭に 'use client'
- Tailwind CSS のみ使用（CSS Modules 禁止）

<!-- ❌ CLAUDE.md にコードテンプレートを書く -->
新しい API ルートを作るときは以下のテンプレートを使え:
export async function GET(req: NextRequest) {
  // 100行のテンプレートコード...
}

<!-- グローバル CLAUDE.md -->
- テストには Jest を使う
 
<!-- プロジェクト CLAUDE.md -->
- テストには Vitest を使う