Two files, one repository
ryok/python-boilerplate ships 2 formats across 7 indexed files. The question worth asking is whether the second one says anything the first does not.
CompareCLAUDE.md ↔ Cline rules
| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 7 | 6 | 0% |
| Commands | 1 | 7 | 0 | 13% |
| Section tags | 4 | 2 | 2 | 50% |
What each file covers
Sections
0 shared · 7 only in A · 6 only in B- − Python Boilerplate Project
- − 知見管理システム
- − `.claude/context.md`
- − `.claude/project-knowledge.md`
- − `.claude/project-improvements.md`
- − `.claude/common-patterns.md`
- − Clineルール管理
- + Development Guidelines
- + Code Style
- + Type Hints
- + Testing
- + Documentation
- + Code Quality
Commands
1 shared · 7 only in A · 0 only in B- − python-boilerplate/
- − uv sync
- − uv run ruff check .
- − uv run ruff format .
- − uv run pyright
- − uv run python -m src.cli
- − uv add
- uv run pytest
Section tags
4 shared · 2 only in A · 2 only in B- − setup
- − agent-behaviour
- + types
- + testing-strategy
- test
- lint-format
- code-style
- docs
Line diff
ryok/python-boilerplate · CLAUDE.md
@@ −1 @@
1# Python Boilerplate Project
2
3## 概要
4このプロジェクトは、Pythonアプリケーション開発のためのボイラープレートテンプレートです。モダンなPython開発環境のベストプラクティスに従って構成されています。
5
6## 技術スタック
7- **Python**: 3.11+
8- **パッケージマネージャー**: uv
9- **リンター/フォーマッター**: Ruff
10- **型チェッカー**: Pyright
11- **テストフレームワーク**: pytest
12- **コンテナ**: Docker / Docker Compose
13
14## プロジェクト構造
15```
16python-boilerplate/
17├── src/ # ソースコード
18│ ├── __init__.py
19│ ├── cli.py # CLIインターフェース
20│ └── core/ # コアモジュール
21│ ├── __init__.py
22│ ├── config.py # 設定管理
23│ ├── logger.py # ロギング設定
24│ └── main.py # メインエントリーポイント
25├── tests/ # テストコード
26├── Dockerfile # Dockerコンテナ定義
27├── docker-compose.yml # Docker Compose設定
28├── pyproject.toml # プロジェクト設定
29├── ruff.toml # Ruffリンター設定
30├── pyrightconfig.json # Pyright型チェック設定
31└── uv.lock # 依存関係ロックファイル
32```
33
34## 開発ガイドライン
35- **コードスタイル**: PEP 8準拠（Ruffで自動チェック）
36- **型ヒント**: 全ての関数に型ヒントを記述
37- **テスト**: 新機能追加時は必ずユニットテストを作成
38- **ドキュメント**: docstringによる関数の説明を推奨
39
40## よく使うコマンド
41```bash
42# 依存関係のインストール
43uv sync
44
45# テストの実行
46uv run pytest
47
48# リンターの実行
49uv run ruff check .
50
51# フォーマットの実行
52uv run ruff format .
53
54# 型チェックの実行
55uv run pyright
56
57# アプリケーションの実行
58uv run python -m src.cli
59```
60
61## 重要な設定
62- **Python仮想環境**: `myenv/` ディレクトリに配置
63- **型チェック**: strictモードで実行
64- **リンター**: Ruffによる自動修正が有効
65
66## 注意事項
67- 本番環境へのデプロイ前に必ず全テストを実行すること
68- セキュリティに関わる設定は環境変数で管理すること
69- 新規依存関係追加時は`uv add`を使用すること
70
71## 知見管理システム
72このプロジェクトでは以下のファイルで知見を体系的に管理しています：
73
74### `.claude/context.md`
75- プロジェクトの背景、目的、制約条件
76- 技術スタック選定理由
77- ビジネス要件や技術的制約
78
79### `.claude/project-knowledge.md`
80- 実装パターンや設計決定の知見
81- アーキテクチャの選択理由
82- 避けるべきパターンやアンチパターン
83
84### `.claude/project-improvements.md`
85- 過去の試行錯誤の記録
86- 失敗した実装とその原因
87- 改善プロセスと結果
88
89### `.claude/common-patterns.md`
90- 頻繁に使用するコマンドパターン
91- 定型的な実装テンプレート
92
93**重要**: 新しい実装や重要な決定を行った際は、該当するファイルを更新してください。
94
95## Clineルール管理
96プロジェクト固有のルールは `.clinerules/` ディレクトリで管理されています：
97
98- `project-overview.md` - プロジェクト概要
99- `tech-stack.md` - 技術スタックとツール使用ルール
100- `development-guidelines.md` - 開発ガイドラインとコーディング規約
101- `common-commands.md` - よく使うコマンド集
102- `project-structure.md` - ディレクトリ構造と命名規則
103- `knowledge-management.md` - 知見管理システムの説明
104
ryok/python-boilerplate · .clinerules/development-guidelines.md
@@ +1 @@
1# Development Guidelines
2
3## Code Style
4- Follow PEP 8 standards (automatically checked by Ruff)
5- Use meaningful variable and function names
6- Keep functions small and focused
7- Avoid deep nesting
8
9## Type Hints
10- ALL functions must have type hints
11- Use proper type annotations for parameters and return values
12- Import types from typing module when needed
13- Pyright runs in strict mode - fix all type errors
14
15## Testing
16- Write unit tests for all new features
17- Test files go in the tests/ directory
18- Mirror the source structure in tests
19- Run tests with `uv run pytest`
20- Aim for high test coverage
21
22## Documentation
23- Use docstrings for all functions and classes
24- Follow Google or NumPy docstring style
25- Keep docstrings concise but informative
26- Update documentation when changing functionality
27
28## Code Quality
29- No commented-out code in commits
30- Remove debug print statements
31- Handle exceptions appropriately
32- Use logging instead of print statements
@@ −1 +1 @@
1−# Python Boilerplate Project
1+# Development Guidelines
22
3−## 概要
4−このプロジェクトは、Pythonアプリケーション開発のためのボイラープレートテンプレートです。モダンなPython開発環境のベストプラクティスに従って構成されています。
3+## Code Style
4+- Follow PEP 8 standards (automatically checked by Ruff)
5+- Use meaningful variable and function names
6+- Keep functions small and focused
7+- Avoid deep nesting
58
6−## 技術スタック
7−- **Python**: 3.11+
8−- **パッケージマネージャー**: uv
9−- **リンター/フォーマッター**: Ruff
10−- **型チェッカー**: Pyright
11−- **テストフレームワーク**: pytest
12−- **コンテナ**: Docker / Docker Compose
9+## Type Hints
10+- ALL functions must have type hints
11+- Use proper type annotations for parameters and return values
12+- Import types from typing module when needed
13+- Pyright runs in strict mode - fix all type errors
1314
14−## プロジェクト構造
15−```
16−python-boilerplate/
17−├── src/ # ソースコード
18−│ ├── __init__.py
19−│ ├── cli.py # CLIインターフェース
20−│ └── core/ # コアモジュール
21−│ ├── __init__.py
22−│ ├── config.py # 設定管理
23−│ ├── logger.py # ロギング設定
24−│ └── main.py # メインエントリーポイント
25−├── tests/ # テストコード
26−├── Dockerfile # Dockerコンテナ定義
27−├── docker-compose.yml # Docker Compose設定
28−├── pyproject.toml # プロジェクト設定
29−├── ruff.toml # Ruffリンター設定
30−├── pyrightconfig.json # Pyright型チェック設定
31−└── uv.lock # 依存関係ロックファイル
32−```
15+## Testing
16+- Write unit tests for all new features
17+- Test files go in the tests/ directory
18+- Mirror the source structure in tests
19+- Run tests with `uv run pytest`
20+- Aim for high test coverage
3321
34−## 開発ガイドライン
35−- **コードスタイル**: PEP 8準拠（Ruffで自動チェック）
36−- **型ヒント**: 全ての関数に型ヒントを記述
37−- **テスト**: 新機能追加時は必ずユニットテストを作成
38−- **ドキュメント**: docstringによる関数の説明を推奨
22+## Documentation
23+- Use docstrings for all functions and classes
24+- Follow Google or NumPy docstring style
25+- Keep docstrings concise but informative
26+- Update documentation when changing functionality
3927
40−## よく使うコマンド
41−```bash
42−# 依存関係のインストール
43−uv sync
44−
45−# テストの実行
46−uv run pytest
47−
48−# リンターの実行
49−uv run ruff check .
50−
51−# フォーマットの実行
52−uv run ruff format .
53−
54−# 型チェックの実行
55−uv run pyright
56−
57−# アプリケーションの実行
58−uv run python -m src.cli
59−```
60−
61−## 重要な設定
62−- **Python仮想環境**: `myenv/` ディレクトリに配置
63−- **型チェック**: strictモードで実行
64−- **リンター**: Ruffによる自動修正が有効
65−
66−## 注意事項
67−- 本番環境へのデプロイ前に必ず全テストを実行すること
68−- セキュリティに関わる設定は環境変数で管理すること
69−- 新規依存関係追加時は`uv add`を使用すること
70−
71−## 知見管理システム
72−このプロジェクトでは以下のファイルで知見を体系的に管理しています：
73−
74−### `.claude/context.md`
75−- プロジェクトの背景、目的、制約条件
76−- 技術スタック選定理由
77−- ビジネス要件や技術的制約
78−
79−### `.claude/project-knowledge.md`
80−- 実装パターンや設計決定の知見
81−- アーキテクチャの選択理由
82−- 避けるべきパターンやアンチパターン
83−
84−### `.claude/project-improvements.md`
85−- 過去の試行錯誤の記録
86−- 失敗した実装とその原因
87−- 改善プロセスと結果
88−
89−### `.claude/common-patterns.md`
90−- 頻繁に使用するコマンドパターン
91−- 定型的な実装テンプレート
92−
93−**重要**: 新しい実装や重要な決定を行った際は、該当するファイルを更新してください。
94−
95−## Clineルール管理
96−プロジェクト固有のルールは `.clinerules/` ディレクトリで管理されています：
97−
98−- `project-overview.md` - プロジェクト概要
99−- `tech-stack.md` - 技術スタックとツール使用ルール
100−- `development-guidelines.md` - 開発ガイドラインとコーディング規約
101−- `common-commands.md` - よく使うコマンド集
102−- `project-structure.md` - ディレクトリ構造と命名規則
103−- `knowledge-management.md` - 知見管理システムの説明
104−
28+## Code Quality
29+- No commented-out code in commits
30+- Remove debug print statements
31+- Handle exceptions appropriately
32+- Use logging instead of print statements
