ff0fa2f745
- docs/engineering_management.md (工程管理フレームワーク) - docs/short_term_plan.md (2 週間単位のタスクリスト) - docs/long_term_plan.md (3〜12 ヶ月ロードマップ) - README.md (ドキュメント活用方法の明記)
196 lines
No EOL
7.1 KiB
Markdown
196 lines
No EOL
7.1 KiB
Markdown
# 工程管理ガイドライン - 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（開発リーダー） |