@k2works/claude-code-booster 1.10.0 → 1.11.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 (93) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +42 -42
  3. package/bin/claude-code-booster +79 -79
  4. package/lib/assets/.claude/README.md +162 -162
  5. package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -100
  6. package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
  7. package/lib/assets/.claude/settings.json +11 -11
  8. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
  9. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -87
  10. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +117 -117
  11. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -80
  12. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -88
  13. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +137 -137
  14. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -91
  15. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -91
  16. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +89 -87
  17. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -102
  18. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -87
  19. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -86
  20. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -87
  21. package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -115
  22. package/lib/assets/.claude/skills/developing-backend/SKILL.md +106 -106
  23. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +96 -96
  24. package/lib/assets/.claude/skills/developing-release/SKILL.md +154 -154
  25. package/lib/assets/.claude/skills/generating-slides/SKILL.md +136 -136
  26. package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
  27. package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -98
  28. package/lib/assets/.claude/skills/managing-docs/SKILL.md +200 -200
  29. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -77
  30. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -80
  31. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -84
  32. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -75
  33. package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -156
  34. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +134 -134
  35. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +243 -243
  36. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +193 -193
  37. package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -222
  38. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -164
  39. package/lib/assets/.devcontainer/devcontainer.json +34 -34
  40. package/lib/assets/.env.example +17 -17
  41. package/lib/assets/.gitattributes +4 -4
  42. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  43. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  44. package/lib/assets/AGENTS.md +94 -94
  45. package/lib/assets/CLAUDE.md +162 -162
  46. package/lib/assets/README.md +285 -269
  47. package/lib/assets/docker-compose.yml +33 -33
  48. package/lib/assets/docs/assets/css/extra.css +29 -29
  49. package/lib/assets/docs/assets/js/extra.js +44 -44
  50. package/lib/assets/docs/index.md +14 -14
  51. package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +532 -532
  52. 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 +341 -341
  53. 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 +578 -578
  54. 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 +465 -465
  55. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +448 -448
  56. package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +242 -242
  57. 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 +2216 -2216
  58. package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
  59. package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +554 -554
  60. 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 +705 -705
  61. 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 +1313 -1313
  62. package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
  63. package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
  64. package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
  65. 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 +682 -682
  66. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +442 -442
  67. 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 +558 -558
  68. package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +663 -663
  69. package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
  70. package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
  71. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
  72. 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 +1236 -1236
  73. package/lib/assets/docs/template/ADR.md +30 -30
  74. package/lib/assets/docs/template/README.md +50 -50
  75. package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
  76. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
  77. package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
  78. package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
  79. package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +68 -68
  80. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  81. package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
  82. package/lib/assets/gulpfile.js +23 -23
  83. package/lib/assets/mkdocs.yml +65 -65
  84. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  85. package/lib/assets/ops/scripts/journal.js +180 -180
  86. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  87. package/lib/assets/ops/scripts/release.js +431 -431
  88. package/lib/assets/ops/scripts/ssh.js +190 -190
  89. package/lib/assets/ops/scripts/vault.js +299 -299
  90. package/lib/assets/package-lock.json +1653 -1653
  91. package/lib/assets/package.json +40 -40
  92. package/lib/gulpfile.js +37 -37
  93. package/package.json +41 -41
@@ -1,96 +1,96 @@
1
- ---
2
- name: developing-frontend
3
- description: フロントエンド開発の TDD ワークフロー。Red-Green-Refactor サイクル、アウトサイドインアプローチ、コンポーネント設計。React/TypeScript のフロントエンド実装時に使用。
4
- ---
5
-
6
- # フロントエンド開発ガイド
7
-
8
- TDD サイクルに従ったフロントエンド開発を支援します。
9
-
10
- ## Instructions
11
-
12
- ### 1. 参照ドキュメント
13
-
14
- - @docs/reference/コーディングとテストガイド.md - ワークフロー
15
- - @docs/design/architecture_frontend.md - フロントエンドアーキテクチャ
16
- - @docs/design/ui-design.md - UI 設計
17
- - @docs/design/tech_stack.md - 技術スタック
18
- - @docs/design/test_strategy.md - テスト戦略
19
-
20
- ### 2. TDD サイクルの実践
21
-
22
- Red-Green-Refactor サイクルを厳密に実行:
23
-
24
- 1. **Red フェーズ**: 失敗するテストを最初に書く
25
- 2. **Green フェーズ**: テストを通す最小限のコードを実装
26
- 3. **Refactor フェーズ**: 重複を除去し設計を改善
27
-
28
- ### 3. アプローチ戦略の選択
29
-
30
- - **アウトサイドイン**: UI から開始しロジックを段階的に実装(推奨)
31
- - **インサイドアウト**: ユーティリティ/hooks から開始し上位層へ展開
32
-
33
- ### 4. テストコマンド
34
-
35
- ```bash
36
- # 全テスト実行
37
- cd apps/frontend && npm run test
38
-
39
- # ウォッチモードでテスト実行
40
- cd apps/frontend && npm run test:watch
41
-
42
- # テストカバレッジ確認
43
- cd apps/frontend && npm run test:coverage
44
-
45
- # E2E テスト実行
46
- cd apps/frontend && npm run test:e2e
47
- ```
48
-
49
- ### 5. 品質チェックリスト
50
-
51
- - [ ] すべてのテストがパス
52
- - [ ] ESLint の警告がゼロ
53
- - [ ] テストカバレッジが目標を満たしている
54
- - [ ] 単一の論理的作業単位を表現
55
- - [ ] コミットメッセージが変更内容を明確に説明
56
-
57
- ### 6. コンテキスト管理
58
-
59
- 長時間の開発セッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
60
-
61
- **`/compact` を実施するタイミング**:
62
-
63
- - TDD サイクル(Red-Green-Refactor)を数回繰り返した後
64
- - コンポーネント 1 件の実装が完了したとき
65
- - コミット完了後、次のタスクに着手する前
66
- - テストスイートの実行と結果確認が完了したとき
67
-
68
- **運用ルール**:
69
-
70
- 1. `/compact` 実施前に、現在の作業状態と次のタスクをメモとして出力する
71
- 2. `/compact` 実施後、次のタスクの作業を継続する
72
- 3. 大規模なユーザーストーリーでは、サブタスクごとに `/compact` を検討する
73
-
74
- ### 7. 注意事項
75
-
76
- - **前提条件**: Node.js/npm のテスト環境が設定済みであること
77
- - **制限事項**: TDD の三原則を厳密に守る(テストなしでプロダクションコードを書かない)
78
- - **推奨事項**: コミット前に必ず品質チェックリストを実行
79
- - 作業完了後に対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
80
-
81
- ## Examples
82
-
83
- ### 新コンポーネントの TDD 実装
84
-
85
- 1. 失敗するテストを書く(Red)
86
- 2. テストを通す最小限のコードを実装(Green)
87
- 3. 重複を排除し設計を改善(Refactor)
88
- 4. 品質チェックリストを実行してコミット
89
-
90
- ### ベストプラクティス
91
-
92
- 1. **TODO 駆動開発**: タスクを細かい TODO に分割してから実装開始
93
- 2. **小さなサイクル**: Red-Green-Refactor を 10-15 分で完了させる
94
- 3. **継続的コミット**: 各サイクル完了時に動作する状態でコミット
95
- 4. **Rule of Three**: 同じコードが 3 回現れたらリファクタリング
96
- 5. **コンポーネント分割**: 単一責任の原則に従いコンポーネントを小さく保つ
1
+ ---
2
+ name: developing-frontend
3
+ description: フロントエンド開発の TDD ワークフロー。Red-Green-Refactor サイクル、アウトサイドインアプローチ、コンポーネント設計。React/TypeScript のフロントエンド実装時に使用。
4
+ ---
5
+
6
+ # フロントエンド開発ガイド
7
+
8
+ TDD サイクルに従ったフロントエンド開発を支援します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. 参照ドキュメント
13
+
14
+ - @docs/reference/コーディングとテストガイド.md - ワークフロー
15
+ - @docs/design/architecture_frontend.md - フロントエンドアーキテクチャ
16
+ - @docs/design/ui-design.md - UI 設計
17
+ - @docs/design/tech_stack.md - 技術スタック
18
+ - @docs/design/test_strategy.md - テスト戦略
19
+
20
+ ### 2. TDD サイクルの実践
21
+
22
+ Red-Green-Refactor サイクルを厳密に実行:
23
+
24
+ 1. **Red フェーズ**: 失敗するテストを最初に書く
25
+ 2. **Green フェーズ**: テストを通す最小限のコードを実装
26
+ 3. **Refactor フェーズ**: 重複を除去し設計を改善
27
+
28
+ ### 3. アプローチ戦略の選択
29
+
30
+ - **アウトサイドイン**: UI から開始しロジックを段階的に実装(推奨)
31
+ - **インサイドアウト**: ユーティリティ/hooks から開始し上位層へ展開
32
+
33
+ ### 4. テストコマンド
34
+
35
+ ```bash
36
+ # 全テスト実行
37
+ cd apps/frontend && npm run test
38
+
39
+ # ウォッチモードでテスト実行
40
+ cd apps/frontend && npm run test:watch
41
+
42
+ # テストカバレッジ確認
43
+ cd apps/frontend && npm run test:coverage
44
+
45
+ # E2E テスト実行
46
+ cd apps/frontend && npm run test:e2e
47
+ ```
48
+
49
+ ### 5. 品質チェックリスト
50
+
51
+ - [ ] すべてのテストがパス
52
+ - [ ] ESLint の警告がゼロ
53
+ - [ ] テストカバレッジが目標を満たしている
54
+ - [ ] 単一の論理的作業単位を表現
55
+ - [ ] コミットメッセージが変更内容を明確に説明
56
+
57
+ ### 6. コンテキスト管理
58
+
59
+ 長時間の開発セッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
60
+
61
+ **`/compact` を実施するタイミング**:
62
+
63
+ - TDD サイクル(Red-Green-Refactor)を数回繰り返した後
64
+ - コンポーネント 1 件の実装が完了したとき
65
+ - コミット完了後、次のタスクに着手する前
66
+ - テストスイートの実行と結果確認が完了したとき
67
+
68
+ **運用ルール**:
69
+
70
+ 1. `/compact` 実施前に、現在の作業状態と次のタスクをメモとして出力する
71
+ 2. `/compact` 実施後、次のタスクの作業を継続する
72
+ 3. 大規模なユーザーストーリーでは、サブタスクごとに `/compact` を検討する
73
+
74
+ ### 7. 注意事項
75
+
76
+ - **前提条件**: Node.js/npm のテスト環境が設定済みであること
77
+ - **制限事項**: TDD の三原則を厳密に守る(テストなしでプロダクションコードを書かない)
78
+ - **推奨事項**: コミット前に必ず品質チェックリストを実行
79
+ - 作業完了後に対象のイテレーション @docs/development/iteration_plan-N.md の進捗を更新する
80
+
81
+ ## Examples
82
+
83
+ ### 新コンポーネントの TDD 実装
84
+
85
+ 1. 失敗するテストを書く(Red)
86
+ 2. テストを通す最小限のコードを実装(Green)
87
+ 3. 重複を排除し設計を改善(Refactor)
88
+ 4. 品質チェックリストを実行してコミット
89
+
90
+ ### ベストプラクティス
91
+
92
+ 1. **TODO 駆動開発**: タスクを細かい TODO に分割してから実装開始
93
+ 2. **小さなサイクル**: Red-Green-Refactor を 10-15 分で完了させる
94
+ 3. **継続的コミット**: 各サイクル完了時に動作する状態でコミット
95
+ 4. **Rule of Three**: 同じコードが 3 回現れたらリファクタリング
96
+ 5. **コンポーネント分割**: 単一責任の原則に従いコンポーネントを小さく保つ
@@ -1,154 +1,154 @@
1
- ---
2
- name: developing-release
3
- description: アプリケーションのリリースワークフロー。品質ゲート、バージョンバンプ、CHANGELOG 生成、git commit + tag を一貫実行。リリース作業やバージョン管理時に使用。
4
- ---
5
-
6
- # リリースワークフローガイド
7
-
8
- 品質ゲート → バージョンバンプ → CHANGELOG 生成 → git commit + tag を一貫して実行するリリースワークフローを支援します。
9
-
10
- ## Instructions
11
-
12
- ### 1. 参照ドキュメント
13
-
14
- - @docs/reference/リリースガイド.md - リリースワークフロー全体
15
-
16
- ### 2. リリースフロー
17
-
18
- リリースは以下の順序で実行します:
19
-
20
- 1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認
21
- 2. **リリース種別選択**: patch / minor / major を選択
22
- 3. **品質ゲート(preflight)**: 全チェックを通過
23
- 4. **リリース実行**: バージョンバンプ → CHANGELOG 生成 → commit + tag
24
- 5. **リモートプッシュ**: コミットとタグをプッシュ
25
- 6. **デプロイ**: 必要に応じて本番デプロイ
26
-
27
- ### 3. オプション
28
-
29
- - なし : ドライランを実行(デフォルト)
30
- - `--dry-run` : CHANGELOG プレビュー + バージョン計算
31
- - `--patch` : パッチリリース(バグ修正)
32
- - `--minor` : マイナーリリース(新機能追加、後方互換あり)
33
- - `--major` : メジャーリリース(破壊的変更)
34
- - `--preflight` : 品質ゲートのみ実行
35
- - `--deploy` : リリース + デプロイ(`--patch` / `--minor` / `--major` と併用)
36
-
37
- ### 4. 基本例
38
-
39
- ```bash
40
- # ドライラン(プレビュー)
41
- npm run release:dry-run
42
-
43
- # パッチリリース
44
- npm run release:patch
45
-
46
- # マイナーリリース
47
- npm run release:minor
48
-
49
- # メジャーリリース
50
- npm run release:major
51
-
52
- # 品質ゲートのみ実行
53
- npm run release:preflight
54
-
55
- # パッチリリース + デプロイ
56
- npm run release:deploy:patch
57
- ```
58
-
59
- ### 5. 品質ゲート(preflight)
60
-
61
- リリース前に以下のチェックを直列実行します。全チェック通過が必須です:
62
-
63
- | チェック | コマンド | 内容 |
64
- | :--- | :--- | :--- |
65
- | working tree クリーン | `release:preflight:clean` | 未コミット変更がないこと |
66
- | 静的解析 | `release:preflight:lint` | lint エラーがないこと |
67
- | ユニットテスト | `release:preflight:test` | 全テストパス |
68
- | ビルド確認 | `release:preflight:build` | ビルド成功 |
69
- | E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
70
-
71
- ### 6. バージョニング規則
72
-
73
- [Semantic Versioning](https://semver.org/) に従います:
74
-
75
- | 種類 | 変更例 | バージョン変化 |
76
- | :--- | :--- | :--- |
77
- | `patch` | バグ修正、軽微な改善 | `0.1.0` → `0.1.1` |
78
- | `minor` | 新機能追加(後方互換あり) | `0.1.0` → `0.2.0` |
79
- | `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
80
-
81
- モノレポ構成の場合、全パッケージのバージョンを同期管理します。
82
-
83
- ### 7. CHANGELOG 生成ルール
84
-
85
- [Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成:
86
-
87
- | prefix | カテゴリ |
88
- | :--- | :--- |
89
- | `feat` | Features |
90
- | `fix` | Bug Fixes |
91
- | `docs` | Documentation |
92
- | `refactor` | Refactoring |
93
- | `test` | Tests |
94
- | `chore` | Chores |
95
- | `perf` | Performance |
96
- | `ci` | CI |
97
- | `style` | Styles |
98
- | `build` | Build |
99
-
100
- - 直近の git tag から HEAD までのコミットを対象
101
- - タグが存在しない場合は全コミット履歴を対象
102
- - `CHANGELOG.md` の先頭に新しいエントリを追加
103
-
104
- ### 8. リリース実行ステップ
105
-
106
- | ステップ | 内容 |
107
- | :--- | :--- |
108
- | [1/4] バージョン更新 | 対象パッケージのバージョンをセマンティックバージョニングに従って更新 |
109
- | [2/4] CHANGELOG 生成 | 直近タグから HEAD までのコミットを分類し CHANGELOG.md を生成 |
110
- | [3/4] git commit + tag | 変更ファイルをステージング → `release: vX.X.X` でコミット → `vX.X.X` タグ作成 |
111
- | [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
112
-
113
- ### 9. トラブルシューティング
114
-
115
- - **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行
116
- - **テスト失敗**: テストを修正してからリリースを再実行
117
- - **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
118
-
119
- ### 10. コンテキスト管理
120
-
121
- 長時間のリリースセッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
122
-
123
- **`/compact` を実施するタイミング**:
124
-
125
- - 品質ゲート(preflight)の実行が完了したとき
126
- - バージョンバンプと CHANGELOG 生成が完了したとき
127
- - リリースコミット・タグ作成が完了したとき
128
- - デプロイ完了後
129
-
130
- **運用ルール**:
131
-
132
- 1. `/compact` 実施前に、現在のリリース状態と次のステップをメモとして出力する
133
- 2. `/compact` 実施後、次のステップの作業を継続する
134
-
135
- ### 11. 注意事項
136
-
137
- - **前提条件**: ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済み
138
- - **制限事項**: working tree がクリーンでないとリリース不可
139
- - **推奨事項**: リリース前に必ずドライランで内容を確認
140
-
141
- ### 12. ベストプラクティス
142
-
143
- 1. **ドライランファースト**: 必ずドライランで CHANGELOG プレビューを確認してからリリース
144
- 2. **品質ゲート厳守**: preflight の全チェックを通過させてからリリース実行
145
- 3. **セマンティックバージョニング**: 変更内容に応じた適切なバージョン種別を選択
146
- 4. **Conventional Commits**: コミットメッセージを規約に従って記述し CHANGELOG の品質を確保
147
- 5. **段階的デプロイ**: リリースとデプロイを分離し、必要に応じてデプロイを実行
148
-
149
- ### 関連スキル
150
-
151
- - `git-commit` : Conventional Commits 準拠のコミット作成
152
- - `managing-operations` : デプロイ・運用管理
153
- - `planning-releases` : リリース・イテレーション計画
154
- - `orchestrating-development` : 開発フェーズ全体のワークフロー(リリースはこのフェーズの最終工程)
1
+ ---
2
+ name: developing-release
3
+ description: アプリケーションのリリースワークフロー。品質ゲート、バージョンバンプ、CHANGELOG 生成、git commit + tag を一貫実行。リリース作業やバージョン管理時に使用。
4
+ ---
5
+
6
+ # リリースワークフローガイド
7
+
8
+ 品質ゲート → バージョンバンプ → CHANGELOG 生成 → git commit + tag を一貫して実行するリリースワークフローを支援します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. 参照ドキュメント
13
+
14
+ - @docs/reference/リリースガイド.md - リリースワークフロー全体
15
+
16
+ ### 2. リリースフロー
17
+
18
+ リリースは以下の順序で実行します:
19
+
20
+ 1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認
21
+ 2. **リリース種別選択**: patch / minor / major を選択
22
+ 3. **品質ゲート(preflight)**: 全チェックを通過
23
+ 4. **リリース実行**: バージョンバンプ → CHANGELOG 生成 → commit + tag
24
+ 5. **リモートプッシュ**: コミットとタグをプッシュ
25
+ 6. **デプロイ**: 必要に応じて本番デプロイ
26
+
27
+ ### 3. オプション
28
+
29
+ - なし : ドライランを実行(デフォルト)
30
+ - `--dry-run` : CHANGELOG プレビュー + バージョン計算
31
+ - `--patch` : パッチリリース(バグ修正)
32
+ - `--minor` : マイナーリリース(新機能追加、後方互換あり)
33
+ - `--major` : メジャーリリース(破壊的変更)
34
+ - `--preflight` : 品質ゲートのみ実行
35
+ - `--deploy` : リリース + デプロイ(`--patch` / `--minor` / `--major` と併用)
36
+
37
+ ### 4. 基本例
38
+
39
+ ```bash
40
+ # ドライラン(プレビュー)
41
+ npm run release:dry-run
42
+
43
+ # パッチリリース
44
+ npm run release:patch
45
+
46
+ # マイナーリリース
47
+ npm run release:minor
48
+
49
+ # メジャーリリース
50
+ npm run release:major
51
+
52
+ # 品質ゲートのみ実行
53
+ npm run release:preflight
54
+
55
+ # パッチリリース + デプロイ
56
+ npm run release:deploy:patch
57
+ ```
58
+
59
+ ### 5. 品質ゲート(preflight)
60
+
61
+ リリース前に以下のチェックを直列実行します。全チェック通過が必須です:
62
+
63
+ | チェック | コマンド | 内容 |
64
+ | :--- | :--- | :--- |
65
+ | working tree クリーン | `release:preflight:clean` | 未コミット変更がないこと |
66
+ | 静的解析 | `release:preflight:lint` | lint エラーがないこと |
67
+ | ユニットテスト | `release:preflight:test` | 全テストパス |
68
+ | ビルド確認 | `release:preflight:build` | ビルド成功 |
69
+ | E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
70
+
71
+ ### 6. バージョニング規則
72
+
73
+ [Semantic Versioning](https://semver.org/) に従います:
74
+
75
+ | 種類 | 変更例 | バージョン変化 |
76
+ | :--- | :--- | :--- |
77
+ | `patch` | バグ修正、軽微な改善 | `0.1.0` → `0.1.1` |
78
+ | `minor` | 新機能追加(後方互換あり) | `0.1.0` → `0.2.0` |
79
+ | `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
80
+
81
+ モノレポ構成の場合、全パッケージのバージョンを同期管理します。
82
+
83
+ ### 7. CHANGELOG 生成ルール
84
+
85
+ [Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成:
86
+
87
+ | prefix | カテゴリ |
88
+ | :--- | :--- |
89
+ | `feat` | Features |
90
+ | `fix` | Bug Fixes |
91
+ | `docs` | Documentation |
92
+ | `refactor` | Refactoring |
93
+ | `test` | Tests |
94
+ | `chore` | Chores |
95
+ | `perf` | Performance |
96
+ | `ci` | CI |
97
+ | `style` | Styles |
98
+ | `build` | Build |
99
+
100
+ - 直近の git tag から HEAD までのコミットを対象
101
+ - タグが存在しない場合は全コミット履歴を対象
102
+ - `CHANGELOG.md` の先頭に新しいエントリを追加
103
+
104
+ ### 8. リリース実行ステップ
105
+
106
+ | ステップ | 内容 |
107
+ | :--- | :--- |
108
+ | [1/4] バージョン更新 | 対象パッケージのバージョンをセマンティックバージョニングに従って更新 |
109
+ | [2/4] CHANGELOG 生成 | 直近タグから HEAD までのコミットを分類し CHANGELOG.md を生成 |
110
+ | [3/4] git commit + tag | 変更ファイルをステージング → `release: vX.X.X` でコミット → `vX.X.X` タグ作成 |
111
+ | [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
112
+
113
+ ### 9. トラブルシューティング
114
+
115
+ - **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行
116
+ - **テスト失敗**: テストを修正してからリリースを再実行
117
+ - **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
118
+
119
+ ### 10. コンテキスト管理
120
+
121
+ 長時間のリリースセッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
122
+
123
+ **`/compact` を実施するタイミング**:
124
+
125
+ - 品質ゲート(preflight)の実行が完了したとき
126
+ - バージョンバンプと CHANGELOG 生成が完了したとき
127
+ - リリースコミット・タグ作成が完了したとき
128
+ - デプロイ完了後
129
+
130
+ **運用ルール**:
131
+
132
+ 1. `/compact` 実施前に、現在のリリース状態と次のステップをメモとして出力する
133
+ 2. `/compact` 実施後、次のステップの作業を継続する
134
+
135
+ ### 11. 注意事項
136
+
137
+ - **前提条件**: ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済み
138
+ - **制限事項**: working tree がクリーンでないとリリース不可
139
+ - **推奨事項**: リリース前に必ずドライランで内容を確認
140
+
141
+ ### 12. ベストプラクティス
142
+
143
+ 1. **ドライランファースト**: 必ずドライランで CHANGELOG プレビューを確認してからリリース
144
+ 2. **品質ゲート厳守**: preflight の全チェックを通過させてからリリース実行
145
+ 3. **セマンティックバージョニング**: 変更内容に応じた適切なバージョン種別を選択
146
+ 4. **Conventional Commits**: コミットメッセージを規約に従って記述し CHANGELOG の品質を確保
147
+ 5. **段階的デプロイ**: リリースとデプロイを分離し、必要に応じてデプロイを実行
148
+
149
+ ### 関連スキル
150
+
151
+ - `git-commit` : Conventional Commits 準拠のコミット作成
152
+ - `managing-operations` : デプロイ・運用管理
153
+ - `planning-releases` : リリース・イテレーション計画
154
+ - `orchestrating-development` : 開発フェーズ全体のワークフロー(リリースはこのフェーズの最終工程)