# CLAUDE.md

このプロジェクトでは `docs/01_GUIDE/` 以下に定義されたルールを必ず遵守すること。
各ファイルの詳細はリンク先を参照する。

---

## ドキュメント作成

[GUIDE_01_ドキュメント作成ガイド.txt](docs/01_GUIDE/GUIDE_01_ドキュメント作成ガイド.txt)

テキストドキュメントの書式全般を定義する。句読点は「，」「．」を使用し「、」「。」は使わない。
見出し階層（大見出し・中見出し・■・・・・-）や空行ルールに従うこと。

---

## ファイル命名

[GUIDE_02_ドキュメント命名規則.txt](docs/01_GUIDE/GUIDE_02_ドキュメント命名規則.txt)

ドキュメントファイルは `[カテゴリ]_[連番]_[名称].txt` の形式で命名する。
カテゴリ（GUIDE / PLAN / ENV / SPEC / TECH / TEST / ADR）の定義もここに記載されている。

---

## Git 運用

[GUIDE_03_Git運用ルール.txt](docs/01_GUIDE/GUIDE_03_Git運用ルール.txt)

ブランチ命名（`feature/`・`fix/`・`refactor/` 等），コミットメッセージのタグ（`[add]`・`[update]`・`[fix]`・`[remove]`・`[clean]`），PR フロー（必ず PR 経由でマージ，直プッシュ禁止）を定義する。

---

## コーディング規則

[GUIDE_04_コーディング規則.txt](docs/01_GUIDE/GUIDE_04_コーディング規則.txt)

Python コードの書き方を定義する。PEP 8 準拠，snake_case / PascalCase / UPPER_SNAKE_CASE の使い分け，
型ヒント必須，`from ... import *` 禁止，マジックナンバー禁止など。

---

## コードコメント規則

[GUIDE_05_コードコメント規則.txt](docs/01_GUIDE/GUIDE_05_コードコメント規則.txt)

コメント・docstring の書き方を定義する。モジュール・クラス・公開関数には docstring 必須。
コメントは日本語，句読点は「，」を使用，文末の「．」は付けない。Google スタイルの docstring を使用する。