@k2works/claude-code-booster 0.17.0 → 0.18.0

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

@@ -23,13 +23,13 @@
 開発フェーズは以下の工程で構成されます：
 
 1. **バックエンド開発** (`/dev-backend`)
-   - Java/Kotlin での実装
-   - Gradle によるビルド・テスト
+   - 実装
+   - ビルド・テスト
    - インサイドアウトアプローチ推奨
 
 2. **フロントエンド開発** (`/dev-frontend`)
-   - TypeScript/React での実装
-   - npm によるビルド・テスト
+   - 実装
+   - ビルド・テスト
    - アウトサイドインアプローチ推奨
 
 #### TDD サイクルの実践
@@ -43,6 +43,7 @@ Red-Green-Refactor サイクルを厳密に実行：
 
 #### 参照ドキュメント
 
+- @docs/design/architecture.md を参照
 - @docs/design/architecture_backend.md を参照
 - @docs/design/architecture_frontend.md を参照
 - @docs/design/data-model.md を参照

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

@@ -16,6 +16,7 @@
 - `--iteration <番号>` : 特定イテレーションの進捗確認
 - `--technical` : 技術的な実装状況に焦点
 - `--docs` : ドキュメント更新状況の確認
+- `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
 
 ### 基本例
 
@@ -43,6 +44,10 @@
 # ドキュメント状況
 /progress --docs
 「計画・仕様・READMEなどのドキュメント更新状況を確認」
+
+# 進捗をドキュメントに反映
+/progress --update
+「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」
 ```
 
 ### 詳細機能
@@ -81,6 +86,61 @@ netstat -tlnp | grep -E ":3000|:5150"
 - **性能指標**: レスポンス時間・スループット測定
 - **セキュリティ**: 脆弱性スキャン結果
 
+#### --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/
+```
+
+**出力例**:
+
+```
+ドキュメント更新
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📝 docs/development/release_plan.md を更新しています...
+   ✅ イテレーション 1 の進捗状況を更新
+   ✅ Release 1.0 のリリース条件を更新
+
+📝 docs/development/iteration_plan-1.md を更新しています...
+   ✅ 成功基準のチェック状態を更新 (3/5 完了)
+   ✅ タスク分解の状態を更新 (15/21 完了)
+   ✅ メトリクス実績値を更新
+
+更新完了！
+```
+
 ### 出力例
 
 ```
@@ -150,6 +210,15 @@ dotnet test --logger trx
 find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
 /progress --docs
 「最新のドキュメント更新を含めた文書整備状況の確認」
+
+# 進捗をドキュメントに反映
+/progress --update
+「現在の実装状況を分析し、release_plan.md と iteration_plan-*.md を更新」
+
+# イテレーション完了時のドキュメント更新
+git log --oneline -20
+/progress --update
+「イテレーション完了時に振り返りセクションを含む全ドキュメントを更新」
 ```
 
 ### 注意事項
@@ -157,6 +226,7 @@ find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
 - **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
 - **情報取得**: 実行時点での動的な状況を総合的に分析
 - **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
+- **--update 使用時**: 更新前に Git でコミットしておくことを推奨（変更のロールバック用）
 
 ### ベストプラクティス
 
@@ -164,9 +234,12 @@ find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
 2. **問題発見**: 遅延や品質低下の早期発見に活用
 3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
 4. **改善指標**: 進捗データを基にした開発プロセス改善
+5. **ドキュメント同期**: イテレーション完了時に `--update` で docs/development を同期
+6. **振り返り記録**: `--update` 実行後、KPT セクションを手動で記入して振り返りを完了
 
 ### 関連コマンド
 
-- `/semantic-commit` : 進捗に合わせた適切なコミット実行
-- `/test` : テスト実行状況の詳細確認（将来実装）
-- `/deploy` : デプロイ準備状況の確認（将来実装）
+- `/docs` : ドキュメント一覧と進捗状況の確認
+- `/docs --update` : docs/index.md と mkdocs.yml の更新
+- `/git-commit` : 進捗に合わせた適切なコミット実行
+- `/plan` : イテレーション計画の作成・更新

package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md

@@ -0,0 +1,214 @@
+# Codex CLI MCP サーバー設定手順
+
+## 概要
+
+Codex CLI を MCP（Model Context Protocol）サーバーとして動作させ、Claude Code からプロジェクトのコンテキストを効率的に検索・参照できるようにする手順です。
+
+## 前提条件
+
+- Node.js 18 以降がインストールされていること
+- npm が利用可能であること
+- Claude Code がインストールされていること
+
+## 手順
+
+### 1. Codex CLI のインストール
+
+Codex CLI をグローバルにインストールします。
+
+```bash
+npm install -g @openai/codex
+```
+
+インストール確認:
+
+```bash
+codex --version
+```
+
+### 2. Codex MCP サーバーの起動確認
+
+Codex CLI には MCP サーバーとして動作する機能が組み込まれています。以下のコマンドで動作確認します。
+
+```bash
+codex mcp-server
+```
+
+サーバーが待機状態になることを確認したら `Ctrl+C` で停止します。
+
+**注意**: `codex mcp-server` は stdio transport で動作します。
+
+### 3. Claude Code への MCP サーバー設定
+
+Claude Code の MCP 設定ファイルに Codex MCP サーバーを登録します。
+
+#### 設定ファイルの場所
+
+- **グローバル設定**: `~/.claude/.mcp.json`
+- **プロジェクト設定**: `.claude/.mcp.json`
+
+#### 設定内容（推奨: npx 経由）
+
+`.claude/.mcp.json` ファイルの `mcpServers` に以下を追加します:
+
+```json
+{
+  "mcpServers": {
+    "codex": {
+      "command": "npx",
+      "args": ["@openai/codex", "mcp-server"]
+    }
+  }
+}
+```
+
+#### Claude CLI から直接追加する方法（推奨）
+
+```bash
+# ユーザーレベル（グローバル）に追加
+claude mcp add -s user codex -- npx @openai/codex mcp-server
+
+# プロジェクトレベルに追加
+claude mcp add -s project codex -- npx @openai/codex mcp-server
+```
+
+**注意**: `npx -y` オプションは Claude Code の MCP 設定では使用できません。
+
+#### グローバルインストール済みの場合
+
+```json
+{
+  "mcpServers": {
+    "codex": {
+      "command": "codex",
+      "args": ["mcp-server"]
+    }
+  }
+}
+```
+
+#### Windows 環境でパスが認識されない場合
+
+フルパスを指定します:
+
+```json
+{
+  "mcpServers": {
+    "codex": {
+      "command": "C:\\Users\\<ユーザー名>\\scoop\\shims\\codex.cmd",
+      "args": ["mcp-server"]
+    }
+  }
+}
+```
+
+### 4. Claude Code からの利用
+
+Claude Code を起動します。
+
+```bash
+claude
+```
+
+起動後、Claude は MCP 経由で Codex のツールにアクセスできます。
+
+**利用例**:
+
+- 「このプロジェクトの中で認証処理を行っている箇所を探して」
+- 「API エンドポイントの一覧を教えて」
+- 「User モデルを使用しているファイルを検索して」
+
+## トラブルシューティング
+
+### MCP サーバーが起動しない場合
+
+1. Node.js のバージョンを確認:
+
+   ```bash
+   node --version  # 18 以上が必要
+   ```
+
+2. Codex CLI の再インストール:
+
+   ```bash
+   npm uninstall -g @openai/codex
+   npm install -g @openai/codex
+   ```
+
+### Claude Code から接続できない場合
+
+1. 設定ファイルの JSON 構文を確認
+2. コマンドパスが正しいか確認
+3. Claude Code を再起動
+4. `/mcp` コマンドで MCP サーバーの状態を確認
+
+## ベストプラクティス
+
+1. **プロジェクト固有の設定**: `.claude/settings.json` を使用してプロジェクトごとに設定
+2. **除外設定**: `.gitignore` で不要なファイルを除外（Codex は Git を参照）
+3. **OpenAI API キー**: `codex login` で認証を設定
+
+## Codex MCP ツールの使用方法
+
+Claude Code から Codex MCP サーバーを呼び出す際の主要パラメータを説明します。
+
+### 基本パラメータ
+
+| パラメータ | 説明 | 値の例 |
+|-----------|------|--------|
+| `prompt` | Codex に実行させるタスクの指示（必須） | `"Create a file named hello"` |
+| `sandbox` | 実行環境の権限レベル | `read-only`, `workspace-write`, `danger-full-access` |
+| `approval-policy` | コマンド実行時の承認ポリシー | `untrusted`, `on-failure`, `on-request`, `never` |
+| `cwd` | 作業ディレクトリ | `C:\path\to\project` |
+| `model` | 使用するモデル | `gpt-5.2`, `gpt-5.2-codex` |
+
+### sandbox パラメータ
+
+| 値 | 説明 |
+|----|------|
+| `read-only` | 読み取り専用（デフォルト）。ファイルの作成・編集不可 |
+| `workspace-write` | ワークスペース内のファイル書き込みを許可 |
+| `danger-full-access` | 全アクセス許可（注意して使用） |
+
+### approval-policy パラメータ
+
+| 値 | 説明 |
+|----|------|
+| `untrusted` | すべてのコマンドで承認を要求 |
+| `on-failure` | 失敗時のみ承認を要求 |
+| `on-request` | リクエスト時に承認を要求 |
+| `never` | 承認なしで実行（新規ファイル作成は除く） |
+
+### 使用例
+
+#### ファイル作成
+
+```
+prompt: "Create a file named hello containing Hello World"
+sandbox: danger-full-access
+approval-policy: never
+```
+
+**注意**: 新規ファイル作成は `approval-policy: never` でも確認を求められます。
+
+#### コード検索・分析
+
+```
+prompt: "Find all files that handle authentication"
+sandbox: read-only
+```
+
+### 継続的な対話
+
+`codex-reply` ツールを使用して、既存のスレッドで対話を継続できます:
+
+```
+threadId: "019bca72-76d5-73a1-9c68-88d1835932a9"
+prompt: "はい、作成してください"
+```
+
+## 関連リンク
+
+- [Codex CLI GitHub](https://github.com/openai/codex)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Claude Code MCP 設定](https://docs.anthropic.com/claude-code/mcp)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2works/claude-code-booster",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "AI Agent Development Support Tool",
   "main": "main.js",
   "bin": {