CLAUDE.md

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