@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.
- package/LICENSE +21 -21
- package/README.md +42 -42
- package/bin/claude-code-booster +79 -79
- package/lib/assets/.claude/README.md +162 -162
- package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -100
- package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
- package/lib/assets/.claude/settings.json +11 -11
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -87
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +117 -117
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -80
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -88
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +137 -137
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +89 -87
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -102
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -87
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -86
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -87
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -115
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +106 -106
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +96 -96
- package/lib/assets/.claude/skills/developing-release/SKILL.md +154 -154
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +136 -136
- package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -98
- package/lib/assets/.claude/skills/managing-docs/SKILL.md +200 -200
- package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -77
- package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -80
- package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -84
- package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -75
- package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -156
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +134 -134
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +243 -243
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +193 -193
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -222
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -164
- package/lib/assets/.devcontainer/devcontainer.json +34 -34
- package/lib/assets/.env.example +17 -17
- package/lib/assets/.gitattributes +4 -4
- package/lib/assets/.github/workflows/docker-publish.yml +77 -77
- package/lib/assets/.github/workflows/mkdocs.yml +39 -39
- package/lib/assets/AGENTS.md +94 -94
- package/lib/assets/CLAUDE.md +162 -162
- package/lib/assets/README.md +285 -269
- package/lib/assets/docker-compose.yml +33 -33
- package/lib/assets/docs/assets/css/extra.css +29 -29
- package/lib/assets/docs/assets/js/extra.js +44 -44
- package/lib/assets/docs/index.md +14 -14
- 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
- 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
- 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
- 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
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +448 -448
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
- 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
- package/lib/assets/docs/template/ADR.md +30 -30
- package/lib/assets/docs/template/README.md +50 -50
- 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
- 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
- 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
- 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
- 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
- package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
- package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
- package/lib/assets/gulpfile.js +23 -23
- package/lib/assets/mkdocs.yml +65 -65
- package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
- package/lib/assets/ops/scripts/journal.js +180 -180
- package/lib/assets/ops/scripts/mkdocs.js +82 -82
- package/lib/assets/ops/scripts/release.js +431 -431
- package/lib/assets/ops/scripts/ssh.js +190 -190
- package/lib/assets/ops/scripts/vault.js +299 -299
- package/lib/assets/package-lock.json +1653 -1653
- package/lib/assets/package.json +40 -40
- package/lib/gulpfile.js +37 -37
- 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` : 開発フェーズ全体のワークフロー(リリースはこのフェーズの最終工程)
|