AGENTS.md

1# AGENTS.md
2 
3This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
4 
5## 必ず日本語で回答してください
6 
7## 横断的ルール（自動読み込み）
8 
9以下の`.Codex/rules/`配下のルールが全て自動的に適用されます：
10 
11- **コード品質**: @.Codex/rules/code-quality.md
12- **セキュリティ**: @.Codex/rules/security.md
13- **開発フロー**: @.Codex/rules/development.md
14 
15## 階層別の詳細指示（path-specificルール）
16 
17作業ディレクトリに応じて、以下のpath-specificルールが自動的に適用されます：
18 
19| ルールファイル            | 適用パス                                           | 主な内容                                                      |
20| ------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |
21| @.Codex/rules/app.md      | `app/**/*.{ts,tsx}`                                | App Router開発、API開発、認証ミドルウェア、エラーハンドリング |
22| @.Codex/rules/features.md | `features/**/*.{ts,tsx}`                           | Shared機能、Todo機能、状態管理、カスタムフック                |
23| @.Codex/rules/testing.md  | `tests/**/*.{ts,tsx}`, `**/*.{test,spec}.{ts,tsx}` | テスト戦略、環境設定、データ一貫性                            |
24 
25## プロジェクト概要
26 
27これは、App Routerとフィーチャーベースアーキテクチャを使用したNext.js 16のtodoアプリケーションです。
28 
29### 開発コマンド
30 
31```bash
32# 開発
33npm run dev              # Turbopackで開発サーバーを起動
34npm run build           # クリーンビルド（.nextディレクトリ削除＋ビルド）
35npm start               # 本番サーバーを起動
36 
37# コード品質
38npm run lint            # ESLintを自動修正で実行
39npm run prettier        # Prettierでコードをフォーマット
40npm run format          # prettierとlintの両方を実行
41 
42# テスト
43npm run test            # テスト（watch mode）
44npm run test:run        # テスト一回実行
45npm run test:coverage   # カバレッジ付きテスト実行
46npm run test:ui         # Vitest UIモードでテスト実行
47npm run test:e2e        # Playwright E2Eテスト（MSW使用）
48npm run test:e2e:ui     # Playwright UIモードでE2Eテスト
49 
50# Docker統合テスト
51npm run docker:test     # Firebase Emulator環境起動
52npm run docker:test:run # 統合テスト実行（Firebase Emulator + tsx）
53npm run docker:test:down # Docker環境停止
54 
55# Firebase Emulator
56npm run emulator:start  # 開発用Firebase Emulator起動
57npm run emulator:test   # テスト用Firebase Emulator起動
58 
59# モック
60npm run msw:init        # Mock Service Workerを初期化
61```
62 
63### 現在の技術スタック
64 
65- **フレームワーク**: Next.js 16（App Router + Turbopack）
66- **認証**: NextAuth.js v5（beta）- カスタム認証プロバイダー
67- **バックエンド**: Firebase Admin SDK（Firestore + Auth）
68- **UI**: Material-UI（MUI）+ Tailwind CSS
69- **状態管理**: React Context + データ取得用SWR
70- **ドラッグ＆ドロップ**: @dnd-kit/core（タスクの並び替え用）
71- **バリデーション**: Zodスキーマ
72- **テスト**: Vitest + React Testing Library + MSW
73- **モック**: MSW（Mock Service Worker）
74 
75### アーキテクチャ概要
76 
77- **ディレクトリ構造**: フィーチャーベース設計（`features/`内で機能自己完結）
78- **ルーティング**: Next.js App Router + ルートグループ`()`による整理
79- **API構造**: 管理者用`(admin)/`、一般用`(general)/`、認証用`auth/`に分離
80- **詳細構造**: [@todoApp-submodule/docs/PRODUCTS.md](../todoApp-submodule/docs/PRODUCTS.md#プロジェクト構造)参照
81 
82### 重要なプロジェクト注意事項
83 
84- **本番環境ではTypeScriptビルドエラーを無視（`ignoreBuildErrors: true`）**
85  - **理由**: 開発時にエディタのリアルタイム型チェックと`tsconfig.json`の厳密な設定で型安全性を確保済み。本番ビルド時の型チェックをスキップすることでビルド速度を向上させるため。
86- **開発時のAPIモック用MSWを使用**
87  - **理由**: ユニットテスト時にFirebase Emulatorを起動せずに高速なテスト実行を実現するため。
88- **キャッシュ制御ヘッダー付きのVercelデプロイ設定**
89  - **理由**: 静的アセットの効率的なキャッシュ配信と、動的コンテンツの適切な更新を両立するため。
90 
91## 開発パターン
92 
93- 新しい機能は`features/`内で自己完結させる（共通は`features/shared/`）
94- **Admin API**: `app/api/(admin)/`、**General API**: `app/api/(general)/`、**Auth API**: `app/api/auth/`
95- 新規APIでZodバリデーション推奨（既存APIは`trimAllSpaces` + 手動チェックの場合あり）
96- 詳細: [@.Codex/rules/app.md](rules/app.md) / [@.Codex/rules/features.md](rules/features.md)
97 
98## テストガイドライン
99 
100- **UTカバレッジ**: 100%達成済み（493テスト）
101- **統合テスト**: Docker + Firebase Emulator（ポート3002/4000/8080/9099）
102- **詳細ガイド**: [@.Codex/rules/testing.md](rules/testing.md)参照
103 
104## Codex 実行ポリシー
105 
106- `/codex:review` は常にバックグラウンドで実行する（`--background` フラグを自動付与）
107- `/codex:rescue` はタスクの複雑さに応じて自動判断する（フラグ省略で自動選択）
108