@k2works/claude-code-booster 1.4.1 → 1.5.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.
@@ -50,6 +50,7 @@ Claude Code をより効率的に使うための基本設定テンプレート
50
50
  | :--- | :--- |
51
51
  | `developing-backend` | バックエンド開発の TDD ワークフロー。インサイドアウトアプローチ。 |
52
52
  | `developing-frontend` | フロントエンド開発の TDD ワークフロー。アウトサイドインアプローチ。 |
53
+ | `developing-release` | リリースワークフロー。品質ゲート、バージョンバンプ、CHANGELOG 生成、git commit + tag。 |
53
54
 
54
55
  #### 計画・進捗系
55
56
 
@@ -130,6 +131,7 @@ Claude Code をより効率的に使うための基本設定テンプレート
130
131
  │ ├── analyzing-operation/SKILL.md
131
132
  │ ├── developing-backend/SKILL.md
132
133
  │ ├── developing-frontend/SKILL.md
134
+ │ ├── developing-release/SKILL.md
133
135
  │ ├── killing-processes/SKILL.md
134
136
  │ ├── managing-operations/
135
137
  │ │ ├── SKILL.md
@@ -1,4 +1,7 @@
1
1
  {
2
+ "env": {
3
+ "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
4
+ },
2
5
  "permissions": {
3
6
  "defaultMode": "plan",
4
7
  "allow": [],
@@ -0,0 +1,138 @@
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
+ - **前提条件**: ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済み
122
+ - **制限事項**: working tree がクリーンでないとリリース不可
123
+ - **推奨事項**: リリース前に必ずドライランで内容を確認
124
+
125
+ ### 11. ベストプラクティス
126
+
127
+ 1. **ドライランファースト**: 必ずドライランで CHANGELOG プレビューを確認してからリリース
128
+ 2. **品質ゲート厳守**: preflight の全チェックを通過させてからリリース実行
129
+ 3. **セマンティックバージョニング**: 変更内容に応じた適切なバージョン種別を選択
130
+ 4. **Conventional Commits**: コミットメッセージを規約に従って記述し CHANGELOG の品質を確保
131
+ 5. **段階的デプロイ**: リリースとデプロイを分離し、必要に応じてデプロイを実行
132
+
133
+ ### 関連スキル
134
+
135
+ - `git-commit` : Conventional Commits 準拠のコミット作成
136
+ - `managing-operations` : デプロイ・運用管理
137
+ - `planning-releases` : リリース・イテレーション計画
138
+ - `orchestrating-development` : 開発フェーズ全体のワークフロー(リリースはこのフェーズの最終工程)
@@ -66,7 +66,7 @@ description: 設計ドキュメントの一覧表示、進捗確認、内容参
66
66
 
67
67
  ### 4. ドキュメント更新機能
68
68
 
69
- `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` を自動更新できます。
69
+ `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` と 各ディレクトリの `index.md` を自動更新できます。
70
70
 
71
71
  **docs/index.md の更新内容**:
72
72
 
@@ -80,6 +80,11 @@ description: 設計ドキュメントの一覧表示、進捗確認、内容参
80
80
  - 要件定義、設計、開発、運用などのカテゴリで階層化
81
81
  - 新しいドキュメントを自動的にナビゲーションに追加
82
82
 
83
+ **各ディレクトリの index.md の更新内容**:
84
+
85
+ - ドキュメント一覧をカテゴリ別に整理
86
+ - 各ドキュメントへのリンクと説明を生成
87
+
83
88
  ### 5. Lint 機能
84
89
 
85
90
  `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
@@ -220,5 +220,6 @@ Claude の活動:
220
220
 
221
221
  - Skill: `developing-backend` : バックエンド開発ガイド
222
222
  - Skill: `developing-frontend` : フロントエンド開発ガイド
223
+ - Skill: `developing-release` : リリースワークフロー(品質ゲート・バージョン管理・CHANGELOG)
223
224
  - @docs/reference/CodexCLIMCPアプリケーション開発フロー.md : アプリケーション開発フロー
224
225
  - @docs/reference/CodexCLIMCPサーバー設定手順.md : Codex MCP サーバー設定手順
@@ -24,6 +24,7 @@
24
24
  | :--- | :--- |
25
25
  | `orchestrating-analysis` | 分析フェーズの全体ワークフロー |
26
26
  | `orchestrating-development` | 開発フェーズの TDD ワークフロー・Codex 分業 |
27
+ | `orchestrating-project` | 計画・進捗管理フェーズの全体ワークフロー |
27
28
 
28
29
  ### 分析
29
30
 
@@ -47,6 +48,7 @@
47
48
  | :--- | :--- |
48
49
  | `developing-backend` | バックエンド TDD(インサイドアウト) |
49
50
  | `developing-frontend` | フロントエンド TDD(アウトサイドイン) |
51
+ | `developing-release` | リリースワークフロー(品質ゲート・バージョン管理・CHANGELOG) |
50
52
 
51
53
  ### 計画・進捗
52
54
 
@@ -57,6 +57,7 @@ claude mcp add -s project codex -- npx @openai/codex mcp-server
57
57
  | | `analyzing-operation` | 運用要件定義 |
58
58
  | **開発** | `developing-backend` | バックエンド TDD(インサイドアウト) |
59
59
  | | `developing-frontend` | フロントエンド TDD(アウトサイドイン) |
60
+ | | `developing-release` | リリースワークフロー(品質ゲート・バージョン管理・CHANGELOG) |
60
61
  | **計画・進捗** | `planning-releases` | リリース・イテレーション計画 |
61
62
  | | `syncing-github-project` | GitHub Project 同期 |
62
63
  | | `tracking-progress` | 進捗分析・レポート生成 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k2works/claude-code-booster",
3
- "version": "1.4.1",
3
+ "version": "1.5.0",
4
4
  "description": "AI Agent Development Support Tool",
5
5
  "main": "main.js",
6
6
  "bin": {