GitBucket
ドキュメント管理・ファイル命名規則 (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_ドキュメント作成ガイド に記載された書式に従うこと．