Comparison

A · Cline rules · sakatai11/todoApp-next B · CLAUDE.md · sakatai11/todoApp-next

What each file covers, counted
Dimension	Shared	Only in A	Only in B	Overlap
Sections	0	4	6	0%
Commands	0	0	19	0%
Section tags	3	0	2	60%

What each file covers

Sections

0 shared · 4 only in A · 6 only in B

− Tech Stack
− Frontend
− Backend
− Development Tools
+ CLAUDE.md
+ テストガイドライン
+ 階層別の詳細指示（path-specificルール）
+ Docker統合テスト
+ Firebase Emulator
+ Codex 実行ポリシー

Commands

0 shared · 0 only in A · 19 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 docker:e2e:run
+ npm run emulator:start
+ npm run emulator:test
+ npm run msw:init

Section tags

3 shared · 0 only in A · 2 only in B

+ build
+ agent-behaviour
test
lint-format
testing-strategy

Line diff

+100 added−23 removed9 unchanged8.3% identical

sakatai11/todoApp-next · .clinerules/tech-stack.md

@@ −1 @@

1# Tech Stack

3Unless otherwise specified, follow the defined stack and common best practices.

5## Frontend

7Use the following only when necessary:

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

19## Backend

21- Language: Node.js (TypeScript)

22- API: REST

23- Database: Firestore (via Firebase Admin SDK)

25## Development Tools

27- Hosting: Vercel

28- Testing: Vitest

29- Linting: ESLint

30- Formatting: Prettier

31- Mocking: MSW (Mock Service Worker)

sakatai11/todoApp-next · .claude/CLAUDE.md

@@ +1 @@

1# CLAUDE.md

3This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

5## 必ず日本語で回答してください

7## 横断的ルール（自動読み込み）

9以下の`.claude/rules/`配下のルールが全て自動的に適用されます：

11- **コード品質**: @.claude/rules/code-quality.md

12- **セキュリティ**: @.claude/rules/security.md

13- **開発フロー**: @.claude/rules/development.md

15## 階層別の詳細指示（path-specificルール）

17作業ディレクトリに応じて、以下のpath-specificルールが自動的に適用されます：

19| ルールファイル | 適用パス | 主な内容 |

20| -------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |

21| @.claude/rules/app.md | `app/**/*.{ts,tsx}` | App Router開発、API開発、認証ミドルウェア、エラーハンドリング |

22| @.claude/rules/features.md | `features/**/*.{ts,tsx}` | Shared機能、Todo機能、状態管理、カスタムフック |

23| @.claude/rules/testing.md | `tests/**/*.{ts,tsx}`, `**/*.{test,spec}.{ts,tsx}` | テスト戦略、環境設定、データ一貫性 |

25## プロジェクト概要

27これは、App Routerとフィーチャーベースアーキテクチャを使用したNext.js 16のtodoアプリケーションです。

29### 開発コマンド

31```bash

32# 開発

33npm run dev # Turbopackで開発サーバーを起動

34npm run build # クリーンビルド（.nextディレクトリ削除＋ビルド）

35npm start # 本番サーバーを起動

37# コード品質

38npm run lint # ESLintを自動修正で実行

39npm run prettier # Prettierでコードをフォーマット

40npm run format # prettierとlintの両方を実行

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テスト

48npm run test:e2e:ui # Playwright UIモードでE2Eテスト

50# Docker統合テスト

51npm run docker:test # Firebase Emulator環境起動

52npm run docker:test:run # 統合テスト実行（Firebase Emulator + tsx）

53npm run docker:test:down # Docker環境停止

54npm run docker:e2e:run # E2Eテスト実行

56# Firebase Emulator

57npm run emulator:start # 開発用Firebase Emulator起動

58npm run emulator:test # テスト用Firebase Emulator起動

60# モック

61npm run msw:init # Mock Service Workerを初期化

62```

64### 現在の技術スタック

66- **フレームワーク**: Next.js 16（App Router + Turbopack）

67- **認証**: NextAuth.js v5（beta）- カスタム認証プロバイダー

68- **バックエンド**: Firebase Admin SDK（Firestore + Auth）

69- **UI**: Material-UI（MUI）+ Tailwind CSS

70- **状態管理**: React Context + データ取得用SWR

71- **ドラッグ＆ドロップ**: @dnd-kit/core（タスクの並び替え用）

72- **バリデーション**: Zodスキーマ

73- **テスト**: Vitest + React Testing Library + MSW

74- **モック**: MSW（Mock Service Worker）

76### アーキテクチャ概要

78- **ディレクトリ構造**: フィーチャーベース設計（`features/`内で機能自己完結）

79- **ルーティング**: Next.js App Router + ルートグループ`()`による整理

80- **API構造**: 管理者用`(admin)/`、一般用`(general)/`、認証用`auth/`に分離

81- **詳細構造**: [@todoApp-submodule/docs/PRODUCTS.md](../todoApp-submodule/docs/PRODUCTS.md#プロジェクト構造)参照

83### 重要なプロジェクト注意事項

85- **本番環境ではTypeScriptビルドエラーを無視（`ignoreBuildErrors: true`）**

86 - **理由**: 開発時にエディタのリアルタイム型チェックと`tsconfig.json`の厳密な設定で型安全性を確保済み。本番ビルド時の型チェックをスキップすることでビルド速度を向上させるため。

87- **開発時のAPIモック用MSWを使用**

88 - **理由**: ユニットテスト時にFirebase Emulatorを起動せずに高速なテスト実行を実現するため。

89- **キャッシュ制御ヘッダー付きのVercelデプロイ設定**

90 - **理由**: 静的アセットの効率的なキャッシュ配信と、動的コンテンツの適切な更新を両立するため。

92## 開発パターン

94- 新しい機能は`features/`内で自己完結させる（共通は`features/shared/`）

95- **Admin API**: `app/api/(admin)/`、**General API**: `app/api/(general)/`、**Auth API**: `app/api/auth/`

96- 新規APIでZodバリデーション推奨（既存APIは`trimAllSpaces` + 手動チェックの場合あり）

97- 詳細: [@.claude/rules/app.md](rules/app.md) / [@.claude/rules/features.md](rules/features.md)

99## テストガイドライン

100

101- **UTカバレッジ**: 100%達成済み（493テスト）

102- **統合テスト**: Docker + Firebase Emulator（ポート3002/4000/8080/9099）

103- **詳細ガイド**: [@.claude/rules/testing.md](rules/testing.md)参照

104

105## Codex 実行ポリシー

106

107- `/codex:review` は常にバックグラウンドで実行する（`--background` フラグを自動付与）

108- `/codex:rescue` はタスクの複雑さに応じて自動判断する（フラグ省略で自動選択）

109

@@ −1 +1 @@

1−# Tech Stack

1+# CLAUDE.md

3−Unless otherwise specified, follow the defined stack and common best practices.

3+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

5−## Frontend

5+## 必ず日本語で回答してください

7−Use the following only when necessary:

7+## 横断的ルール（自動読み込み）

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

9+以下の`.claude/rules/`配下のルールが全て自動的に適用されます：

1810

19−## Backend

11+- **コード品質**: @.claude/rules/code-quality.md

12+- **セキュリティ**: @.claude/rules/security.md

13+- **開発フロー**: @.claude/rules/development.md

2014

21−- Language: Node.js (TypeScript)

22−- API: REST

23−- Database: Firestore (via Firebase Admin SDK)

15+## 階層別の詳細指示（path-specificルール）

2416

25−## Development Tools

17+作業ディレクトリに応じて、以下のpath-specificルールが自動的に適用されます：

2618

27−- Hosting: Vercel

28−- Testing: Vitest

29−- Linting: ESLint

30−- Formatting: Prettier

31−- Mocking: MSW (Mock Service Worker)

19+| ルールファイル | 適用パス | 主な内容 |

20+| -------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |

21+| @.claude/rules/app.md | `app/**/*.{ts,tsx}` | App Router開発、API開発、認証ミドルウェア、エラーハンドリング |

22+| @.claude/rules/features.md | `features/**/*.{ts,tsx}` | Shared機能、Todo機能、状態管理、カスタムフック |

23+| @.claude/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テスト

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+npm run docker:e2e:run # E2Eテスト実行

55+

56+# Firebase Emulator

57+npm run emulator:start # 開発用Firebase Emulator起動

58+npm run emulator:test # テスト用Firebase Emulator起動

59+

60+# モック

61+npm run msw:init # Mock Service Workerを初期化

62+```

63+

64+### 現在の技術スタック

65+

66+- **フレームワーク**: Next.js 16（App Router + Turbopack）

67+- **認証**: NextAuth.js v5（beta）- カスタム認証プロバイダー

68+- **バックエンド**: Firebase Admin SDK（Firestore + Auth）

69+- **UI**: Material-UI（MUI）+ Tailwind CSS

70+- **状態管理**: React Context + データ取得用SWR

71+- **ドラッグ＆ドロップ**: @dnd-kit/core（タスクの並び替え用）

72+- **バリデーション**: Zodスキーマ

73+- **テスト**: Vitest + React Testing Library + MSW

74+- **モック**: MSW（Mock Service Worker）

75+

76+### アーキテクチャ概要

77+

78+- **ディレクトリ構造**: フィーチャーベース設計（`features/`内で機能自己完結）

79+- **ルーティング**: Next.js App Router + ルートグループ`()`による整理

80+- **API構造**: 管理者用`(admin)/`、一般用`(general)/`、認証用`auth/`に分離

81+- **詳細構造**: [@todoApp-submodule/docs/PRODUCTS.md](../todoApp-submodule/docs/PRODUCTS.md#プロジェクト構造)参照

82+

83+### 重要なプロジェクト注意事項

84+

85+- **本番環境ではTypeScriptビルドエラーを無視（`ignoreBuildErrors: true`）**

86+ - **理由**: 開発時にエディタのリアルタイム型チェックと`tsconfig.json`の厳密な設定で型安全性を確保済み。本番ビルド時の型チェックをスキップすることでビルド速度を向上させるため。

87+- **開発時のAPIモック用MSWを使用**

88+ - **理由**: ユニットテスト時にFirebase Emulatorを起動せずに高速なテスト実行を実現するため。

89+- **キャッシュ制御ヘッダー付きのVercelデプロイ設定**

90+ - **理由**: 静的アセットの効率的なキャッシュ配信と、動的コンテンツの適切な更新を両立するため。

91+

92+## 開発パターン

93+

94+- 新しい機能は`features/`内で自己完結させる（共通は`features/shared/`）

95+- **Admin API**: `app/api/(admin)/`、**General API**: `app/api/(general)/`、**Auth API**: `app/api/auth/`

96+- 新規APIでZodバリデーション推奨（既存APIは`trimAllSpaces` + 手動チェックの場合あり）

97+- 詳細: [@.claude/rules/app.md](rules/app.md) / [@.claude/rules/features.md](rules/features.md)

98+

99+## テストガイドライン

100+

101+- **UTカバレッジ**: 100%達成済み（493テスト）

102+- **統合テスト**: Docker + Firebase Emulator（ポート3002/4000/8080/9099）

103+- **詳細ガイド**: [@.claude/rules/testing.md](rules/testing.md)参照

104+

105+## Codex 実行ポリシー

106+

107+- `/codex:review` は常にバックグラウンドで実行する（`--background` フラグを自動付与）

108+- `/codex:rescue` はタスクの複雑さに応じて自動判断する（フラグ省略で自動選択）

32109