@k2works/claude-code-booster 0.1.3 → 0.2.1

package/lib/assets/.claude/commands/plan.md

@@ -1,134 +1,184 @@
 ## Plan
 
-実装前の計画立案モードを起動して、詳細な実装戦略を策定します。コード実装前に構造化された計画を立てることで、効率的な開発を支援します。
+アジャイルなリリース計画とイテレーション計画を作成し、プロジェクトの進捗を管理します。
 
 ### 使い方
 
 ```bash
-# Claude に Plan Mode を依頼
-「[実装内容] の実装計画を立てて」
+/plan [オプション]
 ```
 
-### 基本例
-
-```bash
-# 新機能の実装計画
-「ユーザー認証機能の実装計画を立てて」
+### オプション
 
-# システム設計の計画
-「マイクロサービス分割の実装計画を立てて」
+- なし : 全体のリリース計画を作成または更新
+- `--release` : リリース計画のみを作成（3-6ヶ月のマクロ計画）
+- `--iteration <番号>` : 特定のイテレーション計画を作成（2週間の詳細計画）
+- `--velocity` : ベロシティ分析と予測を実行
+- `--burndown` : バーンダウンチャートを生成
+- `--retrospective` : ふりかえり結果を記録し次イテレーション計画に反映
+- `--status` : 現在の進捗状況をサマリー表示
 
-# リファクタリング計画
-「レガシーコードのリファクタリング計画を立てて」
-```
-
-### Claude との連携
+### 基本例
 
 ```bash
-# 複雑な機能実装
-「チャット機能の実装計画を立てて。WebSocket、リアルタイム通知、履歴管理を含めて」
+# 初回のリリース計画作成
+/plan
+「要件定義書とユーザーストーリーからリリース計画を作成して」
 
-# データベース設計
-「EC サイトのデータベース設計計画を立てて。商品、注文、ユーザー管理を含めて」
+# イテレーション1の詳細計画作成
+/plan --iteration 1
+「リリース計画に基づいてイテレーション1の詳細計画を作成して」
 
-# API 設計
-「GraphQL API の実装計画を立てて。認証、キャッシュ、レート制限を含めて」
+# 進捗状況の確認
+/plan --status
+「現在のリリース進捗とベロシティを分析して」
 
-# インフラ設計
-「Docker 化の実装計画を立てて。開発環境、本番環境、CI/CD を含めて」
+# ふりかえり結果の反映
+/plan --retrospective
+「イテレーション1のふりかえり結果を記録して次の計画に反映して」
 ```
 
-### Plan Mode の特徴
+### 詳細機能
 
-**自動起動**
+#### リリース計画の作成
 
-- 実装タスクを検出すると自動的に Plan Mode が起動
-- 「実装計画を立てて」などのキーワードで明示的に起動可能
+リリース・イテレーション計画ガイドに準拠した包括的なリリース計画を作成します。
 
-**構造化された仕様書**
+**作成される内容**:
+- **満足条件**: スコープ・スケジュール・リソースの定義
+- **ベロシティ見積もり**: 基準ストーリー分析に基づく初期見積もり
+- **優先順位マトリックス**: 4軸評価（金銭価値・コスト・知識習得・リスク軽減）
+- **段階的リリース戦略**: MVP → 機能拡張版 → 完成版
+- **バッファ戦略**: フィーチャバッファ30%、スケジュールバッファ計算
 
-- 要件定義（ユーザーストーリー・受け入れ基準）
-- 設計書（アーキテクチャ・データ設計・ UI 設計）
-- 実装計画（タスク分解・進捗追跡・品質保証）
-- リスク分析と対策
+```bash
+# ユーザーストーリーを分析してリリース計画作成
+/plan --release
+「ユーザーストーリーを分析して6ヶ月のリリース計画を作成して」
+```
 
-**承認プロセス**
+#### イテレーション計画の作成
 
-- `exit_plan_mode` ツールで計画を提示
-- **重要**: ツールの戻り値に関わらず、必ずユーザーの明示的承認を待つ
-- 承認なしでの実装開始は禁止
-- 計画の修正・調整が可能
-- 承認後にのみ TodoWrite でタスク管理を開始
+コミットメント駆動方式で実行可能な2週間のイテレーション計画を作成します。
 
-### 詳細例
+**作成される内容**:
+- **イテレーションゴール**: 1-2行で表現される明確な目標
+- **ストーリー選択**: リリース計画に基づく優先順位付け
+- **タスク分解**: 各ストーリーを4-16理想時間のタスクに分解
+- **担当者割り当て**: チームメンバーへのタスク配分
+- **詳細スケジュール**: ガントチャートによる視覚化
+- **コミットメント確認**: チーム全員の合意形成
 
 ```bash
-# 複雑なシステム実装
-「オンライン決済システムの実装計画を立てて。Stripe 連携、セキュリティ、エラーハンドリングを含めて」
-
-# フロントエンド実装
-「React ダッシュボードの実装計画を立てて。状態管理、コンポーネント設計、テストを含めて」
-
-# バックエンド実装
-「RESTful API の実装計画を立てて。認証、バリデーション、ログ記録を含めて」
-
-# DevOps 実装
-「CI/CD パイプラインの実装計画を立てて。テスト自動化、デプロイメント、監視を含めて」
+# イテレーション3の詳細計画を作成
+/plan --iteration 3
+「イテレーション3（予約作成機能）の詳細タスク計画を作成して」
 ```
 
-### 3 段階ワークフロー
+#### ベロシティ管理
 
-#### Phase 1: Requirements（要件定義）
+チームの開発速度を継続的に測定・分析・予測します。
 
-- **ユーザーストーリー**: 機能の目的と価値を明確化
-- **受け入れ基準**: 完了条件と品質基準を定義
-- **制約・前提条件**: 技術的・時間的制約を整理
-- **優先順位付け**: Must-have/Nice-to-have の分類
+**分析内容**:
+- **実績ベロシティ**: 完了ストーリーポイントの集計
+- **平均ベロシティ**: 過去3-8イテレーションの平均
+- **予測精度**: 見積もりと実績の差分分析
+- **改善提案**: ベロシティ向上のための提案
 
-#### Phase 2: Design（設計）
+```bash
+# ベロシティ分析と今後の予測
+/plan --velocity
+「過去のイテレーション実績からベロシティを分析して今後を予測して」
+```
 
-- **アーキテクチャ設計**: システム構成と技術選定
-- **データ設計**: スキーマ、API 仕様、データフロー
-- **UI/UX 設計**: 画面構成と操作フロー
-- **リスク分析**: 潜在的問題と対策
+#### 進捗管理
 
-#### Phase 3: Implementation（実装）
+バーンダウンチャートと各種メトリクスで進捗を可視化します。
 
-- **タスク分解**: 実装可能な単位への細分化
-- **進捗追跡**: TodoWrite による状態管理
-- **品質保証**: テスト戦略と検証方法
-- **承認プロセス**: exit_plan_mode での計画提示と明示的承認待機
+**生成される情報**:
+- **リリースバーンダウン**: 残ストーリーポイントの推移
+- **イテレーションバーンダウン**: 残理想時間の日次推移
+- **パーキングロットチャート**: テーマ単位の進捗率
+- **品質メトリクス**: テストカバレッジ、バグ密度等
 
-### 注意事項
+```bash
+# 現在のリリース進捗を可視化
+/plan --burndown
+「リリース1.0の進捗をバーンダウンチャートで表示して」
+```
 
-**適用範囲**
+### 出力例
 
-- Plan Mode は複雑な実装タスクに最適
-- 単純な修正や小規模な変更の場合は、通常の実装形式を使用
-- 3 ステップ以上の作業や新規機能開発に推奨
+```
+📊 リリース計画サマリー
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 リリース1.0 MVP（8週間）
+├─ 目標: 基本的な会議室予約機能
+├─ ストーリー: 10個（41SP）
+├─ ベロシティ: 10-11SP/イテレーション
+└─ 進捗: 25%完了（イテレーション1/4完了）
+
+📈 ベロシティ推移
+├─ イテレーション1: 10SP（計画通り）
+├─ 平均: 10SP
+└─ 予測: リリース1.0は予定通り完了見込み
+
+⚠️ リスク状況
+├─ 技術リスク: JWT設定の複雑化（対策実施中）
+└─ スケジュールリスク: 低（バッファ2週間確保）
+```
 
-**技術的制約**
+### Claude との連携
 
-- `exit_plan_mode` ツールの戻り値は信頼しない
-- 承認プロセスはユーザーの明示的な意思表示で判断
-- CLI の plan mode とは異なる機能
+```bash
+# 要件定義書からリリース計画を自動生成
+cat docs/requirements/requirements.md
+cat docs/requirements/user_story.md
+/plan
+「要件定義書とユーザーストーリーから包括的なリリース計画を作成して」
+
+# 既存計画の更新と調整
+cat docs/requirements/release_plan.md
+/plan --iteration 2
+「リリース計画とイテレーション1の実績を基にイテレーション2計画を作成して」
+
+# ふりかえり結果の反映
+cat retrospective_notes.md
+/plan --retrospective
+「ふりかえりの改善点を次のイテレーション計画に反映して」
+```
 
-**実行上の注意**
+### 注意事項
 
-- 承認前の実装開始は厳禁
-- 計画提示後は必ずユーザー応答を待機
-- エラー時は代替手段を提示
+- **前提条件**: 要件定義書またはユーザーストーリーが存在すること
+- **制限事項**: 初回ベロシティは推測値のため、3イテレーション後に再調整推奨
+- **推奨事項**: 各イテレーション終了時に計画を更新し、生きた文書として管理
+
+### ベストプラクティス
+
+1. **段階的詳細化**: リリース計画は概要レベル、イテレーション計画で詳細化
+2. **継続的調整**: 実績に基づいてベロシティと計画を継続的に調整
+3. **バッファ確保**: フィーチャバッファ30%、スケジュールバッファを必ず設定
+4. **チームコミットメント**: イテレーション計画は必ずチーム全員で合意形成
+5. **データドリブン**: 感覚ではなく実績データに基づいて計画調整
+
+### 計画作成の流れ
+
+```mermaid
+graph TD
+    A[要件定義/ユーザーストーリー] --> B[リリース計画作成]
+    B --> C[イテレーション計画作成]
+    C --> D[実行・進捗管理]
+    D --> E[ふりかえり]
+    E --> F[計画調整]
+    F --> C
+    F --> B
+```
 
-### 実行例
+### 関連コマンド
 
-```bash
-# 使用例
-「ユーザー管理システムの実装計画を立てて」
-
-# 期待される動作
-# 1. Plan Mode が自動起動
-# 2. 要件分析と技術選定
-# 3. 実装ステップの構造化
-# 4. exit_plan_mode で計画提示
-# 5. 承認後に実装開始
-```
+- `/spec` : 要件定義とユーザーストーリーの作成
+- `/task` : 個別タスクの管理と実行
+- `/review` : コードレビューと品質確認
+- `/test` : テスト計画と実行管理

package/lib/assets/.claude/commands/progress.md

@@ -0,0 +1,172 @@
+## Progress
+
+プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告するコマンド。
+
+### 使い方
+
+```bash
+/progress [オプション]
+```
+
+### オプション
+
+- なし : 全体的な進捗確認（デフォルト）
+- `--brief` : 簡潔な進捗サマリー表示
+- `--detailed` : 詳細な進捗レポート生成
+- `--iteration <番号>` : 特定イテレーションの進捗確認
+- `--technical` : 技術的な実装状況に焦点
+- `--docs` : ドキュメント更新状況の確認
+
+### 基本例
+
+```bash
+# 基本的な進捗確認
+/progress
+「プロジェクト全体の開発進捗を包括的にレポート」
+
+# 簡潔なサマリー
+/progress --brief
+「要点のみを絞った進捗状況を表示」
+
+# 詳細レポート
+/progress --detailed
+「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
+
+# 特定イテレーションの確認
+/progress --iteration 1
+「イテレーション1の完了状況と成果を詳細分析」
+
+# 技術的な実装状況
+/progress --technical
+「コード実装・テスト・アーキテクチャの技術的進捗を確認」
+
+# ドキュメント状況
+/progress --docs
+「計画・仕様・READMEなどのドキュメント更新状況を確認」
+```
+
+### 詳細機能
+
+#### 包括的な進捗分析
+
+プロジェクトの多角的な視点から現在の進捗状況を分析：
+
+- **イテレーション達成度**: 計画vs実績の比較分析
+- **技術実装状況**: 機能完成度・品質指標・テスト結果
+- **アーキテクチャ進展**: 設計の実装状況と技術的負債
+- **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
+
+#### 動的な状況判定
+
+```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"
+```
+
+#### 品質メトリクス取得
+
+実装品質の定量的評価：
+
+- **テストカバレッジ**: 単体・統合・E2Eテストの網羅率
+- **コード品質**: 静的解析結果・複雑度測定
+- **性能指標**: レスポンス時間・スループット測定
+- **セキュリティ**: 脆弱性スキャン結果
+
+### 出力例
+
+```
+プロジェクト進捗レポート
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Overall Status: フルスタック実装完成 (MVP準備段階)
+
+🎯 Iteration Progress:
+├─ Iteration 1 (認証・閲覧): ✅ 完了 (計画10日→実績4日, 60%短縮)
+├─ Iteration 2 (予約機能): 📋 計画済み (8営業日予定)
+├─ Iteration 3 (キャンセル): ⏳ 待機中
+└─ Iteration 4 (運用準備): ⏳ 待機中
+
+💻 Technical Implementation:
+├─ Backend (.NET 9): ✅ 完全実装 (181テスト全通過)
+├─ Frontend (React TS): ✅ 完全実装 (認証・会議室一覧)
+├─ Database (SQLite): ✅ 稼働中 (自動初期化対応)
+├─ Authentication: ✅ JWT完全実装 (ログアウト問題解決済)
+└─ API Integration: ✅ フルスタック連携確認
+
+🚀 Runtime Status:
+├─ Backend API: ✅ http://localhost:5150 (稼働中)
+├─ Frontend: ✅ http://localhost:3000 (稼働中)
+├─ Test Coverage: ✅ 95%+ (181件全通過)
+└─ Build Status: ✅ 警告・エラーなし
+
+📚 Documentation:
+├─ 計画書: ✅ 最新 (イテレーション1完了・イテレーション2計画)
+├─ リリース計画: ✅ 更新済み (実績反映・短縮スケジュール)
+├─ README: ✅ 実行手順書完備
+└─ API仕様: ✅ Swagger UI統合
+
+🎉 Key Achievements:
+• フルスタック基盤完成 (計画を大幅上回る成果)
+• 即座ログアウト問題の完全解決
+• React TypeScript UI の完全実装
+• 181テスト全通過の高品質実装
+
+🔜 Next Steps:
+• イテレーション2開始準備完了
+• 予約機能実装によるMVP達成
+• 楽観的ロック・重複防止実装
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Claude との連携
+
+```bash
+# 現在の実行状況と組み合わせ
+ps aux | grep -E "dotnet|node"
+netstat -tlnp | grep -E ":3000|:5150"
+/progress --technical
+「実行中のサービスを含めた技術的進捗分析を依頼」
+
+# Git状況と組み合わせ
+git log --oneline -5
+git status
+/progress --detailed
+「最新のコミット情報を含めた詳細進捗レポート」
+
+# テスト結果と組み合わせ
+dotnet test --logger trx
+/progress --brief
+「テスト実行結果を含めた簡潔な進捗確認」
+
+# ドキュメント状況と組み合わせ
+find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
+/progress --docs
+「最新のドキュメント更新を含めた文書整備状況の確認」
+```
+
+### 注意事項
+
+- **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
+- **情報取得**: 実行時点での動的な状況を総合的に分析
+- **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
+
+### ベストプラクティス
+
+1. **定期実行**: イテレーション開始・終了時の進捗確認
+2. **問題発見**: 遅延や品質低下の早期発見に活用
+3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
+4. **改善指標**: 進捗データを基にした開発プロセス改善
+
+### 関連コマンド
+
+- `/semantic-commit` : 進捗に合わせた適切なコミット実行
+- `/test` : テスト実行状況の詳細確認（将来実装）
+- `/deploy` : デプロイ準備状況の確認（将来実装）