h-1.flutter.4/docs/engineering_management.md

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

1. ドキュメントの目的

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

活用シーン

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

---

2. ドキュメント構成

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

# コミットメッセージとドキュメント更新を同期
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 進捗ダッシュボード（簡易）

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

- **実装タスク**: [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 リンク情報

• プロジェクトチャート（外部リンク）
• Google Play Console（リリース管理）
• Firebase Console（分析・エラーログ）

9.2 用語集

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

---

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