---
name: tracking-progress
description: プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
---

# 進捗追跡

プロジェクトの開発進捗を多角的に分析し、現在の状況を定量的に報告する。Git 履歴・テスト結果・ドキュメントを総合的に分析して進捗を可視化する。

## オプション

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

## 分析の観点

- **イテレーション達成度**: 計画 vs 実績の比較分析（SP、ストーリー数、期間）
- **技術実装状況**: 機能完成度・テスト結果・ビルド状態
- **品質メトリクス**: テストカバレッジ、静的解析結果、コード複雑度
- **ドキュメント整備**: 計画書・仕様書・手順書の最新性

## --update オプションの詳細

`docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新する。

**更新対象**:

- `docs/development/release_plan.md` — 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
- `docs/development/iteration_plan-*.md` — 成功基準チェック、タスク状態、完了条件（DoD）、メトリクス実績値

**更新判定の情報源**:

```bash
git log --oneline --since="2 weeks ago"   # 実装状況の分析
dotnet test --logger trx                  # テスト結果の取得
npm test -- --coverage                    # カバレッジの取得
```

## 出力例

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

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

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

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

## 途中から再開

進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。

**Example:**

```
ユーザー: 「イテレーション 2 の中間進捗を確認したい」
回答: --iteration 2 で現在の達成状況を分析する。
      計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
      遅延リスクがあれば早期に報告する。
```

## 注意事項

- Git リポジトリ内で実行し、プロジェクト構造を理解していること（前提条件）
- 実行時点での動的な状況を総合的に分析する
- `--update` 使用時は更新前に Git でコミットしておくことを推奨する（ロールバック用）
- イテレーション開始・終了時の定期実行を推奨する
- `--update` 実行後、KPT セクションは手動で記入して振り返りを完了する

## 関連スキル

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