@k2works/claude-code-booster 1.9.0 → 1.10.0

package/lib/assets/.claude/skills/syncing-github-project/SKILL.md

@@ -14,7 +14,7 @@ description: リリース計画を GitHub Project・Issue・Milestone に反映
 - なし : 全体の同期を実行（Project 作成、Issue 作成、フィールド設定、Milestone 作成）
 - `--project` : GitHub Project のみを作成
 - `--issues` : Issue のみを作成（Project が存在する前提）
-- `--fields` : 各 Issue に対して Project フィールド値を個別に設定（リリース、イテレーション、優先度、SP、カテゴリ、Status）
+- `--fields` : 各 Issue に対して Project フィールド値を個別に設定
 - `--milestones` : Milestone のみを作成し Issue に割り当て
 - `--sync` : release_plan.md と GitHub の差異を確認し、差異があれば同期を実行
 - `--status` : 現在の GitHub Project 状態を表示
@@ -38,13 +38,32 @@ description: リリース計画を GitHub Project・Issue・Milestone に反映
 
 release_plan.md に基づいて GitHub Project を作成し、カスタムフィールドを設定します。
 
-**作成されるフィールド**:
+**標準フィールド構成**:
 
-- **リリース**: 1.0 MVP / 2.0 機能拡張版 / 3.0 完成版
-- **イテレーション**: 1〜12
-- **優先度**: 必須 / 重要
-- **SP**: ストーリーポイント（数値）
-- **カテゴリ**: 認証・ユーザー管理 / マスタ管理 / 仕訳管理 / 元帳・残高管理 / 財務諸表 / システム管理
+| フィールド | タイプ | 説明 |
+|-----------|--------|------|
+| **Status** | Single Select | Todo / In Progress / Done（デフォルト） |
+| **リリース** | Single Select | release_plan.md のリリースフェーズに対応 |
+| **優先度** | Single Select | ストーリーの優先度 |
+| **SP** | Number | ストーリーポイント（数値） |
+| **イテレーション** | **Iteration** | スプリント期間（開始日・期間付き） |
+
+プロジェクト固有のフィールド（カテゴリ、担当領域など）は release_plan.md の内容に応じて追加します。
+
+**Single Select フィールドの作成**:
+
+```bash
+gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
+  --name "<フィールド名>" --data-type "SINGLE_SELECT" \
+  --single-select-options "<選択肢1>,<選択肢2>,<選択肢3>"
+```
+
+**Number フィールドの作成**:
+
+```bash
+gh project field-create <PROJECT_NUMBER> --owner <OWNER> \
+  --name "SP" --data-type "NUMBER"
+```
 
 ### 4. Issue の作成
 
@@ -53,54 +72,54 @@ release_plan.md に基づいて GitHub Project を作成し、カスタムフィ
 **Issue の構成**:
 
 - **タイトル**: `[ストーリーID] ストーリー名`
-- **本文**: ユーザーストーリー、受け入れ基準、見積もり情報
-- **Project 紐付け**: 作成した Project に自動追加
+- **本文**: ユーザーストーリー、サブタスク、受入条件、見積もり情報
+- **Milestone**: リリースフェーズに対応する Milestone に割り当て
+- **Project 紐付け**: `gh project item-add` で Project に追加
+
+```bash
+# Issue の作成（Milestone 付き）
+gh issue create --repo <OWNER>/<REPO> \
+  --title "<ストーリーID>: <ストーリー名>" \
+  --milestone "<Milestone 名>" \
+  --body "..."
+
+# Project への追加
+gh project item-add <PROJECT_NUMBER> --owner <OWNER> \
+  --url "https://github.com/<OWNER>/<REPO>/issues/<NUMBER>"
+```
 
 ### 5. フィールド値の設定
 
 各 Issue に対して Project のカスタムフィールド値を個別に設定します。
 
-**設定手順**:
-
-1. **フィールド ID とオプション ID の取得**
-
-   ```bash
-   gh project field-list <PROJECT_NUMBER> --owner <OWNER> --format json
-   ```
+#### 5.1 フィールド ID・オプション ID の取得
 
-2. **Project Item ID の取得**
-
-   ```bash
-   gh project item-list <PROJECT_NUMBER> --owner <OWNER> --format json --limit 50 \
-     | jq -r '.items[] | "\(.content.number):\(.id)"'
-   ```
+```bash
+# フィールド一覧の取得
+gh project field-list <PROJECT_NUMBER> --owner <OWNER> --format json
 
-3. **各 Issue にフィールド値を設定**
+# Project Item ID の取得
+gh project item-list <PROJECT_NUMBER> --owner <OWNER> --format json --limit 50 \
+  | jq -r '.items[] | "\(.content.number):\(.id)"'
+```
 
-   ```bash
-   # Single Select フィールド（リリース、イテレーション、優先度、カテゴリ、Status）
-   gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
-     --field-id <FIELD_ID> --single-select-option-id <OPTION_ID>
+#### 5.2 Single Select / Number フィールドの設定
 
-   # Number フィールド（SP）
-   gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
-     --field-id <FIELD_ID> --number <VALUE>
-   ```
+```bash
+# Single Select フィールドの設定
+gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
+  --field-id <FIELD_ID> --single-select-option-id <OPTION_ID>
 
-**設定されるフィールド**:
+# Number フィールドの設定
+gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> \
+  --field-id <FIELD_ID> --number <VALUE>
+```
 
-| フィールド | タイプ | 設定内容 |
-|-----------|--------|---------|
-| **リリース** | Single Select | Release 1.0 MVP Alpha / 1.1 MVP Beta / 1.2 MVP / 2.0 完成版 |
-| **イテレーション** | **Iteration** | IT-1 〜 IT-6（2 週間スプリント） |
-| **優先度** | Single Select | 必須 / 中 / 低 |
-| **SP** | Number | ストーリーポイント（2〜5） |
-| **カテゴリ** | Single Select | 認証 / お知らせ / 社員名簿 / カレンダー / 規定集 / マニュアル / ツール / 問い合わせ / 申請 / 承認 / ユーザー管理 |
-| **Status** | Single Select | Todo / In Progress / Done |
+#### 5.3 Iteration フィールドの作成と設定
 
-**Iteration フィールドの作成**:
+Iteration フィールドは **Single Select ではなく Iteration 型** で作成します。GraphQL API の `createProjectV2Field` に `iterationConfiguration` を含めることで、フィールド作成と同時にイテレーション期間を設定できます。
 
-イテレーションフィールドは `gh project field-create` では作成できないため、GraphQL API を使用します:
+**Iteration フィールドの作成（iterationConfiguration 付き）**:
 
 ```bash
 gh api graphql -f query='
@@ -109,26 +128,100 @@ mutation {
     projectId: "<PROJECT_ID>"
     dataType: ITERATION
     name: "イテレーション"
+    iterationConfiguration: {
+      startDate: "<開始日 YYYY-MM-DD>"
+      duration: <デフォルト期間（日数）>
+      iterations: [
+        { title: "<IT名>", startDate: "<開始日>", duration: <日数> },
+        ...
+      ]
+    }
   }) {
     projectV2Field {
       ... on ProjectV2IterationField {
         id
         name
-        dataType
+        configuration {
+          iterations { id title startDate duration }
+        }
+      }
+    }
+  }
+}'
+```
+
+**GraphQL スキーマ**:
+
+```
+CreateProjectV2FieldInput:
+  projectId: ID!
+  dataType: ProjectV2CustomFieldType!   # ITERATION を指定
+  name: String!
+  iterationConfiguration: ProjectV2IterationFieldConfigurationInput
+
+ProjectV2IterationFieldConfigurationInput:
+  startDate: Date!        # フィールド全体の開始日
+  duration: Int!          # デフォルト期間（日数）
+  iterations: [ProjectV2Iteration!]!
+
+ProjectV2Iteration:
+  title: String!          # イテレーション名（例: "IT1", "Sprint 1"）
+  startDate: Date!        # 開始日（YYYY-MM-DD）
+  duration: Int!          # 期間（日数、例: 14）
+```
+
+**重要**: `iterationConfiguration` を含めることで Web UI での手動設定は不要です。
+
+**Iteration フィールドの ID と各イテレーション ID の取得**:
+
+```bash
+gh api graphql -f query='
+query {
+  node(id: "<PROJECT_ID>") {
+    ... on ProjectV2 {
+      field(name: "イテレーション") {
+        ... on ProjectV2IterationField {
+          id
+          configuration {
+            iterations { id title startDate duration }
+          }
+        }
       }
     }
   }
 }'
 ```
 
-**注意**: Iteration フィールドの期間設定（開始日、スプリント期間）は GitHub Web UI から設定する必要があります:
+**各 Issue への Iteration 値の設定**:
 
-1. Project Settings → 「イテレーション」フィールド → 設定
-2. 各イテレーション（IT-1〜IT-6）を追加し、開始日と期間（14 日）を設定
+```bash
+gh api graphql -f query='
+mutation {
+  updateProjectV2ItemFieldValue(input: {
+    projectId: "<PROJECT_ID>"
+    itemId: "<ITEM_ID>"
+    fieldId: "<ITERATION_FIELD_ID>"
+    value: { iterationId: "<ITERATION_ID>" }
+  }) {
+    projectV2Item { id }
+  }
+}'
+```
 
 ### 6. Milestone の作成
 
-リリースを GitHub Milestone として作成し、Issue に割り当てます。
+リリースフェーズを GitHub Milestone として作成し、Issue に割り当てます。
+
+```bash
+# Milestone の作成
+gh api repos/<OWNER>/<REPO>/milestones --method POST \
+  -f title="<Milestone 名>" \
+  -f description="<説明>" \
+  -f due_on="<期限 YYYY-MM-DDT00:00:00Z>"
+
+# Issue 作成時に --milestone で指定するか、既存 Issue に割り当て
+gh issue edit <NUMBER> --repo <OWNER>/<REPO> --milestone "<Milestone 名>"
+```
 
 ### 7. 差異確認と同期
 
@@ -140,6 +233,7 @@ release_plan.md と GitHub Issue/Project の整合性を確認し、差異があ
 - ストーリーポイントの一致
 - リリース/Milestone 割り当ての一致
 - 優先度の一致
+- イテレーション割り当ての一致
 - Status の一致
 
 **同期動作**:
@@ -147,34 +241,49 @@ release_plan.md と GitHub Issue/Project の整合性を確認し、差異があ
 1. release_plan.md と GitHub Issue/Project の差異を検出
 2. 差異レポートを表示（追加/変更/削除項目）
 3. 差異がある場合は同期を実行:
+
    - **新規ストーリー**: Issue を作成し Project に追加
    - **変更されたストーリー**: Issue のフィールド値を更新
    - **削除されたストーリー**: Issue をクローズ（削除はしない）
    - **Status 変更**: release_plan.md の Status を GitHub に反映
 
-### 8. 出力例
+### 8. フィールド値の一括確認（GraphQL）
 
-```
-GitHub Project 同期結果
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Project: 会計システムのケーススタディ
-
-Issue 作成状況
-├─ 認証・ユーザー管理: 6 件（21SP）
-├─ マスタ管理: 8 件（29SP）
-├─ 仕訳管理: 10 件（45SP）
-├─ 元帳・残高管理: 5 件（26SP）
-├─ 財務諸表: 3 件（21SP）
-└─ システム管理: 2 件（13SP）
-   合計: 34 件（155SP）
-
-Milestone 割り当て
-├─ リリース 1.0 MVP: 14 件
-├─ リリース 2.0 機能拡張版: 12 件
-└─ リリース 3.0 完成版: 8 件
-
-同期完了: release_plan.md と GitHub が一致
+設定済みのフィールド値を一覧で確認します。
+
+```bash
+gh api graphql -f query='
+query {
+  node(id: "<PROJECT_ID>") {
+    ... on ProjectV2 {
+      items(first: 50) {
+        nodes {
+          content {
+            ... on Issue { number title }
+          }
+          fieldValues(first: 10) {
+            nodes {
+              ... on ProjectV2ItemFieldSingleSelectValue {
+                field { ... on ProjectV2SingleSelectField { name } }
+                name
+              }
+              ... on ProjectV2ItemFieldNumberValue {
+                field { ... on ProjectV2Field { name } }
+                number
+              }
+              ... on ProjectV2ItemFieldIterationValue {
+                field { ... on ProjectV2IterationField { name } }
+                title
+                startDate
+                duration
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}'
 ```
 
 ### 9. 同期フロー
@@ -223,6 +332,7 @@ graph TD
 
   - 既存の Project/Issue がある場合は重複作成に注意
   - フィールド値の更新は既存値を上書き
+  - Iteration フィールドの期間変更は GraphQL API または Web UI で実施
 
 - **推奨事項**:
 
@@ -235,9 +345,11 @@ graph TD
 2. **計画更新時**: `--sync` で差異確認と自動同期
 3. **定期確認**: `--status` で進捗状況を定期的に確認
 4. **一貫性維持**: release_plan.md を Single Source of Truth として管理し、`--sync` で GitHub に反映
+5. **Iteration 型の活用**: イテレーションは Single Select ではなく Iteration 型フィールドを使用し、スプリント期間を明示する
 
 ### 関連スキル
 
 - `planning-releases` : リリース計画とイテレーション計画の作成
 - `tracking-progress` : 進捗状況の確認と更新
+- `orchestrating-project` : 計画・進捗管理フェーズ全体のオーケストレーション
 - `git-commit` : 変更のコミット

package/lib/assets/.claude/skills/tracking-progress/SKILL.md

@@ -1,164 +1,164 @@
----
-name: tracking-progress
-description: プロジェクトの開発進捗を包括的に分析しレポート生成。イテレーション達成度、技術実装状況、品質メトリクスを確認。進捗確認やステークホルダー報告時に使用。
----
-
-# 進捗追跡ガイド
-
-プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告します。
-
-## Instructions
-
-### 1. オプション
-
-- なし : 全体的な進捗確認（デフォルト）
-- `--brief` : 簡潔な進捗サマリー表示
-- `--detailed` : 詳細な進捗レポート生成
-- `--iteration <番号>` : 特定イテレーションの進捗確認
-- `--technical` : 技術的な実装状況に焦点
-- `--docs` : ドキュメント更新状況の確認
-- `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
-
-### 2. 基本例
-
-```bash
-# 基本的な進捗確認
-# 「プロジェクト全体の開発進捗を包括的にレポート」
-
-# 簡潔なサマリー
-# --brief
-# 「要点のみを絞った進捗状況を表示」
-
-# 詳細レポート
-# --detailed
-# 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
-
-# 特定イテレーションの確認
-# --iteration 1
-# 「イテレーション 1 の完了状況と成果を詳細分析」
-
-# 進捗をドキュメントに反映
-# --update
-# 「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」
-```
-
-### 3. 包括的な進捗分析
-
-プロジェクトの多角的な視点から現在の進捗状況を分析:
-
-- **イテレーション達成度**: 計画 vs 実績の比較分析
-- **技術実装状況**: 機能完成度・品質指標・テスト結果
-- **アーキテクチャ進展**: 設計の実装状況と技術的負債
-- **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
-
-### 4. 動的な状況判定
-
-```bash
-# 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. **振り返りセクション**: メトリクス実績値を記入
-
-**更新判定の情報源**:
-
-```bash
-# 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` : イテレーション計画の作成・更新
+---
+name: tracking-progress
+description: プロジェクトの開発進捗を包括的に分析しレポート生成。イテレーション達成度、技術実装状況、品質メトリクスを確認。進捗確認やステークホルダー報告時に使用。
+---
+
+# 進捗追跡ガイド
+
+プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告します。
+
+## Instructions
+
+### 1. オプション
+
+- なし : 全体的な進捗確認（デフォルト）
+- `--brief` : 簡潔な進捗サマリー表示
+- `--detailed` : 詳細な進捗レポート生成
+- `--iteration <番号>` : 特定イテレーションの進捗確認
+- `--technical` : 技術的な実装状況に焦点
+- `--docs` : ドキュメント更新状況の確認
+- `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
+
+### 2. 基本例
+
+```bash
+# 基本的な進捗確認
+# 「プロジェクト全体の開発進捗を包括的にレポート」
+
+# 簡潔なサマリー
+# --brief
+# 「要点のみを絞った進捗状況を表示」
+
+# 詳細レポート
+# --detailed
+# 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
+
+# 特定イテレーションの確認
+# --iteration 1
+# 「イテレーション 1 の完了状況と成果を詳細分析」
+
+# 進捗をドキュメントに反映
+# --update
+# 「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」
+```
+
+### 3. 包括的な進捗分析
+
+プロジェクトの多角的な視点から現在の進捗状況を分析:
+
+- **イテレーション達成度**: 計画 vs 実績の比較分析
+- **技術実装状況**: 機能完成度・品質指標・テスト結果
+- **アーキテクチャ進展**: 設計の実装状況と技術的負債
+- **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
+
+### 4. 動的な状況判定
+
+```bash
+# 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. **振り返りセクション**: メトリクス実績値を記入
+
+**更新判定の情報源**:
+
+```bash
+# 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` : イテレーション計画の作成・更新