| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 6 | 4 | 0% |
| Commands | 0 | 18 | 0 | 0% |
| Section tags | 3 | 2 | 0 | 60% |
What each file covers
Sections
0 shared · 6 only in A · 4 only in B- − AGENTS.md
- − テストガイドライン
- − 階層別の詳細指示（path-specificルール）
- − Docker統合テスト
- − Firebase Emulator
- − Codex 実行ポリシー
- + Tech Stack
- + Frontend
- + Backend
- + Development Tools
Commands
0 shared · 18 only in A · 0 only in B- − npm run dev
- − npm run build
- − npm start
- − npm run lint
- − npm run prettier
- − npm run format
- − npm run test
- − npm run test:run
- − npm run test:coverage
- − npm run test:ui
- − npm run test:e2e
- − npm run test:e2e:ui
- − npm run docker:test
- − npm run docker:test:run
- − npm run docker:test:down
- − npm run emulator:start
- − npm run emulator:test
- − npm run msw:init
Section tags
3 shared · 2 only in A · 0 only in B- − build
- − agent-behaviour
- test
- lint-format
- testing-strategy
Line diff
sakatai11/todoApp-next · AGENTS.md
@@ −1 @@
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
sakatai11/todoApp-next · .clinerules/tech-stack.md
@@ +1 @@
1# Tech Stack
2
3Unless otherwise specified, follow the defined stack and common best practices.
4
5## Frontend
6
7Use the following only when necessary:
8
9- Language: TypeScript
10- Framework: Next.js (App Router)
11- UI: MUI, Tailwind CSS
12- State Management: React Hooks
13- Auth: NextAuth.js, Firebase Authentication (via Firebase Admin SDK)
14- Lint/Format: ESLint, Prettier
15- Drag & Drop: dnd-kit
16- Data Fetching: SWR
17- Validation: Zod
18
19## Backend
20
21- Language: Node.js (TypeScript)
22- API: REST
23- Database: Firestore (via Firebase Admin SDK)
24
25## Development Tools
26
27- Hosting: Vercel
28- Testing: Vitest
29- Linting: ESLint
30- Formatting: Prettier
31- Mocking: MSW (Mock Service Worker)
32
@@ −1 +1 @@
1−# AGENTS.md
1+# Tech Stack
22
3−This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
3+Unless otherwise specified, follow the defined stack and common best practices.
44
5−## 必ず日本語で回答してください
5+## Frontend
66
7−## 横断的ルール（自動読み込み）
7+Use the following only when necessary:
88
9−以下の`.Codex/rules/`配下のルールが全て自動的に適用されます：
9+- Language: TypeScript
10+- Framework: Next.js (App Router)
11+- UI: MUI, Tailwind CSS
12+- State Management: React Hooks
13+- Auth: NextAuth.js, Firebase Authentication (via Firebase Admin SDK)
14+- Lint/Format: ESLint, Prettier
15+- Drag & Drop: dnd-kit
16+- Data Fetching: SWR
17+- Validation: Zod
1018
11−- **コード品質**: @.Codex/rules/code-quality.md
12−- **セキュリティ**: @.Codex/rules/security.md
13−- **開発フロー**: @.Codex/rules/development.md
19+## Backend
1420
15−## 階層別の詳細指示（path-specificルール）
21+- Language: Node.js (TypeScript)
22+- API: REST
23+- Database: Firestore (via Firebase Admin SDK)
1624
17−作業ディレクトリに応じて、以下のpath-specificルールが自動的に適用されます：
25+## Development Tools
1826
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−# 開発
33−npm run dev # Turbopackで開発サーバーを起動
34−npm run build # クリーンビルド（.nextディレクトリ削除＋ビルド）
35−npm start # 本番サーバーを起動
36−
37−# コード品質
38−npm run lint # ESLintを自動修正で実行
39−npm run prettier # Prettierでコードをフォーマット
40−npm run format # prettierとlintの両方を実行
41−
42−# テスト
43−npm run test # テスト（watch mode）
44−npm run test:run # テスト一回実行
45−npm run test:coverage # カバレッジ付きテスト実行
46−npm run test:ui # Vitest UIモードでテスト実行
47−npm run test:e2e # Playwright E2Eテスト（MSW使用）
48−npm run test:e2e:ui # Playwright UIモードでE2Eテスト
49−
50−# Docker統合テスト
51−npm run docker:test # Firebase Emulator環境起動
52−npm run docker:test:run # 統合テスト実行（Firebase Emulator + tsx）
53−npm run docker:test:down # Docker環境停止
54−
55−# Firebase Emulator
56−npm run emulator:start # 開発用Firebase Emulator起動
57−npm run emulator:test # テスト用Firebase Emulator起動
58−
59−# モック
60−npm 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` はタスクの複雑さに応じて自動判断する（フラグ省略で自動選択）
27+- Hosting: Vercel
28+- Testing: Vitest
29+- Linting: ESLint
30+- Formatting: Prettier
31+- Mocking: MSW (Mock Service Worker)
10832
