# ドキュメント管理・ファイル命名規則 (File Naming Conventions)

## 命名の基本方針 (Basic Policy)

プロジェクトの規模拡大に伴うファイルの散乱を防ぎ，開発メンバーおよび AI がファイルの内容・文脈を即座に特定できるようにするため，以下の規則を適用する．

### 基本フォーマット

`[カテゴリ]_[連番]_[ファイル名].md`

- 区切り文字: アンダースコア `_` を使用する．
- 連番: 01 から始まる 2 桁の数字とする．
- 拡張子: マークダウン `.md` とする．

## カテゴリ定義 (Category Definitions)

ファイル名の先頭に付与するプレフィックス（接頭辞）定義．

| カテゴリ | ディレクトリ | 内容 | 対象例 |
| --- | --- | --- | --- |
| `GUIDE_` | `01_GUIDE/` | ルール，規約，運用フロー | スタイルガイド，命名規則，Git 運用ルール |
| `ENV_` | `02_ENV/` | 開発環境，プロジェクトの土台 | 環境構築手順，技術スタック一覧，パッケージ構成図 |
| `PLAN_` | `03_PLAN/` | 進行計画，スケジュール，要件定義 | WBS，ロードマップ，要件定義書，タスク一覧 |
| `SPEC_` | `04_SPEC/` | ユーザーから見える仕様 | 企画書，画面遷移図，パラメータ設定 |
| `TECH_` | `05_TECH/` | エンジニア向けの技術設計 | 通信プロトコル仕様，データベース設計，クラス設計 |
| `TEST_` | `06_TEST/` | テスト計画，品質保証 | 単体テスト仕様書，シナリオテスト計画，品質基準 |

## 運用ルール (Operational Rules)

- 1 ファイル 1 テーマ: ファイルサイズが肥大化しすぎないよう，トピックごとにファイルを分割することを推奨する．これにより，AI へのコンテキスト入力精度が向上する．
- スタイルの継承: 新規作成するファイルも，必ず [GUIDE_02_ドキュメント作成ガイド](GUIDE_02_ドキュメント作成ガイド.md) に記載された書式に従うこと．
