tracking-progress

name	tracking-progress
description	プロジェクトの開発進捗を包括的に分析しレポート生成。イテレーション達成度、技術実装状況、品質メトリクスを確認。進捗確認やステークホルダー報告時に使用。

進捗追跡ガイド

プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告します。

Instructions

1. オプション

• なし : 全体的な進捗確認（デフォルト）
• --brief : 簡潔な進捗サマリー表示
• --detailed : 詳細な進捗レポート生成
• --iteration <番号> : 特定イテレーションの進捗確認
• --technical : 技術的な実装状況に焦点
• --docs : ドキュメント更新状況の確認
• --update : docs/development/ 内のドキュメントを現在の進捗に合わせて更新

2. 基本例

# 基本的な進捗確認
# 「プロジェクト全体の開発進捗を包括的にレポート」

# 簡潔なサマリー
# --brief
# 「要点のみを絞った進捗状況を表示」

# 詳細レポート
# --detailed
# 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」

# 特定イテレーションの確認
# --iteration 1
# 「イテレーション 1 の完了状況と成果を詳細分析」

# 進捗をドキュメントに反映
# --update
# 「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」

3. 包括的な進捗分析

プロジェクトの多角的な視点から現在の進捗状況を分析:

• イテレーション達成度: 計画 vs 実績の比較分析
• 技術実装状況: 機能完成度・品質指標・テスト結果
• アーキテクチャ進展: 設計の実装状況と技術的負債
• ドキュメント整備: 計画書・仕様書・実行手順書の最新性

4. 動的な状況判定

# Git 履歴の分析
git log --oneline -10
git status --porcelain

# テスト実行状況の確認
dotnet test --logger trx
npm test -- --coverage

# 実行環境の状況確認
ps aux | grep -E "dotnet|node|npm"
netstat -tlnp | grep -E ":3000|:5150"

5. 品質メトリクス取得

実装品質の定量的評価:

• テストカバレッジ: 単体・統合・E2E テストの網羅率
• コード品質: 静的解析結果・複雑度測定
• 性能指標: レスポンス時間・スループット測定
• セキュリティ: 脆弱性スキャン結果

6. --update オプションの詳細

--update オプションは docs/development/ 内のドキュメントを現在の進捗に合わせて自動更新します。

更新対象ファイル:

• docs/development/release_plan.md - リリース計画
• docs/development/iteration_plan-*.md - イテレーション計画

release_plan.md の更新内容:

1. 進捗状況テーブル: 各イテレーションの実績 SP、達成率、状態を更新
2. リリース条件チェックボックス: 完了した条件にチェックを入れる
3. バーンダウンチャート: 実績値を反映

iteration_plan-*.md の更新内容:

1. 成功基準チェックボックス: 達成した基準にチェックを入れる
2. タスク分解の状態: 完了したタスクのチェックボックスを更新
3. 完了条件（DoD）: 達成した条件にチェックを入れる
4. 振り返りセクション: メトリクス実績値を記入

更新判定の情報源:

# Git コミット履歴から実装状況を分析
git log --oneline --since="2 weeks ago"

# テスト実行結果から品質指標を取得
dotnet test --logger trx
npm test -- --coverage

# ディレクトリ構造から機能実装状況を確認
ls -la apps/backend/src/
ls -la apps/frontend/src/

7. 出力例

プロジェクト進捗レポート
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Overall Status: フルスタック実装完成 (MVP 準備段階)

Iteration Progress:
├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
├─ Iteration 2 (予約機能): 計画済み (8 営業日予定)
├─ Iteration 3 (キャンセル): 待機中
└─ Iteration 4 (運用準備): 待機中

Technical Implementation:
├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
├─ Frontend (React TS): 完全実装
├─ Database (SQLite): 稼働中
├─ Authentication: JWT 完全実装
└─ API Integration: フルスタック連携確認

Documentation:
├─ 計画書: 最新
├─ リリース計画: 更新済み
├─ README: 実行手順書完備
└─ API 仕様: Swagger UI 統合

8. 注意事項

• 前提条件: Git リポジトリ内で実行、プロジェクト構造を理解
• 情報取得: 実行時点での動的な状況を総合的に分析
• 推奨事項: 重要な節目や問題発生時の定期的な進捗確認
• --update 使用時: 更新前に Git でコミットしておくことを推奨（変更のロールバック用）

9. ベストプラクティス

1. 定期実行: イテレーション開始・終了時の進捗確認
2. 問題発見: 遅延や品質低下の早期発見に活用
3. ステークホルダー報告: 詳細レポートを会議資料として活用
4. 改善指標: 進捗データを基にした開発プロセス改善
5. ドキュメント同期: イテレーション完了時に --update で docs/development を同期
6. 振り返り記録: --update 実行後、KPT セクションを手動で記入して振り返りを完了

関連スキル

• managing-docs : ドキュメント一覧と進捗状況の確認
• git-commit : 進捗に合わせた適切なコミット実行
• planning-releases : イテレーション計画の作成・更新