@k2works/claude-code-booster 0.16.2 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/lib/assets/.claude/commands/dev.md +5 -4
  2. package/lib/assets/.claude/commands/docs.md +122 -0
  3. package/lib/assets/.claude/commands/progress.md +76 -3
  4. 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 +214 -0
  5. package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +9 -0
  6. package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +1 -0
  7. package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +23 -0
  8. package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +2 -0
  9. package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +4 -0
  10. package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +11 -0
  11. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211.md +2 -1
  12. package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +6 -0
  13. package/package.json +1 -1
@@ -23,13 +23,13 @@
23
23
  開発フェーズは以下の工程で構成されます:
24
24
 
25
25
  1. **バックエンド開発** (`/dev-backend`)
26
- - Java/Kotlin での実装
27
- - Gradle によるビルド・テスト
26
+ - 実装
27
+ - ビルド・テスト
28
28
  - インサイドアウトアプローチ推奨
29
29
 
30
30
  2. **フロントエンド開発** (`/dev-frontend`)
31
- - TypeScript/React での実装
32
- - npm によるビルド・テスト
31
+ - 実装
32
+ - ビルド・テスト
33
33
  - アウトサイドインアプローチ推奨
34
34
 
35
35
  #### TDD サイクルの実践
@@ -43,6 +43,7 @@ Red-Green-Refactor サイクルを厳密に実行:
43
43
 
44
44
  #### 参照ドキュメント
45
45
 
46
+ - @docs/design/architecture.md を参照
46
47
  - @docs/design/architecture_backend.md を参照
47
48
  - @docs/design/architecture_frontend.md を参照
48
49
  - @docs/design/data-model.md を参照
@@ -18,6 +18,7 @@
18
18
  - `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
19
19
  - `--update-index` : `docs/index.md` のみを更新
20
20
  - `--update-mkdocs` : `mkdocs.yml` のみを更新
21
+ - `--lint` : Markdown フォーマットをチェックし、違反を自動修正
21
22
 
22
23
  ### 基本例
23
24
 
@@ -53,6 +54,10 @@
53
54
  # mkdocs.yml のみ更新
54
55
  /docs --update-mkdocs
55
56
  「mkdocs.yml の nav セクションを現在のドキュメント構成に合わせて更新」
57
+
58
+ # Markdown フォーマットをチェック・修正
59
+ /docs --lint
60
+ 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
56
61
  ```
57
62
 
58
63
  ### 詳細機能
@@ -118,6 +123,98 @@
118
123
  「docs/index.md と mkdocs.yml を更新」
119
124
  ```
120
125
 
126
+ #### Lint 機能
127
+
128
+ `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
129
+
130
+ **チェックルール**:
131
+
132
+ - タスク項目(リスト)の前には空行が必要
133
+ - 番号付きリストのサブリスト前にも空行が必要
134
+ - コロンで終わる行の直後にリストがある場合も空行が必要
135
+ - 太字ラベル(半角・全角コロン両方)の直後にリストがある場合も空行が必要
136
+
137
+ **NG 例 1** - ラベルの直後にリスト:
138
+
139
+ ```markdown
140
+ **受入条件**:
141
+ - [ ] ログアウトボタンをクリックするとログアウトできる
142
+ - [ ] ログアウト後、ログイン画面に遷移する
143
+ ```
144
+
145
+ **OK 例 1**:
146
+
147
+ ```markdown
148
+ **受入条件**:
149
+
150
+ - [ ] ログアウトボタンをクリックするとログアウトできる
151
+ - [ ] ログアウト後、ログイン画面に遷移する
152
+ ```
153
+
154
+ **NG 例 2** - 番号付きリストの直後にサブリスト:
155
+
156
+ ```markdown
157
+ 1. **対処**: SMB バージョンを確認
158
+ - コントロールパネル > ファイルサービス > SMB で設定
159
+ ```
160
+
161
+ **OK 例 2**:
162
+
163
+ ```markdown
164
+ 1. **対処**: SMB バージョンを確認
165
+
166
+ - コントロールパネル > ファイルサービス > SMB で設定
167
+ ```
168
+
169
+ **NG 例 3** - コロンで終わる行の直後にリスト:
170
+
171
+ ```markdown
172
+ PMD はカスタム設定で以下をチェック:
173
+ - マジックナンバーの使用
174
+ - 空の catch ブロック
175
+ - 循環複雑度が 7 を超えるメソッド
176
+ ```
177
+
178
+ **OK 例 3**:
179
+
180
+ ```markdown
181
+ PMD はカスタム設定で以下をチェック:
182
+
183
+ - マジックナンバーの使用
184
+ - 空の catch ブロック
185
+ - 循環複雑度が 7 を超えるメソッド
186
+ ```
187
+
188
+ **NG 例 4** - 太字ラベル(全角コロン)の直後にリスト:
189
+
190
+ ```markdown
191
+ **タイプの種類:**
192
+ - `feat`: 新機能の追加
193
+ - `fix`: バグ修正
194
+ ```
195
+
196
+ **OK 例 4**:
197
+
198
+ ```markdown
199
+ **タイプの種類:**
200
+
201
+ - `feat`: 新機能の追加
202
+ - `fix`: バグ修正
203
+ ```
204
+
205
+ **実行手順**:
206
+
207
+ 1. `docs/` 配下の全 Markdown ファイルをスキャン
208
+ 2. 上記ルールに違反する箇所を検出
209
+ 3. 違反箇所を自動修正
210
+ 4. 修正結果を報告
211
+
212
+ ```bash
213
+ # Lint を実行
214
+ /docs --lint
215
+ 「docs/ 配下の Markdown ファイルをチェックし、フォーマット違反を修正」
216
+ ```
217
+
121
218
  ### 出力例
122
219
 
123
220
  ```
@@ -164,6 +261,26 @@
164
261
  更新完了!
165
262
  ```
166
263
 
264
+ #### --lint 実行時の出力例
265
+
266
+ ```
267
+ Markdown Lint
268
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
269
+
270
+ 🔍 docs/ 配下をスキャン中...
271
+
272
+ 📄 docs/development/iteration_plan-1.md
273
+ ⚠️ Line 52: リストの前に空行がありません
274
+ ✅ 修正しました
275
+
276
+ 📄 docs/requirements/user_story.md
277
+ ⚠️ Line 128: リストの前に空行がありません
278
+ ⚠️ Line 156: リストの前に空行がありません
279
+ ✅ 2 箇所を修正しました
280
+
281
+ 結果: 14 ファイルをスキャン、2 ファイルで 3 箇所を修正
282
+ ```
283
+
167
284
  ### Claude との連携
168
285
 
169
286
  ```bash
@@ -186,6 +303,10 @@
186
303
  # MkDocs でドキュメントサイトをプレビュー
187
304
  /docs --update-mkdocs
188
305
  「mkdocs.yml を更新後、mkdocs serve でプレビュー確認」
306
+
307
+ # ドキュメントのフォーマットをチェック・修正
308
+ /docs --lint
309
+ 「Markdown フォーマットの一貫性を確保」
189
310
  ```
190
311
 
191
312
  ### 注意事項
@@ -204,6 +325,7 @@
204
325
  4. **バージョン管理**: ドキュメントの変更は Git でコミットする
205
326
  5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
206
327
  6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
328
+ 7. **フォーマット統一**: コミット前に `--lint` でフォーマットの一貫性を確保する
207
329
 
208
330
  ### 関連コマンド
209
331
 
@@ -16,6 +16,7 @@
16
16
  - `--iteration <番号>` : 特定イテレーションの進捗確認
17
17
  - `--technical` : 技術的な実装状況に焦点
18
18
  - `--docs` : ドキュメント更新状況の確認
19
+ - `--update` : `docs/development/` 内のドキュメントを現在の進捗に合わせて更新
19
20
 
20
21
  ### 基本例
21
22
 
@@ -43,6 +44,10 @@
43
44
  # ドキュメント状況
44
45
  /progress --docs
45
46
  「計画・仕様・READMEなどのドキュメント更新状況を確認」
47
+
48
+ # 進捗をドキュメントに反映
49
+ /progress --update
50
+ 「release_plan.md と iteration_plan-*.md を現在の進捗に合わせて更新」
46
51
  ```
47
52
 
48
53
  ### 詳細機能
@@ -81,6 +86,61 @@ netstat -tlnp | grep -E ":3000|:5150"
81
86
  - **性能指標**: レスポンス時間・スループット測定
82
87
  - **セキュリティ**: 脆弱性スキャン結果
83
88
 
89
+ #### --update オプションの詳細
90
+
91
+ `--update` オプションは `docs/development/` 内のドキュメントを現在の進捗に合わせて自動更新します。
92
+
93
+ **更新対象ファイル**:
94
+
95
+ - `docs/development/release_plan.md` - リリース計画
96
+ - `docs/development/iteration_plan-*.md` - イテレーション計画
97
+
98
+ **release_plan.md の更新内容**:
99
+
100
+ 1. **進捗状況テーブル**: 各イテレーションの実績 SP、達成率、状態を更新
101
+ 2. **リリース条件チェックボックス**: 完了した条件にチェックを入れる
102
+ 3. **バーンダウンチャート**: 実績値を反映
103
+
104
+ **iteration_plan-*.md の更新内容**:
105
+
106
+ 1. **成功基準チェックボックス**: 達成した基準にチェックを入れる
107
+ 2. **タスク分解の状態**: 完了したタスクのチェックボックスを更新
108
+ 3. **完了条件(DoD)**: 達成した条件にチェックを入れる
109
+ 4. **振り返りセクション**: メトリクス実績値を記入
110
+
111
+ **更新判定の情報源**:
112
+
113
+ ```bash
114
+ # Git コミット履歴から実装状況を分析
115
+ git log --oneline --since="2 weeks ago"
116
+
117
+ # テスト実行結果から品質指標を取得
118
+ dotnet test --logger trx
119
+ npm test -- --coverage
120
+
121
+ # ディレクトリ構造から機能実装状況を確認
122
+ ls -la apps/backend/src/
123
+ ls -la apps/frontend/src/
124
+ ```
125
+
126
+ **出力例**:
127
+
128
+ ```
129
+ ドキュメント更新
130
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
131
+
132
+ 📝 docs/development/release_plan.md を更新しています...
133
+ ✅ イテレーション 1 の進捗状況を更新
134
+ ✅ Release 1.0 のリリース条件を更新
135
+
136
+ 📝 docs/development/iteration_plan-1.md を更新しています...
137
+ ✅ 成功基準のチェック状態を更新 (3/5 完了)
138
+ ✅ タスク分解の状態を更新 (15/21 完了)
139
+ ✅ メトリクス実績値を更新
140
+
141
+ 更新完了!
142
+ ```
143
+
84
144
  ### 出力例
85
145
 
86
146
  ```
@@ -150,6 +210,15 @@ dotnet test --logger trx
150
210
  find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
151
211
  /progress --docs
152
212
  「最新のドキュメント更新を含めた文書整備状況の確認」
213
+
214
+ # 進捗をドキュメントに反映
215
+ /progress --update
216
+ 「現在の実装状況を分析し、release_plan.md と iteration_plan-*.md を更新」
217
+
218
+ # イテレーション完了時のドキュメント更新
219
+ git log --oneline -20
220
+ /progress --update
221
+ 「イテレーション完了時に振り返りセクションを含む全ドキュメントを更新」
153
222
  ```
154
223
 
155
224
  ### 注意事項
@@ -157,6 +226,7 @@ find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
157
226
  - **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
158
227
  - **情報取得**: 実行時点での動的な状況を総合的に分析
159
228
  - **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
229
+ - **--update 使用時**: 更新前に Git でコミットしておくことを推奨(変更のロールバック用)
160
230
 
161
231
  ### ベストプラクティス
162
232
 
@@ -164,9 +234,12 @@ find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
164
234
  2. **問題発見**: 遅延や品質低下の早期発見に活用
165
235
  3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
166
236
  4. **改善指標**: 進捗データを基にした開発プロセス改善
237
+ 5. **ドキュメント同期**: イテレーション完了時に `--update` で docs/development を同期
238
+ 6. **振り返り記録**: `--update` 実行後、KPT セクションを手動で記入して振り返りを完了
167
239
 
168
240
  ### 関連コマンド
169
241
 
170
- - `/semantic-commit` : 進捗に合わせた適切なコミット実行
171
- - `/test` : テスト実行状況の詳細確認(将来実装)
172
- - `/deploy` : デプロイ準備状況の確認(将来実装)
242
+ - `/docs` : ドキュメント一覧と進捗状況の確認
243
+ - `/docs --update` : docs/index.md と mkdocs.yml の更新
244
+ - `/git-commit` : 進捗に合わせた適切なコミット実行
245
+ - `/plan` : イテレーション計画の作成・更新
@@ -0,0 +1,214 @@
1
+ # Codex CLI MCP サーバー設定手順
2
+
3
+ ## 概要
4
+
5
+ Codex CLI を MCP(Model Context Protocol)サーバーとして動作させ、Claude Code からプロジェクトのコンテキストを効率的に検索・参照できるようにする手順です。
6
+
7
+ ## 前提条件
8
+
9
+ - Node.js 18 以降がインストールされていること
10
+ - npm が利用可能であること
11
+ - Claude Code がインストールされていること
12
+
13
+ ## 手順
14
+
15
+ ### 1. Codex CLI のインストール
16
+
17
+ Codex CLI をグローバルにインストールします。
18
+
19
+ ```bash
20
+ npm install -g @openai/codex
21
+ ```
22
+
23
+ インストール確認:
24
+
25
+ ```bash
26
+ codex --version
27
+ ```
28
+
29
+ ### 2. Codex MCP サーバーの起動確認
30
+
31
+ Codex CLI には MCP サーバーとして動作する機能が組み込まれています。以下のコマンドで動作確認します。
32
+
33
+ ```bash
34
+ codex mcp-server
35
+ ```
36
+
37
+ サーバーが待機状態になることを確認したら `Ctrl+C` で停止します。
38
+
39
+ **注意**: `codex mcp-server` は stdio transport で動作します。
40
+
41
+ ### 3. Claude Code への MCP サーバー設定
42
+
43
+ Claude Code の MCP 設定ファイルに Codex MCP サーバーを登録します。
44
+
45
+ #### 設定ファイルの場所
46
+
47
+ - **グローバル設定**: `~/.claude/.mcp.json`
48
+ - **プロジェクト設定**: `.claude/.mcp.json`
49
+
50
+ #### 設定内容(推奨: npx 経由)
51
+
52
+ `.claude/.mcp.json` ファイルの `mcpServers` に以下を追加します:
53
+
54
+ ```json
55
+ {
56
+ "mcpServers": {
57
+ "codex": {
58
+ "command": "npx",
59
+ "args": ["@openai/codex", "mcp-server"]
60
+ }
61
+ }
62
+ }
63
+ ```
64
+
65
+ #### Claude CLI から直接追加する方法(推奨)
66
+
67
+ ```bash
68
+ # ユーザーレベル(グローバル)に追加
69
+ claude mcp add -s user codex -- npx @openai/codex mcp-server
70
+
71
+ # プロジェクトレベルに追加
72
+ claude mcp add -s project codex -- npx @openai/codex mcp-server
73
+ ```
74
+
75
+ **注意**: `npx -y` オプションは Claude Code の MCP 設定では使用できません。
76
+
77
+ #### グローバルインストール済みの場合
78
+
79
+ ```json
80
+ {
81
+ "mcpServers": {
82
+ "codex": {
83
+ "command": "codex",
84
+ "args": ["mcp-server"]
85
+ }
86
+ }
87
+ }
88
+ ```
89
+
90
+ #### Windows 環境でパスが認識されない場合
91
+
92
+ フルパスを指定します:
93
+
94
+ ```json
95
+ {
96
+ "mcpServers": {
97
+ "codex": {
98
+ "command": "C:\\Users\\<ユーザー名>\\scoop\\shims\\codex.cmd",
99
+ "args": ["mcp-server"]
100
+ }
101
+ }
102
+ }
103
+ ```
104
+
105
+ ### 4. Claude Code からの利用
106
+
107
+ Claude Code を起動します。
108
+
109
+ ```bash
110
+ claude
111
+ ```
112
+
113
+ 起動後、Claude は MCP 経由で Codex のツールにアクセスできます。
114
+
115
+ **利用例**:
116
+
117
+ - 「このプロジェクトの中で認証処理を行っている箇所を探して」
118
+ - 「API エンドポイントの一覧を教えて」
119
+ - 「User モデルを使用しているファイルを検索して」
120
+
121
+ ## トラブルシューティング
122
+
123
+ ### MCP サーバーが起動しない場合
124
+
125
+ 1. Node.js のバージョンを確認:
126
+
127
+ ```bash
128
+ node --version # 18 以上が必要
129
+ ```
130
+
131
+ 2. Codex CLI の再インストール:
132
+
133
+ ```bash
134
+ npm uninstall -g @openai/codex
135
+ npm install -g @openai/codex
136
+ ```
137
+
138
+ ### Claude Code から接続できない場合
139
+
140
+ 1. 設定ファイルの JSON 構文を確認
141
+ 2. コマンドパスが正しいか確認
142
+ 3. Claude Code を再起動
143
+ 4. `/mcp` コマンドで MCP サーバーの状態を確認
144
+
145
+ ## ベストプラクティス
146
+
147
+ 1. **プロジェクト固有の設定**: `.claude/settings.json` を使用してプロジェクトごとに設定
148
+ 2. **除外設定**: `.gitignore` で不要なファイルを除外(Codex は Git を参照)
149
+ 3. **OpenAI API キー**: `codex login` で認証を設定
150
+
151
+ ## Codex MCP ツールの使用方法
152
+
153
+ Claude Code から Codex MCP サーバーを呼び出す際の主要パラメータを説明します。
154
+
155
+ ### 基本パラメータ
156
+
157
+ | パラメータ | 説明 | 値の例 |
158
+ |-----------|------|--------|
159
+ | `prompt` | Codex に実行させるタスクの指示(必須) | `"Create a file named hello"` |
160
+ | `sandbox` | 実行環境の権限レベル | `read-only`, `workspace-write`, `danger-full-access` |
161
+ | `approval-policy` | コマンド実行時の承認ポリシー | `untrusted`, `on-failure`, `on-request`, `never` |
162
+ | `cwd` | 作業ディレクトリ | `C:\path\to\project` |
163
+ | `model` | 使用するモデル | `gpt-5.2`, `gpt-5.2-codex` |
164
+
165
+ ### sandbox パラメータ
166
+
167
+ | 値 | 説明 |
168
+ |----|------|
169
+ | `read-only` | 読み取り専用(デフォルト)。ファイルの作成・編集不可 |
170
+ | `workspace-write` | ワークスペース内のファイル書き込みを許可 |
171
+ | `danger-full-access` | 全アクセス許可(注意して使用) |
172
+
173
+ ### approval-policy パラメータ
174
+
175
+ | 値 | 説明 |
176
+ |----|------|
177
+ | `untrusted` | すべてのコマンドで承認を要求 |
178
+ | `on-failure` | 失敗時のみ承認を要求 |
179
+ | `on-request` | リクエスト時に承認を要求 |
180
+ | `never` | 承認なしで実行(新規ファイル作成は除く) |
181
+
182
+ ### 使用例
183
+
184
+ #### ファイル作成
185
+
186
+ ```
187
+ prompt: "Create a file named hello containing Hello World"
188
+ sandbox: danger-full-access
189
+ approval-policy: never
190
+ ```
191
+
192
+ **注意**: 新規ファイル作成は `approval-policy: never` でも確認を求められます。
193
+
194
+ #### コード検索・分析
195
+
196
+ ```
197
+ prompt: "Find all files that handle authentication"
198
+ sandbox: read-only
199
+ ```
200
+
201
+ ### 継続的な対話
202
+
203
+ `codex-reply` ツールを使用して、既存のスレッドで対話を継続できます:
204
+
205
+ ```
206
+ threadId: "019bca72-76d5-73a1-9c68-88d1835932a9"
207
+ prompt: "はい、作成してください"
208
+ ```
209
+
210
+ ## 関連リンク
211
+
212
+ - [Codex CLI GitHub](https://github.com/openai/codex)
213
+ - [Model Context Protocol](https://modelcontextprotocol.io/)
214
+ - [Claude Code MCP 設定](https://docs.anthropic.com/claude-code/mcp)
@@ -43,6 +43,7 @@ echo "*.iml" >> .gitignore
43
43
  ```
44
44
 
45
45
  **タイプの種類:**
46
+
46
47
  - `feat`: 新機能の追加
47
48
  - `fix`: バグ修正
48
49
  - `docs`: ドキュメント変更のみ
@@ -345,6 +346,7 @@ pmd {
345
346
  ```
346
347
 
347
348
  PMD はカスタム設定で以下をチェック:
349
+
348
350
  - マジックナンバーの使用
349
351
  - 空の catch ブロック
350
352
  - 循環複雑度が 7 を超えるメソッド
@@ -354,6 +356,7 @@ PMD はカスタム設定で以下をチェック:
354
356
  ### SpotBugs の設定(デフォルト設定を使用)
355
357
 
356
358
  SpotBugs は以下のバグパターンを検出:
359
+
357
360
  - Null ポインタ参照
358
361
  - リソースリーク
359
362
  - セキュリティ脆弱性
@@ -539,28 +542,34 @@ public void method() { }
539
542
  ## ベストプラクティス
540
543
 
541
544
  1. **コミットは小さく頻繁に**
545
+
542
546
  - 機能単位でコミット
543
547
  - テストが通る状態でコミット
544
548
 
545
549
  2. **テストファースト**
550
+
546
551
  - 実装前にテストを書く
547
552
  - テストが失敗することを確認してから実装
548
553
 
549
554
  3. **継続的な品質チェック**
555
+
550
556
  - コミット前に `./gradlew qualityCheck` を実行
551
557
  - カバレッジ 80% 以上を目標
552
558
  - 循環複雑度を 7 以下に維持
553
559
 
554
560
  4. **自動化の活用**
561
+
555
562
  - `./gradlew test --continuous` を常に起動
556
563
  - IDE の自動テスト機能を活用
557
564
 
558
565
  5. **リファクタリングの習慣**
566
+
559
567
  - テストが通ったらリファクタリング
560
568
  - 重複コードの排除
561
569
  - 意図が明確なコード
562
570
 
563
571
  6. **複雑度の管理**
572
+
564
573
  - メソッドの循環複雑度は 7 以下を維持
565
574
  - 複雑なロジックは小さなメソッドに分割
566
575
  - 早期リターンやガード節を活用して複雑度を削減
@@ -44,6 +44,7 @@ echo ".DS_Store" >> .gitignore
44
44
  ```
45
45
 
46
46
  **タイプの種類:**
47
+
47
48
  - `feat`: 新機能の追加
48
49
  - `fix`: バグ修正
49
50
  - `docs`: ドキュメント変更のみ
@@ -161,11 +161,13 @@ s3 --> db
161
161
  ```
162
162
 
163
163
  **メリット**:
164
+
164
165
  - 実装が直感的でわかりやすい
165
166
  - 開発速度が早い
166
167
  - 小規模チームでも扱いやすい
167
168
 
168
169
  **デメリット**:
170
+
169
171
  - コードの重複が発生しやすい
170
172
  - 大規模化すると保守が困難
171
173
  - ビジネスロジックが散在する
@@ -229,11 +231,13 @@ Reservation --> db : CRUD操作
229
231
  ```
230
232
 
231
233
  **メリット**:
234
+
232
235
  - オブジェクトとデータベースの対応が明確
233
236
  - ORMとの相性が良い
234
237
  - 理解しやすい構造
235
238
 
236
239
  **デメリット**:
240
+
237
241
  - データアクセスとビジネスロジックが密結合
238
242
  - テストが困難
239
243
  - ドメインロジックが薄くなる傾向
@@ -301,12 +305,14 @@ ReservationUseCase --> ReservationRepository
301
305
  ```
302
306
 
303
307
  **メリット**:
308
+
304
309
  - リッチなドメインモデル
305
310
  - ビジネスロジックの集約
306
311
  - 高い保守性・拡張性
307
312
  - テスト容易性
308
313
 
309
314
  **デメリット**:
315
+
310
316
  - 初期の学習コストが高い
311
317
  - 設計の複雑さ
312
318
  - 開発速度が遅い場合がある
@@ -369,12 +375,14 @@ ReservationProjection --> ReadModel : プロジェクション更新
369
375
  ```
370
376
 
371
377
  **メリット**:
378
+
372
379
  - 完全な監査証跡
373
380
  - 時系列分析が可能
374
381
  - 高いスケーラビリティ
375
382
  - 複雑なクエリに対応
376
383
 
377
384
  **デメリット**:
385
+
378
386
  - 実装の複雑さ
379
387
  - 高い学習コスト
380
388
  - 結果整合性の考慮が必要
@@ -682,6 +690,7 @@ integration -up-> e2e
682
690
  ```
683
691
 
684
692
  **特徴**:
693
+
685
694
  - ユニットテスト中心(80%)
686
695
  - ドメインロジックの徹底検証
687
696
  - 高品質なビジネスルール実装
@@ -700,6 +709,7 @@ integration -up-> e2e
700
709
  ```
701
710
 
702
711
  **特徴**:
712
+
703
713
  - 統合テスト中心(60%)
704
714
  - データアクセスロジックの重点検証
705
715
  - ORMとの連携確認
@@ -718,6 +728,7 @@ integration -up-> e2e
718
728
  ```
719
729
 
720
730
  **特徴**:
731
+
721
732
  - E2Eテスト中心(70%)
722
733
  - エンドツーエンドの動作確認
723
734
  - シナリオベースの検証
@@ -1420,11 +1431,13 @@ LB --> [アプリケーション]
1420
1431
  ```
1421
1432
 
1422
1433
  **メリット**:
1434
+
1423
1435
  - シンプルな構成
1424
1436
  - 低い運用コスト
1425
1437
  - デプロイが容易
1426
1438
 
1427
1439
  **デメリット**:
1440
+
1428
1441
  - スケーリングの柔軟性が低い
1429
1442
  - 単一障害点
1430
1443
  - 大規模化時の制約
@@ -1467,11 +1480,13 @@ gateway --> [Room Service]
1467
1480
  ```
1468
1481
 
1469
1482
  **メリット**:
1483
+
1470
1484
  - 独立したデプロイとスケーリング
1471
1485
  - 技術スタックの柔軟性
1472
1486
  - 障害の局所化
1473
1487
 
1474
1488
  **デメリット**:
1489
+
1475
1490
  - 複雑な運用
1476
1491
  - 分散システムの課題
1477
1492
  - デバッグの困難さ
@@ -1512,11 +1527,13 @@ package "Kubernetesクラスター" {
1512
1527
  ```
1513
1528
 
1514
1529
  **メリット**:
1530
+
1515
1531
  - 自動スケーリング
1516
1532
  - 高可用性
1517
1533
  - リソース効率化
1518
1534
 
1519
1535
  **デメリット**:
1536
+
1520
1537
  - 高い学習コスト
1521
1538
  - 複雑な設定
1522
1539
  - 運用の複雑さ
@@ -1547,11 +1564,13 @@ lambda3 --> db
1547
1564
  ```
1548
1565
 
1549
1566
  **メリット**:
1567
+
1550
1568
  - 完全なサーバー管理不要
1551
1569
  - 自動スケーリング
1552
1570
  - 従量課金
1553
1571
 
1554
1572
  **デメリット**:
1573
+
1555
1574
  - コールドスタート
1556
1575
  - ベンダーロックイン
1557
1576
  - ローカルテストの困難さ
@@ -2018,11 +2037,13 @@ lb --> blue2
2018
2037
  ```
2019
2038
 
2020
2039
  **メリット**:
2040
+
2021
2041
  - 即座にロールバック可能
2022
2042
  - ゼロダウンタイム
2023
2043
  - 本番環境での検証
2024
2044
 
2025
2045
  **デメリット**:
2046
+
2026
2047
  - リソースが2倍必要
2027
2048
  - データベース移行の複雑さ
2028
2049
 
@@ -2047,11 +2068,13 @@ lb --> canary : 25%
2047
2068
  ```
2048
2069
 
2049
2070
  **メリット**:
2071
+
2050
2072
  - リスク最小化
2051
2073
  - 段階的なロールアウト
2052
2074
  - 問題の早期発見
2053
2075
 
2054
2076
  **デメリット**:
2077
+
2055
2078
  - 複雑な管理
2056
2079
  - バージョン混在期間
2057
2080
 
@@ -614,11 +614,13 @@ public class UserTestFixture {
614
614
  ### リファクタリング実施のタイミング
615
615
 
616
616
  1. **Rule of Three(3回ルール)**
617
+
617
618
  - 1回目: そのまま実装
618
619
  - 2回目: 重複に気づくが我慢
619
620
  - 3回目: リファクタリング実施
620
621
 
621
622
  2. **コードの臭い(Code Smells)を検知したとき**
623
+
622
624
  - 長すぎるメソッド(20行以上)
623
625
  - 大きすぎるクラス(200行以上)
624
626
  - 長すぎるパラメータリスト(4個以上)
@@ -1279,21 +1279,25 @@ void 予約数に関係なく検索性能が一定(int reservationCount) {
1279
1279
  ### テスト戦略の要点
1280
1280
 
1281
1281
  1. **アーキテクチャに応じた適切な戦略選択**
1282
+
1282
1283
  - ドメインモデル → ピラミッド形テスト
1283
1284
  - アクティブレコード → ダイヤモンド形テスト
1284
1285
  - トランザクションスクリプト → 逆ピラミッド形テスト
1285
1286
 
1286
1287
  2. **TDD による品質向上**
1288
+
1287
1289
  - Red-Green-Refactor サイクル
1288
1290
  - テストファーストによる設計改善
1289
1291
  - 継続的なリファクタリング
1290
1292
 
1291
1293
  3. **効率的なテスト実行**
1294
+
1292
1295
  - 高速なフィードバックループ
1293
1296
  - 並列実行による時間短縮
1294
1297
  - CI/CD パイプラインとの統合
1295
1298
 
1296
1299
  4. **適切なテスト範囲**
1300
+
1297
1301
  - ドメイン層への重点的な投資
1298
1302
  - 外部依存の適切な分離
1299
1303
  - 実用的なカバレッジ目標
@@ -278,6 +278,7 @@ title ユースケース作成の段階的詳細化
278
278
  **なぜなら**: [ビジネス価値]
279
279
 
280
280
  **受入条件**:
281
+
281
282
  - [ ] [条件1]
282
283
  - [ ] [条件2]
283
284
  ```
@@ -509,14 +510,17 @@ note right of US3 : イテレーション単位の\nストーリーに分解
509
510
  ### イテレーション計画での利用
510
511
 
511
512
  1. **リリース計画時**
513
+
512
514
  - 要約レベルのユースケースで全体像を把握
513
515
  - 大まかな規模見積もり
514
516
 
515
517
  2. **イテレーション計画時**
518
+
516
519
  - ユーザー目的レベルをストーリーに分解
517
520
  - 詳細な見積もりと優先順位付け
518
521
 
519
522
  3. **実装時**
523
+
520
524
  - ユースケースを設計ガイドとして利用
521
525
  - 受入テストケースの基準
522
526
 
@@ -580,6 +584,7 @@ note bottom of TC : 各パスを網羅する\nテストケースを生成
580
584
  **テストパス**: 主成功シナリオ/拡張XX
581
585
 
582
586
  **事前条件**:
587
+
583
588
  - [システムの初期状態]
584
589
  - [必要なテストデータ]
585
590
 
@@ -588,11 +593,13 @@ note bottom of TC : 各パスを網羅する\nテストケースを生成
588
593
  2. [入力データ2]
589
594
 
590
595
  **期待結果**:
596
+
591
597
  - [期待される出力]
592
598
  - [期待される状態変化]
593
599
  - [期待される副作用]
594
600
 
595
601
  **事後条件**:
602
+
596
603
  - [システムの最終状態]
597
604
  ```
598
605
 
@@ -637,18 +644,22 @@ note bottom of good : ビジネス目的\n実装独立\n価値が明確
637
644
  ### ユースケース作成の原則
638
645
 
639
646
  1. **読みやすさ優先**
647
+
640
648
  - 完璧さより理解しやすさ
641
649
  - 自然な言葉で記述
642
650
 
643
651
  2. **段階的詳細化**
652
+
644
653
  - 広く浅くから始める
645
654
  - 必要に応じて深堀り
646
655
 
647
656
  3. **適切なレベル選択**
657
+
648
658
  - ユーザー目的を中心に
649
659
  - サブ機能は最小限に
650
660
 
651
661
  4. **XPとの統合**
662
+
652
663
  - ユーザーストーリーと連携
653
664
  - イテレーション計画で活用
654
665
  - テストケースの基準
@@ -235,8 +235,9 @@ state チームはコミットできるか <<choice>>
235
235
  #### デイリースタンドアップ
236
236
 
237
237
  毎日の進捗確認で以下を共有:
238
+
238
239
  - 昨日やったこと
239
- - 今日やること
240
+ - 今日やること
240
241
  - 障害・ブロッカー
241
242
 
242
243
  #### タスクボードの活用
@@ -1197,21 +1197,25 @@ groups:
1197
1197
  ### 非機能要件定義の要点
1198
1198
 
1199
1199
  1. **品質属性の明確化**
1200
+
1200
1201
  - ISO/IEC 25010 に基づく体系的な分類
1201
1202
  - 測定可能な目標値の設定
1202
1203
  - ステークホルダーとの合意形成
1203
1204
 
1204
1205
  2. **実装と検証の統合**
1206
+
1205
1207
  - アーキテクチャ設計への反映
1206
1208
  - 自動テストによる継続的検証
1207
1209
  - 運用監視との連携
1208
1210
 
1209
1211
  3. **継続的改善**
1212
+
1210
1213
  - 実運用データに基づく評価
1211
1214
  - ユーザーフィードバックの活用
1212
1215
  - 技術進歩に応じた要件見直し
1213
1216
 
1214
1217
  4. **リスク管理**
1218
+
1215
1219
  - 品質属性間のトレードオフの認識
1216
1220
  - 優先順位に基づく段階的実装
1217
1221
  - 早期の問題発見と対策
@@ -1219,11 +1223,13 @@ groups:
1219
1223
  ### 非機能要件がもたらす価値
1220
1224
 
1221
1225
  **短期的価値**:
1226
+
1222
1227
  - システムの安定性と信頼性の確保
1223
1228
  - ユーザー満足度の向上
1224
1229
  - 運用コストの削減
1225
1230
 
1226
1231
  **長期的価値**:
1232
+
1227
1233
  - 保守性による開発効率の維持
1228
1234
  - 拡張性による事業成長への対応
1229
1235
  - セキュリティによるリスク回避
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k2works/claude-code-booster",
3
- "version": "0.16.2",
3
+ "version": "0.18.0",
4
4
  "description": "AI Agent Development Support Tool",
5
5
  "main": "main.js",
6
6
  "bin": {