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	3	6	0%
Commands	0	0	19	0%
Section tags	1	0	4	20%

What each file covers

Sections

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

− Coding Guidelines
− General Principles
− Testing
+ 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

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

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

Line diff

+104 added−11 removed5 unchanged4.6% identical

sakatai11/todoApp-next · .clinerules/coding-guidelines.md

@@ −1 @@

1# Coding Guidelines

3## General Principles

5- Keep code simple and readable

6- Use meaningful naming (variables, functions, classes)

7- One responsibility per function

8- Proper error handling

9- Comment only when necessary

11## Testing

13- Include unit tests for all major features

14- Consider edge cases

15- Ensure tests are executable

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−# Coding Guidelines

1+# CLAUDE.md

3−## General Principles

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

5−- Keep code simple and readable

6−- Use meaningful naming (variables, functions, classes)

7−- One responsibility per function

8−- Proper error handling

9−- Comment only when necessary

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

106

11−## Testing

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

128

13−- Include unit tests for all major features

14−- Consider edge cases

15−- Ensure tests are executable

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

10+

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

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

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

14+

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

16+

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

18+

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` はタスクの複雑さに応じて自動判断する（フラグ省略で自動選択）

16109