# 工程管理ガイドライン - CMO-01 プロジェクト

## 1. ドキュメントの目的

このドキュメントは **プロジェクト全体を可視化・管理するためのフレームワーク**を提供します。

### 活用シーン
- 📋 **スプリントプランニング**: 2 週間ごとのタスク割り当て
- 🔄 **進捗追跡**: リストから完了項目を消去して可視化
- 📊 **ステークホルダー報告**: マイルストーン達成状況を説明資料へ
- ⚠️ **リスク管理**: 発生事項と対策の記録・共有

---

## 2. ドキュメント構成

| ドキュメント | 内容 | 更新頻度 | 責任者 |
| --- | --- | --- | --- |
| [工程管理ガイド](./engineering_management.md) | 全体方針・管理プロセス | 各フェーズ開始時 | PM |
| [短期計画（Sprint）](./short_term_plan.md) | 2〜4 週間単位のタスク | 各スプリント終了時 | 開発リーダー |
| [長期計画（Roadmap）](./long_term_plan.md) | 3〜12 ヶ月目標・マイルストーン | マイルストーン完了時 | PM |
| [要件定義書](./requirements.md) | 機能要件・アーキテクチャ | 要件変更時 | アーキテクト |
| [プロジェクト計画書](./project_plan.md) | 統合計画書（承認用） | 各ステークホルダーレビュー時 | PM |

---

## 3. 管理プロセス

### 3.1 スプリントサイクル（2 週間）

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  スプリント   │───▶│ プランニング  │───▶│  実装        │
│   開始       │     │ (タスク割り)  │     │ (開発・レビュー)|
└─────────────┘     └─────────────┘     └─────────────┘
      ▲                   │                      │
      │                   ▼                      ▼
      └─────────────── 進捗更新 ◀─────────────────┘
```

**アクションアイテム**:
1. **スプリント開始（火曜）**: `short_term_plan.md` をスライド作成
2. **実施週**: テーザタスク完了→`short_term_plan.md` でチェックオフ
3. **レビュー日（木）**: 達成状況を `project_plan.md` に反映

### 3.2 承認フロー

1. **要件定義書** (`requirements.md`) → CTO 承認
2. **スプリント計画** (`short_term_plan.md`) → チームレビュー後実装開始
3. **マイルストーン完了** → ステークホルダーへ `project_plan.md` 提出

---

## 4. ドキュメント管理ポリシー

### 4.1 更新ルール

| トリガー | 対象ドキュメント | アクション |
| --- | --- | --- |
| 新機能実装完了 | `short_term_plan.md`, `project_plan.md` | マーク「完了」→ README 更新 |
| 要件変更承認 | `requirements.md` → `project_plan.md` | 影響範囲を記載し再承認 |
| リスク発生 | `engineering_management.md` (リスク管理節) | 発生日に追加・対策立案 |

### 4.2 バージョン管理

```bash
# コミットメッセージとドキュメント更新を同期
git commit -m "feat: Estimate CRUD API 実装"
# → README.md の実装完了セクションを更新
git add README.md
git commit -m "docs: README 更新（見積機能実装完了）"
```

**semver カスタム**:
- `MAJOR`: DB スキーマ破壊変更、API バージョンマイナー
- `MINOR`: 新機能追加、ドキュメント改善
- `PATCH`: バグ修正、テストカバレッジ向上

---

## 5. 活用方法（詳細）

### 5.1 新規参入者向けロードマップ

```
ステップ 1: README.md を読み込み
  └─> プロジェクト全体像とドキュメント一覧把握
  
ステップ 2: requirements.md で要件確認
  └─> 「何を」作るか理解する
  
ステップ 3: short_term_plan.md でタスク取得
  └─> 次の 2 週間の優先順位を知る
  
ステップ 4: 実装・レビュー → project_plan.md に反映
  └─> 進捗を可視化して報告

ステップ 5: long_term_plan.md で目標確認
  └─> 「なぜ」やるかの文脈理解
```

### 5.2 リソース管理の活用

**チームメンバー**:
1. `short_term_plan.md` の未着手タスク一覧からアサイン
2. 実装完了→GitHub Issues に Issue 作成してクローズ
3. ステータス更新 → プログレッシュバーで自己管理能力向上

**ステークホルダー**:
1. `project_plan.md` でマイルストーン確認
2. リスクセクションでの現状把握
3. ベータリリース目標（2026/06/30）への道筋追跡

---

## 6. メトリクスと測定

### 6.1 KPI データ

| 指標 | 目標値 | 測定頻度 | 記録位置 |
| --- | --- | --- | --- |
| テストカバレッジ | >70% | 各スプリント | `project_plan.md` |
| バグ発生数 | <5/Critical=0 | リリース前 | `project_plan.md` |
| スプリント完了率 | >85% | 月末 | `short_term_plan.md` |

### 6.2 進捗ダッシュボード（簡易）

```markdown
## 📊 進捗サマリー（スプリント終了時）

- **実装タスク**: [x] 見積入力 [ ] 売上入力 [ ] 請求作成
- **テストカバレッジ**: 65% → 75% (+10%)
- **課題数**: 3 (Critical=0)

## 📅 次のマイルストーン

- **M1: ベータリリース** - 2026/06/30
- **条件**: Bug < 10, テストカバレッジ > 70%
```

---

## 7. 緊急時の対応

### 7.1 リスク発生時

1. `engineering_management.md` にリスク記録
2. チーム会議（15min）で対応策決定
3. ステークホルダーに進捗報告（簡易スライド）

**例**: Google API キャンペーン制限超過
- **影響**: 認証機能使用制限
- **対策**: ローカル認証モードの維持
- **ステータス**: 🔴 中 → 🟢 回復済み

---

## 8. ドキュメントの共有

### 公開範囲と権限

| ドキュメント | 公開先 | 編集権限 |
| --- | --- | --- |
| `engineering_management.md` | チーム内部 | PM/リーダー |
| `short_term_plan.md` | 全体チーム | 全員（コメント可） |
| `project_plan.md` | ステークホルダー | 承認待ちまで Read-Only |

### 配布形式

- **日次更新**: Markdown ファイル（Git にコミット）
- **週報**: GitHub Releases または Slack へ出力
- **月次**: PDF でステークホルダーへ送信

---

## 9. 補足

### 9.1 リンク情報

- [プロジェクトチャート](https://project-management.internal/h1-cmo-01)（外部リンク）
- [Google Play Console](https://play.google.com/console)（リリース管理）
- [Firebase Console](https://console.firebase.google.com)（分析・エラーログ）

### 9.2 用語集

| 用語 | 説明 |
| --- | --- |
| スプリント | 2 週間単位の開発サイクル |
| マイルストーン | 重要な達成目標（リリースなど） |
| リスク軽減策 | 発生確率を低減する事前準備 |

---

**最終更新**: 2026/03/07  
**バージョン**: 1.0 (Initial Release)  
**責任者**: PM（開発リーダー）