CLAUDE.md 設定ガイド

/init

# プロジェクト名

## 概要
プロジェクトの目的と技術スタックを簡潔に説明する。

## 技術スタック

- ランタイム：Node.js 20
- フレームワーク：Next.js 15
- スタイリング：Tailwind CSS
- データベース：PostgreSQL + Prisma

## よく使うコマンド

- 開発サーバーの起動：`npm run dev`
- テストの実行：`npm test`
- プロダクションビルド：`npm run build`
- コードチェック：`npm run lint`

## コーディング規約

- TypeScript を使用し、`any` 型は禁止
- コンポーネントは関数型で記述する
- スタイリングは Tailwind のみ使用し、インライン style は書かない
- コミットメッセージの形式：`feat:` / `fix:` / `docs:` などのプレフィックス

## プロジェクト構造

- `src/app/` — Next.js App Router ページ
- `src/components/` — 再利用可能なコンポーネント
- `src/lib/` — ユーティリティ関数
- `prisma/` — データベーススキーマとマイグレーション

## 注意事項

- `prisma/migrations/` は変更せず、新しいマイグレーションのみ作成する
- すべての API ルートは `src/app/api/` にある
- 画像リソースは `public/images/` に配置する

## パッケージ管理
pnpm を使用し、npm や yarn は使わないこと。
依存関係のインストール：`pnpm install`
依存関係の追加：`pnpm add <パッケージ名>`

## テスト

- ユニットテスト：`vitest`、ファイル名は `.test.ts` で終わる
- E2E テスト：`playwright`、`tests/e2e/` に配置
- ユニットテストの実行：`pnpm test:unit`
- E2E の実行：`pnpm test:e2e`
- 新機能にはテストを必ず含める

## 禁止操作

- `console.log` を使わず、プロジェクトの `logger` モジュールを使用する
- `package-lock.json` を直接変更しない
- `main` ブランチに直接コミットせず、フィーチャーブランチを使用する

## アーキテクチャの説明
このプロジェクトはヘキサゴナルアーキテクチャ（Hexagonal Architecture）を採用しています：

- `domain/` — ビジネスロジック、外部フレームワークに依存しない
- `application/` — ユースケース、domain と infrastructure を調整する
- `infrastructure/` — データベース・HTTP などの外部アダプター
- `interfaces/` — Web コントローラー・CLI などのエントリーポイント
新機能はこの階層構造に従い、domain 層に外部依存を持ち込まないこと。

## 詳細情報

- API ドキュメント：`docs/api.md`
- デプロイ手順：`docs/deploy.md`
- データベーススキーマ：`prisma/schema.prisma`