@k2works/claude-code-booster 1.12.0 → 2.0.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 (70) hide show
  1. package/bin/claude-code-booster +5 -7
  2. package/lib/assets/.claude/README.md +73 -19
  3. package/lib/assets/.claude/agents/xp-architect.md +250 -0
  4. package/lib/assets/.claude/agents/xp-executive.md +207 -0
  5. package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -0
  6. package/lib/assets/.claude/agents/xp-product-manager.md +245 -0
  7. package/lib/assets/.claude/agents/xp-programmer.md +268 -0
  8. package/lib/assets/.claude/agents/xp-project-manager.md +229 -0
  9. package/lib/assets/.claude/agents/xp-technical-writer.md +224 -0
  10. package/lib/assets/.claude/agents/xp-tester.md +265 -0
  11. package/lib/assets/.claude/agents/xp-user-representative.md +204 -0
  12. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +49 -57
  13. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +54 -58
  14. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +52 -74
  15. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +50 -53
  16. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +56 -56
  17. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +56 -109
  18. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +61 -57
  19. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +61 -57
  20. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +57 -55
  21. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +66 -67
  22. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +58 -56
  23. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +51 -57
  24. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +45 -60
  25. package/lib/assets/.claude/skills/creating-adr/SKILL.md +38 -40
  26. package/lib/assets/.claude/skills/developing-backend/SKILL.md +49 -55
  27. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +47 -50
  28. package/lib/assets/.claude/skills/developing-release/SKILL.md +60 -95
  29. package/lib/assets/.claude/skills/generating-slides/SKILL.md +58 -100
  30. package/lib/assets/.claude/skills/git-commit/SKILL.md +27 -52
  31. package/lib/assets/.claude/skills/killing-processes/SKILL.md +16 -70
  32. package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -0
  33. package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -0
  34. package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -0
  35. package/lib/assets/.claude/skills/{managing-docs → operating-docs}/SKILL.md +1 -1
  36. package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -0
  37. package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -0
  38. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +65 -95
  39. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +60 -155
  40. package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -0
  41. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +60 -119
  42. package/lib/assets/.claude/skills/planning-releases/SKILL.md +63 -168
  43. package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +62 -266
  44. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +49 -122
  45. package/lib/assets/CLAUDE.md +7 -2
  46. package/lib/assets/README.md +3 -34
  47. package/lib/assets/docs/development/index.md +14 -8
  48. package/lib/assets/docs/index.md +1 -0
  49. package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +640 -0
  50. package/lib/assets/docs/reference/index.md +1 -0
  51. package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -0
  52. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +69 -5
  53. package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1366 -0
  54. package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +634 -0
  55. package/lib/assets/docs/template//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/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +547 -0
  56. 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/350/250/210/347/224/273.md +123 -1
  57. package/lib/assets/docs/template//350/250/255/350/250/210.md +12 -2
  58. package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +688 -0
  59. package/lib/assets/gulpfile.js +2 -0
  60. package/lib/assets/mkdocs.yml +1 -0
  61. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -0
  62. package/lib/assets/ops/scripts/sonar_local.js +726 -0
  63. package/package.json +1 -1
  64. package/lib/assets/.claude/SKILLS_TEMPLATE.md +0 -100
  65. package/lib/assets/.claude/agents/roles/.gitkeep +0 -0
  66. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +0 -77
  67. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +0 -80
  68. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +0 -84
  69. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +0 -75
  70. package/lib/assets/.claude/skills/managing-operations/SKILL.md +0 -156
@@ -1,64 +1,42 @@
1
1
  ---
2
2
  name: developing-release
3
- description: アプリケーションのリリースワークフロー。品質ゲート、バージョンバンプ、CHANGELOG 生成、git commit + tag を一貫実行。リリース作業やバージョン管理時に使用。
3
+ description: アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
4
4
  ---
5
5
 
6
- # リリースワークフローガイド
6
+ # リリースワークフロー
7
7
 
8
- 品質ゲート → バージョンバンプ → CHANGELOG 生成 → git commit + tag を一貫して実行するリリースワークフローを支援します。
8
+ 品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。
9
9
 
10
- ## Instructions
10
+ リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。
11
11
 
12
- ### 1. 参照ドキュメント
12
+ ## 参照ドキュメント
13
13
 
14
- - @docs/reference/リリースガイド.md - リリースワークフロー全体
14
+ - @docs/reference/リリースガイド.md リリースワークフロー全体
15
15
 
16
- ### 2. リリースフロー
16
+ ## オプション
17
17
 
18
- リリースは以下の順序で実行します:
18
+ | オプション | 説明 |
19
+ |-----------|------|
20
+ | なし | ドライランを実行(デフォルト) |
21
+ | `--dry-run` | CHANGELOG プレビュー + バージョン計算 |
22
+ | `--patch` | パッチリリース(バグ修正) |
23
+ | `--minor` | マイナーリリース(新機能追加、後方互換あり) |
24
+ | `--major` | メジャーリリース(破壊的変更) |
25
+ | `--preflight` | 品質ゲートのみ実行 |
26
+ | `--deploy` | リリース + デプロイ(`--patch` / `--minor` / `--major` と併用) |
19
27
 
20
- 1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認
21
- 2. **リリース種別選択**: patch / minor / major を選択
22
- 3. **品質ゲート(preflight)**: 全チェックを通過
23
- 4. **リリース実行**: バージョンバンプ → CHANGELOG 生成 → commit + tag
24
- 5. **リモートプッシュ**: コミットとタグをプッシュ
25
- 6. **デプロイ**: 必要に応じて本番デプロイ
28
+ ## リリースフロー
26
29
 
27
- ### 3. オプション
30
+ 1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認する
31
+ 2. **リリース種別選択**: patch / minor / major を選択する
32
+ 3. **品質ゲート(preflight)**: 全チェックを通過する
33
+ 4. **リリース実行**: バージョンバンプ→CHANGELOG 生成→commit + tag
34
+ 5. **リモートプッシュ**: コミットとタグをプッシュする
35
+ 6. **デプロイ**: 必要に応じて本番デプロイを実行する
28
36
 
29
- - なし : ドライランを実行(デフォルト)
30
- - `--dry-run` : CHANGELOG プレビュー + バージョン計算
31
- - `--patch` : パッチリリース(バグ修正)
32
- - `--minor` : マイナーリリース(新機能追加、後方互換あり)
33
- - `--major` : メジャーリリース(破壊的変更)
34
- - `--preflight` : 品質ゲートのみ実行
35
- - `--deploy` : リリース + デプロイ(`--patch` / `--minor` / `--major` と併用)
37
+ ## 品質ゲート(preflight)
36
38
 
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
- リリース前に以下のチェックを直列実行します。全チェック通過が必須です:
39
+ リリース前に以下のチェックを直列実行する。全チェック通過が必須。
62
40
 
63
41
  | チェック | コマンド | 内容 |
64
42
  | :--- | :--- | :--- |
@@ -68,9 +46,9 @@ npm run release:deploy:patch
68
46
  | ビルド確認 | `release:preflight:build` | ビルド成功 |
69
47
  | E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
70
48
 
71
- ### 6. バージョニング規則
49
+ ## バージョニング規則
72
50
 
73
- [Semantic Versioning](https://semver.org/) に従います:
51
+ [Semantic Versioning](https://semver.org/) に従う。
74
52
 
75
53
  | 種類 | 変更例 | バージョン変化 |
76
54
  | :--- | :--- | :--- |
@@ -78,11 +56,11 @@ npm run release:deploy:patch
78
56
  | `minor` | 新機能追加(後方互換あり) | `0.1.0` → `0.2.0` |
79
57
  | `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
80
58
 
81
- モノレポ構成の場合、全パッケージのバージョンを同期管理します。
59
+ モノレポ構成の場合、全パッケージのバージョンを同期管理する。
82
60
 
83
- ### 7. CHANGELOG 生成ルール
61
+ ## CHANGELOG 生成ルール
84
62
 
85
- [Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成:
63
+ [Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成する。
86
64
 
87
65
  | prefix | カテゴリ |
88
66
  | :--- | :--- |
@@ -91,64 +69,51 @@ npm run release:deploy:patch
91
69
  | `docs` | Documentation |
92
70
  | `refactor` | Refactoring |
93
71
  | `test` | Tests |
94
- | `chore` | Chores |
95
- | `perf` | Performance |
96
- | `ci` | CI |
97
- | `style` | Styles |
98
- | `build` | Build |
72
+ | `chore` / `perf` / `ci` / `style` / `build` | その他 |
99
73
 
100
- - 直近の git tag から HEAD までのコミットを対象
101
- - タグが存在しない場合は全コミット履歴を対象
102
- - `CHANGELOG.md` の先頭に新しいエントリを追加
74
+ 直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。
103
75
 
104
- ### 8. リリース実行ステップ
76
+ ## リリース実行ステップ
105
77
 
106
78
  | ステップ | 内容 |
107
79
  | :--- | :--- |
108
- | [1/4] バージョン更新 | 対象パッケージのバージョンをセマンティックバージョニングに従って更新 |
109
- | [2/4] CHANGELOG 生成 | 直近タグから HEAD までのコミットを分類し CHANGELOG.md を生成 |
110
- | [3/4] git commit + tag | 変更ファイルをステージング → `release: vX.X.X` でコミット → `vX.X.X` タグ作成 |
80
+ | [1/4] バージョン更新 | セマンティックバージョニングに従って更新 |
81
+ | [2/4] CHANGELOG 生成 | コミットを分類し CHANGELOG.md を生成 |
82
+ | [3/4] git commit + tag | `release: vX.X.X` でコミット→`vX.X.X` タグ作成 |
111
83
  | [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
112
84
 
113
- ### 9. トラブルシューティング
114
-
115
- - **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行
116
- - **テスト失敗**: テストを修正してからリリースを再実行
117
- - **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
118
-
119
- ### 10. コンテキスト管理
85
+ ## 途中から再開
120
86
 
121
- 長時間のリリースセッションでは Context limit reached エラーを回避するため、タスクの区切りごとに `/compact` を実施してコンテキストを圧縮する。
87
+ リリース作業の途中から再開する場合は、現在の状態を確認する。
122
88
 
123
- **`/compact` を実施するタイミング**:
89
+ **Example:**
124
90
 
125
- - 品質ゲート(preflight)の実行が完了したとき
126
- - バージョンバンプと CHANGELOG 生成が完了したとき
127
- - リリースコミット・タグ作成が完了したとき
128
- - デプロイ完了後
91
+ ```
92
+ ユーザー: 「品質ゲートは通った。リリースを実行したい」
93
+ 回答: --preflight の結果を確認し、全チェック通過を検証する。
94
+ --patch / --minor / --major のいずれかでリリースを実行する。
95
+ ```
129
96
 
130
- **運用ルール**:
97
+ ## トラブルシューティング
131
98
 
132
- 1. `/compact` 実施前に、現在のリリース状態と次のステップをメモとして出力する
133
- 2. `/compact` 実施後、次のステップの作業を継続する
99
+ - **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行する
100
+ - **テスト失敗**: テストを修正してからリリースを再実行する
101
+ - **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
134
102
 
135
- ### 11. 注意事項
103
+ ## コンテキスト管理
136
104
 
137
- - **前提条件**: ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済み
138
- - **制限事項**: working tree がクリーンでないとリリース不可
139
- - **推奨事項**: リリース前に必ずドライランで内容を確認
105
+ 品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に `/compact` を実施する。
140
106
 
141
- ### 12. ベストプラクティス
107
+ ## 注意事項
142
108
 
143
- 1. **ドライランファースト**: 必ずドライランで CHANGELOG プレビューを確認してからリリース
144
- 2. **品質ゲート厳守**: preflight の全チェックを通過させてからリリース実行
145
- 3. **セマンティックバージョニング**: 変更内容に応じた適切なバージョン種別を選択
146
- 4. **Conventional Commits**: コミットメッセージを規約に従って記述し CHANGELOG の品質を確保
147
- 5. **段階的デプロイ**: リリースとデプロイを分離し、必要に応じてデプロイを実行
109
+ - ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること(前提条件)
110
+ - working tree がクリーンでないとリリース不可
111
+ - リリース前に必ずドライランで内容を確認する
112
+ - Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する
148
113
 
149
- ### 関連スキル
114
+ ## 関連スキル
150
115
 
151
- - `git-commit` : Conventional Commits 準拠のコミット作成
152
- - `managing-operations` : デプロイ・運用管理
153
- - `planning-releases` : リリース・イテレーション計画
154
- - `orchestrating-development` : 開発フェーズ全体のワークフロー(リリースはこのフェーズの最終工程)
116
+ - `git-commit` Conventional Commits 準拠のコミット作成
117
+ - `managing-operations` デプロイ・運用管理
118
+ - `planning-releases` リリース・イテレーション計画
119
+ - `orchestrating-development` 開発フェーズ全体のワークフロー
@@ -1,82 +1,64 @@
1
1
  ---
2
2
  name: generating-slides
3
- description: インセプションデッキの Markdown ドキュメントから PowerPoint スライド(.pptx)を生成。pptxgenjs を使用し、テンプレートのスライド構成・テーマに準拠した 12 枚構成のプレゼンテーションを出力。スライド生成やプレゼンテーション作成時に使用。
3
+ description: インセプションデッキの Markdown から PowerPoint スライド(.pptx)を自動生成。pptxgenjs を使用し、テンプレート準拠の 12 枚構成プレゼンテーションを出力する。「スライドを生成したい」「インセプションデッキの pptx を作りたい」「プレゼン資料を出力したい」「スライドを更新したい」といった場面で発動する。Markdown から自動生成することで、内容更新のたびに手動でスライドを作り直す手間を排除する。
4
4
  ---
5
5
 
6
6
  # スライド生成
7
7
 
8
- インセプションデッキの Markdown ドキュメントから、pptxgenjs を使用して PowerPoint スライド(.pptx)を生成します。テンプレート `docs/template/インセプションデッキ.pptx` のスライド構成に準拠した 12 枚構成のプレゼンテーションを出力します。
8
+ インセプションデッキの Markdown ドキュメントから pptxgenjs を使用して PowerPoint スライド(.pptx)を生成する。テンプレートのスライド構成・テーマに準拠した 12 枚構成のプレゼンテーションを出力する。
9
9
 
10
- ## Instructions
10
+ ## 参照ドキュメントと成果物
11
11
 
12
- ### 1. 参照ドキュメント
12
+ | 種類 | パス | 備考 |
13
+ |------|------|------|
14
+ | テンプレート | @docs/template/インセプションデッキ.pptx | スライド構成のリファレンス(15 枚、4:3) |
15
+ | 生成スクリプト | @.claude/scripts/generate-inception-deck.mjs | 内容の編集は可能 |
16
+ | 入力 | @docs/analysis/inception-deck.md | `analyzing-inception-deck` の成果物 |
17
+ | 入力(補足) | @docs/analysis/business_architecture.md | ビジネスアーキテクチャ分析書 |
18
+ | 成果物 | `docs/analysis/slide/xxxxx_v0.1.0.pptx` | 生成された PowerPoint スライド |
13
19
 
14
- - @docs/template/インセプションデッキ.pptx - スライド構成のリファレンス(15 枚構成、4:3、テーマカラー・フォント)
20
+ ## スライド構成(12 枚)
15
21
 
16
- ### 2. 生成スクリプト
17
-
18
- - @.claude/scripts/generate-inception-deck.mjs - スライド生成スクリプト(**内容の編集は可能**)
19
-
20
- ### 3. 入力
21
-
22
- - @docs/analysis/inception-deck.md - インセプションデッキ(`analyzing-inception-deck` の成果物)
23
- - @docs/analysis/business_architecture.md - ビジネスアーキテクチャ分析書(補足情報)
24
-
25
- ### 4. 成果物
26
-
27
- - @docs/analysis/slide/xxxxx_v0.1.0.pptx - 生成された PowerPoint スライド
28
-
29
- ### 5. 作業内容
30
-
31
- #### 前提条件の確認
32
-
33
- - Node.js がインストールされていること
34
- - `pptxgenjs` パッケージがインストールされていること(未インストール時は `npm install pptxgenjs`)
35
-
36
- #### スライド生成の実行
37
-
38
- ```bash
39
- node .claude/scripts/generate-inception-deck.mjs
40
- ```
41
-
42
- #### スライド構成(12 枚)
43
-
44
- テンプレートのインセプションデッキ構成に準拠した以下の 12 枚を生成する。
45
-
46
- | # | スライドタイトル | テンプレート対応 | データソース |
22
+ | # | スライドタイトル | SLIDE_DATA キー | データソース |
47
23
  | :--- | :--- | :--- | :--- |
48
- | 1 | タイトル | Slide 2: プロジェクト名 | プロジェクト基本情報 |
49
- | 2 | 我われはなぜここにいるのか | Slide 3: なぜここにいるのか | なぜやるのか? |
50
- | 3 | エレベーターピッチ | Slide 4: エレベーターピッチ | どんなビジョンなのか? |
51
- | 4 | どんな価値をもたらすのか? | Slide 5: パッケージデザイン | どんな価値をもたらすのか? |
52
- | 5 | やらないことリスト | Slide 6: やらないことリスト | スコープの範囲はどこか? |
53
- | 6 | プロジェクトコミュニティ | Slide 7: プロジェクトコミュニティ | 主なステークホルダーは? |
54
- | 7 | 技術的な解決策の概要 | Slide 8: 技術的な解決策 | 基本的な解決策 |
55
- | 8 | 夜も眠れなくなるような問題 | Slide 9: 夜も眠れない問題 | 主なリスクは何か? |
56
- | 9 | 俺たちの "A チーム" | Slide 10: A チーム | どのくらい作業があり費用はいくらか? |
57
- | 10 | 期間を見極める | Slide 11: 期間を見極める | 初回リリースはいつか? |
58
- | 11 | トレードオフ・スライダー | Slide 12: トレードオフ | トレードオフにどう向き合うか? |
59
- | 12 | 初回のリリースに必要なもの | Slide 13: 初回リリース | MVP スコープ・リリース戦略 |
60
-
61
- #### テーマ設定
24
+ | 1 | タイトル | `titleSlide` | プロジェクト基本情報 |
25
+ | 2 | 我われはなぜここにいるのか | `whyAreWeHere` | なぜやるのか? |
26
+ | 3 | エレベーターピッチ | `elevatorPitch` | どんなビジョンなのか? |
27
+ | 4 | どんな価値をもたらすのか? | `values` | どんな価値をもたらすのか? |
28
+ | 5 | やらないことリスト | `scope` | スコープの範囲はどこか? |
29
+ | 6 | プロジェクトコミュニティ | `stakeholders` | 主なステークホルダーは? |
30
+ | 7 | 技術的な解決策の概要 | `technicalSolution` | 基本的な解決策 |
31
+ | 8 | 夜も眠れなくなるような問題 | `risks` | 主なリスクは何か? |
32
+ | 9 | 俺たちの "A チーム" | `team` | どのくらい作業があり費用はいくらか? |
33
+ | 10 | 期間を見極める | `timeline` | 初回リリースはいつか? |
34
+ | 11 | トレードオフ・スライダー | `tradeoffs` | トレードオフにどう向き合うか? |
35
+ | 12 | 初回のリリースに必要なもの | `initialRelease` | MVP スコープ・リリース戦略 |
36
+
37
+ ## テーマ設定
62
38
 
63
39
  テンプレートから抽出したテーマに準拠する。
64
40
 
65
- - **フォント**: Yu Gothic(游ゴシック)— Windows / Mac 両対応の日本語フォント
41
+ - **フォント**: Yu Gothic(游ゴシック)— Windows / Mac 両対応
66
42
  - **テーマカラー**: ダークブルー `#333399`、ティール `#009999`、ライトティール `#BBE0E3`
67
43
  - **スライドサイズ**: 4:3(10" x 7.5")
68
44
 
69
- #### 生成スクリプトの更新
45
+ ## 生成の進め方
46
+
47
+ ### 新規生成
70
48
 
71
- inception-deck.md の内容が更新された場合、生成スクリプトの `SLIDE_DATA` オブジェクトを更新してから再実行する。
49
+ 1. `npm install pptxgenjs`(初回のみ)
50
+ 2. `docs/analysis/inception-deck.md` の内容を確認する
51
+ 3. `.claude/scripts/generate-inception-deck.mjs` の `SLIDE_DATA` をプロジェクト固有の内容に書き換える
52
+ 4. `node .claude/scripts/generate-inception-deck.mjs` を実行する
53
+ 5. `docs/analysis/slide/` に .pptx が生成されたことを確認する
72
54
 
73
- 1. @docs/analysis/inception-deck.md を読み込む
74
- 2. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` セクションを更新
75
- 3. `node .claude/scripts/generate-inception-deck.mjs` で再生成
55
+ ### 更新時の再生成
76
56
 
77
- #### スクリプト構成
57
+ 1. `docs/analysis/inception-deck.md` の更新内容を確認する
58
+ 2. `.claude/scripts/generate-inception-deck.mjs` の `SLIDE_DATA` を更新する
59
+ 3. `node .claude/scripts/generate-inception-deck.mjs` を実行する
78
60
 
79
- 生成スクリプトは以下の 4 セクションで構成されている。
61
+ ## スクリプト構成
80
62
 
81
63
  | セクション | 内容 | 編集対象 |
82
64
  | :--- | :--- | :--- |
@@ -85,52 +67,28 @@ inception-deck.md の内容が更新された場合、生成スクリプトの `
85
67
  | ヘルパー関数 | スライド部品の描画ロジック | 通常変更不要 |
86
68
  | スライド生成 | `SLIDE_DATA` を読み取り 12 枚を生成 | 通常変更不要 |
87
69
 
88
- `SLIDE_DATA` の各キーがスライドに対応している。
89
-
90
- | キー | 対応スライド |
91
- | :--- | :--- |
92
- | `meta` | メタ情報(author, title, version, date, outputFileName) |
93
- | `titleSlide` | Slide 1: タイトル |
94
- | `whyAreWeHere` | Slide 2: 我われはなぜここにいるのか |
95
- | `elevatorPitch` | Slide 3: エレベーターピッチ |
96
- | `values` | Slide 4: どんな価値をもたらすのか? |
97
- | `scope` | Slide 5: やらないことリスト |
98
- | `stakeholders` | Slide 6: プロジェクトコミュニティ |
99
- | `technicalSolution` | Slide 7: 技術的な解決策の概要 |
100
- | `risks` | Slide 8: 夜も眠れなくなるような問題 |
101
- | `team` | Slide 9: 俺たちの "A チーム" |
102
- | `timeline` | Slide 10: 期間を見極める |
103
- | `tradeoffs` | Slide 11: トレードオフ・スライダー |
104
- | `initialRelease` | Slide 12: 初回のリリースに必要なもの |
105
-
106
- #### バージョン管理
70
+ ## 途中から再開
107
71
 
108
- - 出力ファイル名は `SLIDE_DATA.meta.outputFileName` で指定する(例: `PROJECT_v0.1.0.pptx`)
109
- - `meta.title` と `meta.outputFileName` を同時に更新すること
72
+ スライドの一部を修正したい場合は、`SLIDE_DATA` の該当キーのみを更新して再生成する。
110
73
 
111
- ### 6. 注意事項
74
+ **Example:**
112
75
 
113
- - **前提条件**: @docs/analysis/inception-deck.md が作成済みであること(`analyzing-inception-deck` を先に実行)
114
- - **制限事項**: テンプレート @docs/template/インセプションデッキ.pptx は編集しないこと。日本語フォントは Yu Gothic を使用すること(Gill Sans 等の欧文フォントは文字化けする)
115
- - **推奨事項**: 生成後は PowerPoint で開いてレイアウトを目視確認し、必要に応じてスクリプトのレイアウトパラメータを微調整する
116
-
117
- ## Examples
118
-
119
- ### インセプションデッキのスライドを新規生成
120
-
121
- 1. `npm install pptxgenjs`(初回のみ)
122
- 2. @docs/analysis/inception-deck.md の内容を確認
123
- 3. @.claude/scripts/generate-inception-deck.mjs の `SLIDE_DATA` をプロジェクト固有の内容に書き換える
124
- 4. `node .claude/scripts/generate-inception-deck.mjs` を実行
125
- 5. @docs/analysis/slide/ に .pptx が生成されたことを確認
76
+ ```
77
+ ユーザー: 「エレベーターピッチの内容が変わった。スライドを更新したい」
78
+ 回答: inception-deck.md の更新内容を確認し、
79
+ SLIDE_DATA.elevatorPitch のみを更新して再生成する。
80
+ 出力ファイル名の meta.outputFileName のバージョンも更新する。
81
+ ```
126
82
 
127
- ### インセプションデッキ更新後のスライド再生成
83
+ ## 注意事項
128
84
 
129
- 1. @docs/analysis/inception-deck.md の更新内容を確認
130
- 2. @.claude/scripts/generate-inception-deck.mjs `SLIDE_DATA` を更新
131
- 3. `node .claude/scripts/generate-inception-deck.mjs` を実行
85
+ - `docs/analysis/inception-deck.md` が作成済みであること(`analyzing-inception-deck` を先に実行する)
86
+ - テンプレート `docs/template/インセプションデッキ.pptx` は編集しない
87
+ - 日本語フォントは Yu Gothic を使用する(Gill Sans 等の欧文フォントは文字化けする)
88
+ - 出力ファイル名は `SLIDE_DATA.meta.outputFileName` で指定する。`meta.title` と同時に更新する
89
+ - 生成後は PowerPoint で開いてレイアウトを目視確認し、必要に応じてスクリプトのレイアウトパラメータを微調整する
132
90
 
133
- ### 関連スキル
91
+ ## 関連スキル
134
92
 
135
- - `analyzing-inception-deck` : 入力となるインセプションデッキの作成
136
- - `analyzing-business` : ビジネスアーキテクチャ分析(補足情報の参照元)
93
+ - `analyzing-inception-deck` 入力となるインセプションデッキの作成
94
+ - `analyzing-business` ビジネスアーキテクチャ分析(補足情報の参照元)
@@ -1,47 +1,41 @@
1
1
  ---
2
2
  name: git-commit
3
- description: Git コミットのベストプラクティス。意味のある変更単位でのコミット、Conventional Commits ルール、コミットメッセージの書き方を定義。
3
+ description: Conventional Commits 準拠の Git コミットを作成。意味のある変更単位でステージングし、日本語で明確なコミットメッセージを記述する。「コミットしたい」「変更を保存したい」「コミットメッセージの書き方を知りたい」といった場面で発動する。コミット履歴を意味のある単位で保つことで、変更の追跡とロールバックを容易にする。
4
4
  ---
5
5
 
6
- # Git コミットガイドライン
6
+ # Git コミット
7
7
 
8
- 意味のある変更単位ごとにコミットを行うことは、コードの履歴を明確にし、将来の変更を追跡しやすくするために重要です。
8
+ 意味のある変更単位ごとにコミットを行う。コミット履歴はコードの「変更理由の記録」であり、将来の自分やチームメンバーが変更を追跡するための重要な情報源になる。
9
9
 
10
- ## Instructions
10
+ ## コミット手順
11
11
 
12
12
  ### 1. 変更を確認する
13
13
 
14
- まず、現在のワーキングディレクトリでの変更を確認します:
15
-
16
14
  ```bash
17
15
  git status
18
16
  ```
19
17
 
20
18
  ### 2. 変更をステージングする
21
19
 
22
- 変更をコミットする前に、ステージングエリアに追加する必要があります:
23
-
24
20
  ```bash
25
21
  git add 対象ファイルやディレクトリ
26
22
  ```
27
23
 
28
- **重要**:意味のある変更単位ごとにファイルを指定すること。無条件にすべての変更を追加しないでください。
29
-
30
- ### 3. コミットメッセージを作成する
24
+ 意味のある変更単位ごとにファイルを指定する。無条件にすべての変更を追加しない。
31
25
 
32
- コミットメッセージは、変更内容を簡潔に説明する重要な部分です:
26
+ ### 3. コミットする
33
27
 
34
28
  ```bash
35
- git commit -m "コミットメッセージをここに入力"
29
+ git commit -m "コミットメッセージ"
36
30
  ```
37
31
 
38
- #### コミットメッセージのルール
32
+ ### 4. コミットを確認する
39
33
 
40
- - コミットメッセージは日本語で記述
41
- - Conventional Commits のルールに従う
42
- - co-author やコミットメッセージに "Claude Code" のキーワードは含めない
34
+ ```bash
35
+ git log --oneline
36
+ ```
43
37
 
44
- #### Conventional Commits フォーマット
38
+ ## Conventional Commits フォーマット
45
39
 
46
40
  ```
47
41
  <type>(<scope>): <subject>
@@ -51,56 +45,37 @@ git commit -m "コミットメッセージをここに入力"
51
45
  <footer>
52
46
  ```
53
47
 
54
- **type の種類**:
55
- - `feat`: 新機能
56
- - `fix`: バグ修正
57
- - `docs`: ドキュメントのみの変更
58
- - `style`: コードの意味に影響しない変更(空白、フォーマット等)
59
- - `refactor`: バグ修正や機能追加ではないコード変更
60
- - `test`: テストの追加・修正
61
- - `chore`: ビルドプロセスやツールの変更
62
-
63
- ### 4. コミットを確認する
48
+ **type の種類**:
64
49
 
65
- コミットが正しく行われたかを確認:
66
-
67
- ```bash
68
- git log --oneline
69
- ```
50
+ | type | 用途 |
51
+ |------|------|
52
+ | `feat` | 新機能 |
53
+ | `fix` | バグ修正 |
54
+ | `docs` | ドキュメントのみの変更 |
55
+ | `style` | コードの意味に影響しない変更(空白、フォーマット等) |
56
+ | `refactor` | バグ修正や機能追加ではないコード変更 |
57
+ | `test` | テストの追加・修正 |
58
+ | `chore` | ビルドプロセスやツールの変更 |
70
59
 
71
60
  ## Examples
72
61
 
73
- ### 機能追加のコミット
74
-
75
62
  ```bash
76
63
  git add src/features/user-auth.ts
77
64
  git commit -m "feat(auth): ユーザー認証機能を追加"
78
- ```
79
65
 
80
- ### バグ修正のコミット
81
-
82
- ```bash
83
66
  git add src/utils/validation.ts
84
67
  git commit -m "fix(validation): メールアドレスのバリデーションエラーを修正"
85
- ```
86
68
 
87
- ### ドキュメント更新のコミット
88
-
89
- ```bash
90
69
  git add README.md docs/setup.md
91
70
  git commit -m "docs: セットアップ手順を更新"
92
- ```
93
71
 
94
- ### リファクタリングのコミット
95
-
96
- ```bash
97
72
  git add src/services/api.ts
98
73
  git commit -m "refactor(api): API クライアントの共通処理を抽出"
99
74
  ```
100
75
 
101
- ## ベストプラクティス
76
+ ## 注意事項
102
77
 
103
- - **1 コミット 1 目的**:構造変更と動作変更を同一コミットに含めない
104
- - **小さく頻繁に**:大きな変更は小さなコミットに分割
105
- - **テスト通過後にコミット**:壊れたコードをコミットしない
106
- - **明確なメッセージ**:何を、なぜ変更したかを簡潔に記述
78
+ - コミットメッセージは日本語で記述する。co-author やメッセージに "Claude Code" のキーワードは含めない
79
+ - 1 コミット 1 目的: 構造変更と動作変更を同一コミットに含めない
80
+ - 小さく頻繁に: 大きな変更は小さなコミットに分割する
81
+ - テスト通過後にコミットする。壊れたコードをコミットしない
@@ -1,98 +1,44 @@
1
1
  ---
2
2
  name: killing-processes
3
- description: 開発サーバーや Node.js プロセスを強制終了。ポート競合の解決やプロセスリセット時に使用。
3
+ description: 開発サーバーや Node.js プロセスを強制終了。ポート競合の解消やプロセスリセットに対応する。「プロセスを止めたい」「ポートが使われている」「開発サーバーを再起動したい」「Port already in use を解決したい」といった場面で発動する。
4
4
  ---
5
5
 
6
- # Kill Development Processes
6
+ # プロセス強制終了
7
7
 
8
- 開発サーバーや Node.js プロセスを強制終了するスキル。複数ポートで起動している開発プロセスを一括で停止できます。
8
+ 開発サーバーや Node.js プロセスを強制終了する。複数ポートで起動している開発プロセスを一括停止できる。
9
9
 
10
- ## Instructions
10
+ ## オプション
11
11
 
12
- ### 1. オプション
12
+ | オプション | 説明 |
13
+ |-----------|------|
14
+ | なし | すべての Node.js 開発プロセスを強制終了 |
15
+ | `--port <ポート番号>` | 特定のポートのプロセスのみ終了 |
16
+ | `--check` | プロセス状況の確認のみ(終了せず) |
13
17
 
14
- - なし : すべての Node.js 開発プロセスを強制終了
15
- - `--port <ポート番号>` : 特定のポートのプロセスのみ終了
16
- - `--check` : プロセス状況の確認のみ(終了せず)
17
-
18
- ### 2. 基本例
19
-
20
- ```bash
21
- # 全開発プロセスを強制終了
22
- # 「すべての Node.js 開発サーバー(npm run dev 等)を停止」
23
-
24
- # ポート 3000 番のプロセスのみ終了
25
- # --port 3000
26
- # 「ポート 3000 で動作中のプロセスを終了」
27
-
28
- # プロセス状況の確認
29
- # --check
30
- # 「現在起動中の開発プロセスを一覧表示」
31
- ```
32
-
33
- ### 3. 詳細機能
34
-
35
- #### 一括プロセス終了
36
-
37
- Windows 環境で複数の開発サーバーが起動している場合の一括終了処理。
18
+ ## 実行コマンド
38
19
 
39
20
  ```bash
40
21
  # ポート範囲でのプロセス検索・終了
41
22
  netstat -ano | findstr ":300[0-9]" | findstr LISTENING
42
- taskkill //F //PID <PID1> && taskkill //F //PID <PID2>
23
+ taskkill //F //PID <PID>
43
24
  ```
44
25
 
45
- #### 個別ポート指定終了
46
-
47
- 特定のポートで起動しているプロセスのみを終了する。
48
-
49
- - **安全性**: 指定ポートのみ終了で他に影響しない
50
- - **精密性**: 必要最小限のプロセス停止
51
- - **確認**: 終了前にプロセス情報を表示
52
-
53
- ### 4. 出力例
26
+ ## 出力例
54
27
 
55
28
  ```
56
29
  現在起動中の開発プロセス:
57
30
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
58
-
59
31
  ポート 3000: PID 34348 (Node.js)
60
32
  ポート 3001: PID 16676 (Node.js)
61
- ポート 3002: PID 25696 (Node.js)
62
33
 
63
34
  プロセス終了中...
64
35
  PID 34348 を終了しました
65
36
  PID 16676 を終了しました
66
- PID 25696 を終了しました
67
-
68
37
  すべての開発プロセスを停止しました。
69
38
  ```
70
39
 
71
- ### 5. 連携シナリオ
72
-
73
- ```bash
74
- # 開発中のエラー修正後にプロセスリセット
75
- npm run dev
76
- # 「エラーが発生」→ kill → 「全プロセス停止して再起動準備」
77
-
78
- # ポート競合の解決
79
- npm start
80
- # 「Port 3000 is already in use」→ kill --port 3000
81
-
82
- # 開発環境のクリーンアップ
83
- git checkout main
84
- # → kill → 「ブランチ切り替え前に開発プロセスをクリーンアップ」
85
- ```
86
-
87
- ### 6. 注意事項
88
-
89
- - **前提条件**: Windows 環境(taskkill コマンド使用)
90
- - **制限事項**: 管理者権限が必要な場合があります
91
- - **推奨事項**: 重要な作業中は事前にファイル保存を行う
92
-
93
- ### 7. ベストプラクティス
40
+ ## 注意事項
94
41
 
95
- 1. **安全な終了**: 作業中のファイルは事前に保存する
96
- 2. **段階的終了**: まず `--check` で状況確認してから終了
97
- 3. **ポート指定**: 必要に応じて特定ポートのみ終了
98
- 4. **再起動準備**: プロセス終了後は適切にサーバーを再起動
42
+ - Windows 環境(taskkill コマンド使用)が前提。管理者権限が必要な場合がある
43
+ - 重要な作業中は事前にファイルを保存する
44
+ - まず `--check` で状況確認してから終了する。必要に応じて `--port` で特定ポートのみ終了する