@k2works/claude-code-booster 0.9.1 → 0.10.0

package/lib/assets/.claude/commands/dev-backend.md

@@ -0,0 +1,144 @@
+## Backend Development Guide Reference
+
+バックエンド開発のためのコーディングとテストガイドを参照し、TDD サイクルに従った開発を支援します。
+
+### 使い方
+
+```bash
+/dev-backend [オプション]
+```
+
+### オプション
+
+- なし : ガイド全体の要約と TDD サイクルの説明
+- `--tdd` : TDD の Red-Green-Refactor サイクルの詳細
+- `--approach` : インサイドアウト/アウトサイドインアプローチの選択指針
+- `--checklist` : コミット前の品質チェックリスト表示
+- `--refactor` : リファクタリングパターンの一覧
+- `--test` : テスト作成のベストプラクティス
+
+### 基本例
+
+```bash
+# TDD サイクルの開始
+/dev-backend --tdd
+「現在のタスクに対して Red-Green-Refactor サイクルを開始」
+
+# アプローチ戦略の確認
+/dev-backend --approach
+「実装アプローチ（インサイドアウト/アウトサイドイン）の選択を支援」
+
+# 品質チェックの実行
+/dev-backend --checklist
+「コミット前の必須確認事項を順次実行」
+
+# リファクタリング支援
+/dev-backend --refactor
+「現在のコードに適用可能なリファクタリングパターンを提案」
+```
+
+### 詳細機能
+
+#### TDD サイクルの実践
+
+Red-Green-Refactor サイクルを厳密に実行：
+
+1. **Red フェーズ**: 失敗するテストを最初に書く
+2. **Green フェーズ**: テストを通す最小限のコードを実装
+3. **Refactor フェーズ**: 重複を除去し設計を改善
+4. @docs/reference/コーディングとテストガイド.md のワークフローに従う
+
+```bash
+# 新機能の TDD 実装開始
+/dev-backend --tdd
+「User エンティティのテストから開始します」
+```
+
+#### 参照ドキュメント
+
+- @docs/design/architecture_backend.md を参照
+- @docs/design/data-model.md を参照
+- @docs/design/domain-model.md を参照
+- @docs/design/tech_stack.md を参照
+- @docs/design/test_strategy.md を参照
+- 作業完了後に対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
+
+#### アプローチ戦略の選択
+
+プロジェクトの状態に応じた最適なアプローチを選択：
+
+- **インサイドアウト**: データ層から開始し上位層へ展開（推奨）
+- **アウトサイドイン**: API から開始しドメインロジックを段階的に実装
+
+### テストコマンド
+
+```bash
+# 全テスト実行
+cd apps/backend && ./gradlew test
+
+# 特定テストクラス実行
+cd apps/backend && ./gradlew test --tests "UserServiceTest"
+
+# テストカバレッジ確認
+cd apps/backend && ./gradlew jacocoTestReport
+```
+
+### API ドキュメント
+
+バックエンドには Swagger UI が組み込まれており、API ドキュメントをブラウザで確認できます。
+
+```bash
+# バックエンドを起動
+cd apps/backend && ./gradlew bootRun
+
+# ブラウザでアクセス
+# Swagger UI: http://localhost:8080/swagger-ui.html
+# OpenAPI JSON: http://localhost:8080/v3/api-docs
+# OpenAPI YAML: http://localhost:8080/api-docs.yaml
+```
+
+#### Swagger UI の機能
+
+- **API 仕様の確認**: 全エンドポイントの詳細を表示
+- **リクエスト実行**: ブラウザから直接 API をテスト
+- **認証サポート**: JWT トークンを設定して認証付き API をテスト
+- **スキーマ確認**: リクエスト/レスポンスの型定義を確認
+
+### Claude との連携
+
+```bash
+# 現在のコードを分析してリファクタリング提案
+cat apps/backend/src/main/java/com/example/User.java
+/dev-backend --refactor
+「このクラスに適用可能なリファクタリングパターンを分析」
+
+# テストカバレッジを確認してテスト追加
+cd apps/backend && ./gradlew jacocoTestReport
+/dev-backend --test
+「カバレッジが低い箇所のテストを追加」
+
+# コミット前の品質確認
+git status
+/dev-backend --checklist
+「全ての品質基準を満たすまで確認を実行」
+```
+
+### 注意事項
+
+- **前提条件**: Java/Gradle のテスト環境が設定済みであること
+- **制限事項**: TDD の三原則を厳密に守る（テストなしでプロダクションコードを書かない）
+- **推奨事項**: コミット前に必ず品質チェックリストを実行
+
+### ベストプラクティス
+
+1. **TODO 駆動開発**: タスクを細かい TODO に分割してから実装開始
+2. **小さなサイクル**: Red-Green-Refactor を 10-15 分で完了させる
+3. **継続的コミット**: 各サイクル完了時に動作する状態でコミット
+4. **Rule of Three**: 同じコードが 3 回現れたらリファクタリング
+
+### 関連コマンド
+
+- `/dev-frontend` : フロントエンド開発ガイド
+- `/task` : タスク管理と TODO リストの作成
+- `/review` : コードレビューの実施
+- `/test` : テスト実行と結果確認

package/lib/assets/.claude/commands/dev-frontend.md

@@ -0,0 +1,126 @@
+## Frontend Development Guide Reference
+
+フロントエンド開発のためのコーディングとテストガイドを参照し、TDD サイクルに従った開発を支援します。
+
+### 使い方
+
+```bash
+/dev-frontend [オプション]
+```
+
+### オプション
+
+- なし : ガイド全体の要約と TDD サイクルの説明
+- `--tdd` : TDD の Red-Green-Refactor サイクルの詳細
+- `--approach` : インサイドアウト/アウトサイドインアプローチの選択指針
+- `--checklist` : コミット前の品質チェックリスト表示
+- `--refactor` : リファクタリングパターンの一覧
+- `--test` : テスト作成のベストプラクティス
+
+### 基本例
+
+```bash
+# TDD サイクルの開始
+/dev-frontend --tdd
+「現在のタスクに対して Red-Green-Refactor サイクルを開始」
+
+# アプローチ戦略の確認
+/dev-frontend --approach
+「実装アプローチ（インサイドアウト/アウトサイドイン）の選択を支援」
+
+# 品質チェックの実行
+/dev-frontend --checklist
+「コミット前の必須確認事項を順次実行」
+
+# リファクタリング支援
+/dev-frontend --refactor
+「現在のコードに適用可能なリファクタリングパターンを提案」
+```
+
+### 詳細機能
+
+#### TDD サイクルの実践
+
+Red-Green-Refactor サイクルを厳密に実行：
+
+1. **Red フェーズ**: 失敗するテストを最初に書く
+2. **Green フェーズ**: テストを通す最小限のコードを実装
+3. **Refactor フェーズ**: 重複を除去し設計を改善
+4. @docs/reference/コーディングとテストガイド.md のワークフローに従う
+
+```bash
+# 新機能の TDD 実装開始
+/dev-frontend --tdd
+「LoginForm コンポーネントのテストから開始します」
+```
+
+#### 参照ドキュメント
+
+- @docs/design/architecture_frontend.md を参照
+- @docs/design/ui-design.md を参照
+- @docs/design/tech_stack.md を参照
+- @docs/design/test_strategy.md を参照
+- 作業完了後に対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
+
+#### アプローチ戦略の選択
+
+プロジェクトの状態に応じた最適なアプローチを選択：
+
+- **アウトサイドイン**: UI から開始しロジックを段階的に実装（推奨）
+- **インサイドアウト**: ユーティリティ/hooks から開始し上位層へ展開
+
+### テストコマンド
+
+```bash
+# 全テスト実行
+cd apps/frontend && npm run test
+
+# ウォッチモードでテスト実行
+cd apps/frontend && npm run test:watch
+
+# テストカバレッジ確認
+cd apps/frontend && npm run test:coverage
+
+# E2E テスト実行
+cd apps/frontend && npm run test:e2e
+```
+
+### Claude との連携
+
+```bash
+# 現在のコードを分析してリファクタリング提案
+cat apps/frontend/src/components/User.tsx
+/dev-frontend --refactor
+「このコンポーネントに適用可能なリファクタリングパターンを分析」
+
+# テストカバレッジを確認してテスト追加
+cd apps/frontend && npm run test:coverage
+/dev-frontend --test
+「カバレッジが低い箇所のテストを追加」
+
+# コミット前の品質確認
+git status
+/dev-frontend --checklist
+「全ての品質基準を満たすまで確認を実行」
+```
+
+### 注意事項
+
+- **前提条件**: Node.js/npm のテスト環境が設定済みであること
+- **制限事項**: TDD の三原則を厳密に守る（テストなしでプロダクションコードを書かない）
+- **推奨事項**: コミット前に必ず品質チェックリストを実行
+
+### ベストプラクティス
+
+1. **TODO 駆動開発**: タスクを細かい TODO に分割してから実装開始
+2. **小さなサイクル**: Red-Green-Refactor を 10-15 分で完了させる
+3. **継続的コミット**: 各サイクル完了時に動作する状態でコミット
+4. **Rule of Three**: 同じコードが 3 回現れたらリファクタリング
+5. **コンポーネント分割**: 単一責任の原則に従いコンポーネントを小さく保つ
+
+### 関連コマンド
+
+- `/dev-backend` : バックエンド開発ガイド
+- `/task` : タスク管理と TODO リストの作成
+- `/review` : コードレビューの実施
+- `/test` : テスト実行と結果確認

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

@@ -1,43 +1,36 @@
 ## Development Guide Reference
 
-コーディングとテストガイドを参照し、TDD サイクルに従った開発を支援します。
+開発フェーズ全体の作業を支援するコマンド。TDD サイクルに従った開発ワークフローを表示します。
 
 ### 使い方
 
 ```bash
-/dev [オプション]
+/dev
 ```
 
-### オプション
-
-- なし : ガイド全体の要約と TDD サイクルの説明
-- `--tdd` : TDD の Red-Green-Refactor サイクルの詳細
-- `--approach` : インサイドアウト/アウトサイドインアプローチの選択指針
-- `--checklist` : コミット前の品質チェックリスト表示
-- `--refactor` : リファクタリングパターンの一覧
-- `--test` : テスト作成のベストプラクティス
-
 ### 基本例
 
 ```bash
-# TDD サイクルの開始
-/dev --tdd
-「現在のタスクに対して Red-Green-Refactor サイクルを開始」
+# 開発フェーズ全体のワークフロー表示
+/dev
+「開発フェーズの全体的な進め方と TDD サイクルの説明」
+```
 
-# アプローチ戦略の確認
-/dev --approach
-「実装アプローチ（インサイドアウト/アウトサイドイン）の選択を支援」
+### 詳細機能
 
-# 品質チェックの実行
-/dev --checklist
-「コミット前の必須確認事項を順次実行」
+#### 開発フェーズの全体像
 
-# リファクタリング支援
-/dev --refactor
-「現在のコードに適用可能なリファクタリングパターンを提案」
-```
+開発フェーズは以下の工程で構成されます：
 
-### 詳細機能
+1. **バックエンド開発** (`/dev-backend`)
+   - Java/Kotlin での実装
+   - Gradle によるビルド・テスト
+   - インサイドアウトアプローチ推奨
+
+2. **フロントエンド開発** (`/dev-frontend`)
+   - TypeScript/React での実装
+   - npm によるビルド・テスト
+   - アウトサイドインアプローチ推奨
 
 #### TDD サイクルの実践
 
@@ -48,42 +41,40 @@ Red-Green-Refactor サイクルを厳密に実行：
 3. **Refactor フェーズ**: 重複を除去し設計を改善
 4. @docs/reference/コーディングとテストガイド.md のワークフローに従う
 
-```bash
-# 新機能の TDD 実装開始
-/dev --tdd
-「User エンティティのテストから開始します」
-```
+#### 参照ドキュメント
+
 - @docs/design/architecture_backend.md を参照
 - @docs/design/architecture_frontend.md を参照
 - @docs/design/data-model.md を参照
 - @docs/design/domain-model.md を参照
 - @docs/design/tech_stack.md を参照
+- @docs/design/ui-design.md を参照
+- @docs/design/test_strategy.md を参照
 - 作業完了後に対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
 
 #### アプローチ戦略の選択
 
 プロジェクトの状態に応じた最適なアプローチを選択：
 
-- **インサイドアウト**: データ層から開始し上位層へ展開
-- **アウトサイドイン**: UI から開始しドメインロジックを段階的に実装
+- **インサイドアウト**: データ層から開始し上位層へ展開（バックエンド推奨）
+- **アウトサイドイン**: UI から開始しドメインロジックを段階的に実装（フロントエンド推奨）
 
 ### Claude との連携
 
 ```bash
-# 現在のコードを分析してリファクタリング提案
-cat src/User.java
-/dev --refactor
-「このクラスに適用可能なリファクタリングパターンを分析」
-
-# テストカバレッジを確認してテスト追加
-npm run test:coverage
-/dev --test
-「カバレッジが低い箇所のテストを追加」
-
-# コミット前の品質確認
-git status
-/dev --checklist
-「全ての品質基準を満たすまで確認を実行」
+# プロジェクト情報の確認後に開発開始
+ls -la apps/
+cat README.md
+/dev
+「プロジェクトの現状を踏まえた開発フェーズの進め方を提案」
+
+# バックエンド開発の開始
+/dev-backend --tdd
+「User エンティティのテストから開始します」
+
+# フロントエンド開発の開始
+/dev-frontend --tdd
+「LoginForm コンポーネントのテストから開始します」
 ```
 
 ### 注意事項
@@ -101,6 +92,5 @@ git status
 
 ### 関連コマンド
 
-- `/task` : タスク管理と TODO リストの作成
-- `/review` : コードレビューの実施
-- `/test` : テスト実行と結果確認
+- `/dev-backend` : バックエンド開発ガイド
+- `/dev-frontend` : フロントエンド開発ガイド

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

@@ -0,0 +1,213 @@
+## Docs Command
+
+設計ドキュメントの一覧表示、進捗確認、内容参照を行うコマンド。
+
+### 使い方
+
+```bash
+/docs [オプション]
+```
+
+### オプション
+
+- なし : ドキュメント一覧と進捗状況を表示
+- `--list` : ドキュメント一覧のみを表示
+- `--status` : ドキュメントの作成状況を詳細表示
+- `--read <ファイル名>` : 指定したドキュメントの内容を表示
+- `--summary` : 全ドキュメントの概要を表示
+- `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
+- `--update-index` : `docs/index.md` のみを更新
+- `--update-mkdocs` : `mkdocs.yml` のみを更新
+
+### 基本例
+
+```bash
+# ドキュメント一覧と進捗確認
+/docs
+「設計ドキュメントの一覧と作成状況を確認」
+
+# 一覧のみ表示
+/docs --list
+「docs/design/ と docs/requirements/ のファイル一覧を表示」
+
+# 詳細な進捗状況
+/docs --status
+「各ドキュメントの完成度や更新日時を含む詳細情報を表示」
+
+# 特定ドキュメントの参照
+/docs --read tech_stack
+「技術スタック選定ドキュメントの内容を表示」
+
+# 全ドキュメントの概要
+/docs --summary
+「全ドキュメントの目的と主要な内容を要約表示」
+
+# docs/index.md と mkdocs.yml を更新
+/docs --update
+「現在のドキュメント構成に合わせて両ファイルを更新」
+
+# docs/index.md のみ更新
+/docs --update-index
+「docs/index.md を現在のドキュメント構成に合わせて更新」
+
+# mkdocs.yml のみ更新
+/docs --update-mkdocs
+「mkdocs.yml の nav セクションを現在のドキュメント構成に合わせて更新」
+```
+
+### 詳細機能
+
+#### ドキュメント構成
+
+本プロジェクトのドキュメントは以下の構成で管理されています：
+
+**要件定義ドキュメント** (`docs/requirements/`)
+- `requirements_definition.md` : 要件定義書（RDRA 2.0）
+- `business_usecase.md` : ビジネスユースケース
+- `system_usecase.md` : システムユースケース
+- `user_story.md` : ユーザーストーリー
+
+**設計ドキュメント** (`docs/design/`)
+- `architecture_backend.md` : バックエンドアーキテクチャ
+- `architecture_frontend.md` : フロントエンドアーキテクチャ
+- `architecture_infrastructure.md` : インフラストラクチャ
+- `data-model.md` : データモデル設計
+- `domain-model.md` : ドメインモデル設計
+- `ui-design.md` : UI 設計
+- `test_strategy.md` : テスト戦略
+- `non_functional.md` : 非機能要件
+- `operation.md` : 運用要件
+- `tech_stack.md` : 技術スタック選定
+
+#### ドキュメント参照
+
+以下のコマンドで特定のドキュメントを参照できます：
+
+```bash
+# 技術スタックを参照
+/docs --read tech_stack
+
+# アーキテクチャを参照
+/docs --read architecture_backend
+
+# 要件定義を参照
+/docs --read requirements_definition
+```
+
+#### ドキュメント更新機能
+
+`--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` を自動更新できます。
+
+**docs/index.md の更新内容**:
+- ドキュメント一覧をカテゴリ別に整理
+- 各ドキュメントへのリンクと説明を生成
+- 「まずこれを読もうリスト」形式で構成
+
+**mkdocs.yml の更新内容**:
+- `nav` セクションを現在のドキュメント構成に合わせて更新
+- 要件定義、設計、開発、運用などのカテゴリで階層化
+- 新しいドキュメントを自動的にナビゲーションに追加
+
+```bash
+# 更新前に差分を確認
+/docs --status
+「現在のドキュメント構成を確認」
+
+# 両ファイルを更新
+/docs --update
+「docs/index.md と mkdocs.yml を更新」
+```
+
+### 出力例
+
+```
+設計ドキュメント一覧
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 docs/requirements/
+├─ ✅ requirements_definition.md (要件定義書)
+├─ ✅ business_usecase.md (ビジネスユースケース)
+├─ ✅ system_usecase.md (システムユースケース)
+└─ ✅ user_story.md (ユーザーストーリー)
+
+📁 docs/design/
+├─ ✅ architecture_backend.md (バックエンドアーキテクチャ)
+├─ ✅ architecture_frontend.md (フロントエンドアーキテクチャ)
+├─ ✅ architecture_infrastructure.md (インフラストラクチャ)
+├─ ✅ data-model.md (データモデル設計)
+├─ ✅ domain-model.md (ドメインモデル設計)
+├─ ✅ ui-design.md (UI 設計)
+├─ ✅ test_strategy.md (テスト戦略)
+├─ ✅ non_functional.md (非機能要件)
+├─ ✅ operation.md (運用要件)
+└─ ✅ tech_stack.md (技術スタック選定)
+
+進捗: 14/14 ドキュメント完成 (100%)
+```
+
+#### --update 実行時の出力例
+
+```
+ドキュメント更新
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📝 docs/index.md を更新しています...
+   ✅ 要件定義セクションを追加
+   ✅ 設計ドキュメントセクションを追加
+   ✅ 開発ドキュメントセクションを追加
+   ✅ 運用ドキュメントセクションを追加
+
+📝 mkdocs.yml を更新しています...
+   ✅ nav セクションを更新
+   ✅ 14 件のドキュメントをナビゲーションに追加
+
+更新完了！
+```
+
+### Claude との連携
+
+```bash
+# ドキュメント状況確認後に分析
+/docs --status
+「不足しているドキュメントがあれば作成を提案」
+
+# 特定ドキュメントを参照して修正
+/docs --read tech_stack
+「技術スタックの内容を確認して改善点を提案」
+
+# 全体概要を確認してレビュー
+/docs --summary
+「ドキュメント全体の整合性をレビュー」
+
+# 新しいドキュメント作成後にインデックスを更新
+/docs --update
+「docs/index.md と mkdocs.yml を最新のドキュメント構成に同期」
+
+# MkDocs でドキュメントサイトをプレビュー
+/docs --update-mkdocs
+「mkdocs.yml を更新後、mkdocs serve でプレビュー確認」
+```
+
+### 注意事項
+
+- **前提条件**: `docs/` ディレクトリが存在すること
+- **制限事項**: Markdown 形式のドキュメントのみ対応
+- **推奨事項**: 定期的にドキュメントの進捗を確認し、最新の状態を維持すること
+- **更新時の注意**: `--update` 実行前に現在の `docs/index.md` と `mkdocs.yml` をバックアップすることを推奨
+- **MkDocs 依存**: `--update-mkdocs` を使用する場合、MkDocs がインストールされている必要がある
+
+### ベストプラクティス
+
+1. **定期確認**: 開発フェーズ移行前にドキュメントの完成度を確認する
+2. **整合性維持**: コード変更時は関連ドキュメントも更新する
+3. **レビュー活用**: チームレビュー前にドキュメント概要を共有する
+4. **バージョン管理**: ドキュメントの変更は Git でコミットする
+5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
+6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
+
+### 関連コマンド
+
+- `/analysis` : 分析フェーズ全体の作業支援
+- `/analysis-requirements` : 要件定義関連の作業支援
+- `/analysis-architecture` : アーキテクチャ設計支援
+- `/progress` : プロジェクト全体の進捗確認