CLAUDE.md とカスタマイズ

# プロジェクト概要

（プロジェクトの目的・技術スタックを簡潔に）

## 開発コマンド

```bash
npm run dev      # 開発サーバー起動
npm test         # テスト実行
npm run build    # 本番ビルド
npm run lint     # リント
```

## ディレクトリ構成

src/
  components/   # React コンポーネント
  routes/       # API ルート定義
  models/       # DB モデル
  utils/        # 共通ユーティリティ

## コーディング規約

- インデント：スペース 2 つ
- 文字列：シングルクォート
- セミコロン：不要
- 命名：変数・関数は camelCase、コンポーネントは PascalCase

## 禁止事項

- `moment.js` は使わない。代わりに `date-fns` を使う
- `config/secrets.js` は絶対に編集しない
- console.log を本番コードに残さない

# My App — React + TypeScript プロジェクト

EC サイトのフロントエンド。React 18 + TypeScript + Vite。
状態管理は Zustand、スタイルは Tailwind CSS を使用。

## 開発コマンド

```bash
npm run dev      # Vite 開発サーバー (localhost:5173)
npm test         # Vitest でテスト実行
npm run build    # 本番ビルド (dist/ に出力)
npm run typecheck  # TypeScript の型チェック
```

## 重要なルール

- コンポーネントは `src/components/` に置く
- ページコンポーネントは `src/pages/`
- 型定義は必ず明示する。`any` は使わない
- Props の型は interface で定義（type alias 不可）
- テストファイルは `*.test.tsx` の形式でコンポーネントと同じ場所に置く

## 禁止

- `src/store/auth.ts` は直接編集しない（認証は `useAuth` hook 経由で）
- class コンポーネントは使わない（関数コンポーネントのみ）

# API Server — Node.js + Express + PostgreSQL

REST API サーバー。認証は JWT。ORM は Prisma。

## 開発コマンド

```bash
npm run dev            # nodemon で起動
npm test               # Jest でテスト
npx prisma migrate dev # DB マイグレーション実行
npx prisma studio      # DB の GUI 確認
```

## ルーティング規則

GET    /api/resources        # 一覧取得
GET    /api/resources/:id    # 1件取得
POST   /api/resources        # 新規作成
PUT    /api/resources/:id    # 更新
DELETE /api/resources/:id    # 削除

## エラーレスポンス形式

```json
{ "error": "エラーメッセージ", "code": "ERROR_CODE" }
```

## 注意事項

- DB アクセスは必ず `src/services/` 経由で行う（routes から直接 Prisma を使わない）
- 環境変数は `src/config/env.ts` から読む（`process.env` を直接使わない）

{
  // デフォルトで使用するモデル
  "model": "claude-sonnet-4-6",

  // 確認なしで実行できるツール（許可リスト）
  "allowedTools": [
    "Read",
    "Grep",
    "Bash(npm test)",
    "Bash(npm run lint)"
  ],

  // 絶対に使わせないツール（禁止リスト）
  "disabledTools": [
    "WebSearch"
  ],

  // MCP サーバーの登録（第4章参照）
  "mcpServers": {}
}

{
  "allowedTools": [
    "Read",              // ファイル読み込み（常に許可推奨）
    "Write",             // ファイル書き込み
    "Bash(git status)",  // 特定コマンドのみ許可
    "Bash(git diff)",
    "Bash(npm test)",
    "Bash(npm run *)"    // ワイルドカードで npm run 系を全許可
  ]
}

.claude/
└── commands/
    ├── review.md      # → /review で呼び出せる
    └── test.md        # → /test で呼び出せる

以下の観点でコードレビューを行い、問題点を日本語で報告してください。

- バグ・ロジックの誤り
- セキュリティ上の問題
- パフォーマンスの問題
- コーディング規約の違反

対象：$ARGUMENTS

# 引数なし
> /review

# ファイルを引数として渡す（$ARGUMENTS に入る）
> /review src/auth.js
> /test src/utils/format.js

.claude/
└── skills/
    ├── deploy.md      # デプロイ手順を定義
    └── onboarding.md  # 新メンバー向けセットアップ手順

# デプロイ手順

以下のステップを順番に実行してください。

1. `npm test` を実行してテストが全件パスすることを確認する
2. `npm run build` でビルドする
3. ビルド成果物を確認してエラーがないかチェックする
4. git でコミット・タグを打つ
5. デプロイスクリプト `scripts/deploy.sh` を実行する
6. デプロイ後にヘルスチェック URL にアクセスして動作を確認する

# 対話モード内でスラッシュコマンドで切り替え
> /model
# ↑ モデル一覧が表示されるので選択する

# 起動時にモデルを指定
claude --model claude-opus-4-8

# settings.json でデフォルトを変更
# "model": "claude-opus-4-8"