@k2works/claude-code-booster 3.6.0 → 3.7.0

package/lib/assets/.claude/skills/developing-frontend/SKILL.md

@@ -1,93 +1,93 @@
----
-name: developing-frontend
-description: フロントエンド開発の TDD ワークフローを支援。Red-Green-Refactor サイクルとアウトサイドインアプローチで品質の高い UI を実装する。「フロントエンドを実装したい」「画面を作りたい」「コンポーネントを追加したい」「フロントエンドのテストを書きたい」といった場面で発動する。TDD で開発することで、UI の振る舞いを自動テストで保証し、安全なリファクタリングを可能にする。
----
-
-# フロントエンド開発
-
-TDD サイクルに従いフロントエンドを開発する。アウトサイドインアプローチ（UI 層→ロジック層→データ層）で、ユーザー視点から内側へ段階的に構築する。
-
-アウトサイドインの利点は、ユーザーが実際に操作する画面から始めるため、不要な機能を作らずに済むこと。テストがユーザーの振る舞いに基づくため、実装の詳細に依存しにくい。
-
-## 参照ドキュメント
-
-| 種類 | パス |
-|------|------|
-| ワークフロー | @docs/reference/コーディングとテストガイド.md |
-| アーキテクチャ | @docs/design/architecture_frontend.md |
-| UI 設計 | @docs/design/ui-design.md |
-| 技術スタック | @docs/design/tech_stack.md |
-| テスト戦略 | @docs/design/test_strategy.md |
-
-## TDD サイクル
-
-10-15 分で 1 サイクルを完了させる。サイクルが長引くなら、タスクの粒度が大きすぎる。
-
-1. **Red**: 失敗するテストを最初に書く
-2. **Green**: テストを通す最小限のコードを実装する
-3. **Refactor**: 重複を除去し設計を改善する
-
-## アプローチ
-
-- **アウトサイドイン**（推奨）: UI から開始しロジックを段階的に実装する
-- **インサイドアウト**: ユーティリティ/hooks から開始し上位層へ展開する
-
-## テストコマンド
-
-```bash
-# 全テスト実行
-cd apps/frontend && npm run test
-
-# ウォッチモードでテスト実行
-cd apps/frontend && npm run test:watch
-
-# テストカバレッジ確認
-cd apps/frontend && npm run test:coverage
-
-# E2E テスト実行
-cd apps/frontend && npm run test:e2e
-```
-
-## 品質チェックリスト
-
-コミット前に必ず確認する。
-
-- [ ] すべてのテストがパス
-- [ ] ESLint の警告がゼロ
-- [ ] テストカバレッジが目標を満たしている
-- [ ] 単一の論理的作業単位を表現
-- [ ] コミットメッセージが変更内容を明確に説明
-
-## 途中から再開
-
-開発セッションの途中から再開する場合は、まず現在のテスト状態を確認する。
-
-**Example:**
-
-```
-ユーザー: 「ログイン画面のコンポーネントは作った。バリデーションを追加したい」
-回答: 既存テストを実行して Green 状態を確認する。
-      バリデーションの失敗するテスト（Red）を書いてから実装に進む。
-      ユーザーが不正な入力をした場合のエラー表示をテストする。
-```
-
-## コンテキスト管理
-
-タスクの区切りごとに `/compact` を実施して Context limit reached エラーを回避する。
-
-- TDD サイクルを数回繰り返した後、コンポーネント完了時、コミット完了後に実施する
-- `/compact` 前に現在の作業状態と次のタスクをメモとして出力する
-
-## 注意事項
-
-- Node.js/npm のテスト環境が設定済みであること（前提条件）
-- TDD の三原則を厳密に守る。テストなしでプロダクションコードを書かない
-- コミット前に必ず品質チェックリストを実行する
-- 作業完了後に対象の @docs/development/iteration_plan-N.md の進捗を更新する
-- コンポーネントは単一責任の原則に従い小さく保つ。TODO 駆動で分割し、Rule of Three でリファクタリングする
-
-## 関連スキル
-
-- `developing-backend` — バックエンド TDD 開発
-- `orchestrating-development` — 開発フェーズ全体のワークフロー
-- `git-commit` — Conventional Commits 準拠のコミット
+---
+name: developing-frontend
+description: フロントエンド開発の TDD ワークフローを支援。Red-Green-Refactor サイクルとアウトサイドインアプローチで品質の高い UI を実装する。「フロントエンドを実装したい」「画面を作りたい」「コンポーネントを追加したい」「フロントエンドのテストを書きたい」といった場面で発動する。TDD で開発することで、UI の振る舞いを自動テストで保証し、安全なリファクタリングを可能にする。
+---
+
+# フロントエンド開発
+
+TDD サイクルに従いフロントエンドを開発する。アウトサイドインアプローチ（UI 層→ロジック層→データ層）で、ユーザー視点から内側へ段階的に構築する。
+
+アウトサイドインの利点は、ユーザーが実際に操作する画面から始めるため、不要な機能を作らずに済むこと。テストがユーザーの振る舞いに基づくため、実装の詳細に依存しにくい。
+
+## 参照ドキュメント
+
+| 種類 | パス |
+|------|------|
+| ワークフロー | @docs/reference/コーディングとテストガイド.md |
+| アーキテクチャ | @docs/design/architecture_frontend.md |
+| UI 設計 | @docs/design/ui-design.md |
+| 技術スタック | @docs/design/tech_stack.md |
+| テスト戦略 | @docs/design/test_strategy.md |
+
+## TDD サイクル
+
+10-15 分で 1 サイクルを完了させる。サイクルが長引くなら、タスクの粒度が大きすぎる。
+
+1. **Red**: 失敗するテストを最初に書く
+2. **Green**: テストを通す最小限のコードを実装する
+3. **Refactor**: 重複を除去し設計を改善する
+
+## アプローチ
+
+- **アウトサイドイン**（推奨）: UI から開始しロジックを段階的に実装する
+- **インサイドアウト**: ユーティリティ/hooks から開始し上位層へ展開する
+
+## テストコマンド
+
+```bash
+# 全テスト実行
+cd apps/frontend && npm run test
+
+# ウォッチモードでテスト実行
+cd apps/frontend && npm run test:watch
+
+# テストカバレッジ確認
+cd apps/frontend && npm run test:coverage
+
+# E2E テスト実行
+cd apps/frontend && npm run test:e2e
+```
+
+## 品質チェックリスト
+
+コミット前に必ず確認する。
+
+- [ ] すべてのテストがパス
+- [ ] ESLint の警告がゼロ
+- [ ] テストカバレッジが目標を満たしている
+- [ ] 単一の論理的作業単位を表現
+- [ ] コミットメッセージが変更内容を明確に説明
+
+## 途中から再開
+
+開発セッションの途中から再開する場合は、まず現在のテスト状態を確認する。
+
+**Example:**
+
+```
+ユーザー: 「ログイン画面のコンポーネントは作った。バリデーションを追加したい」
+回答: 既存テストを実行して Green 状態を確認する。
+      バリデーションの失敗するテスト（Red）を書いてから実装に進む。
+      ユーザーが不正な入力をした場合のエラー表示をテストする。
+```
+
+## コンテキスト管理
+
+タスクの区切りごとに `/compact` を実施して Context limit reached エラーを回避する。
+
+- TDD サイクルを数回繰り返した後、コンポーネント完了時、コミット完了後に実施する
+- `/compact` 前に現在の作業状態と次のタスクをメモとして出力する
+
+## 注意事項
+
+- Node.js/npm のテスト環境が設定済みであること（前提条件）
+- TDD の三原則を厳密に守る。テストなしでプロダクションコードを書かない
+- コミット前に必ず品質チェックリストを実行する
+- 作業完了後に対象の @docs/development/iteration_plan-N.md の進捗を更新する
+- コンポーネントは単一責任の原則に従い小さく保つ。TODO 駆動で分割し、Rule of Three でリファクタリングする
+
+## 関連スキル
+
+- `developing-backend` — バックエンド TDD 開発
+- `orchestrating-development` — 開発フェーズ全体のワークフロー
+- `git-commit` — Conventional Commits 準拠のコミット

package/lib/assets/.claude/skills/developing-release/SKILL.md

@@ -1,120 +1,120 @@
----
-name: developing-release
-description: アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
----
-
-# リリースワークフロー
-
-品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。
-
-リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。
-
-## 参照ドキュメント
-
-- @docs/reference/リリースガイド.md — リリースワークフロー全体
-
-## オプション
-
-| オプション | 説明 |
-|-----------|------|
-| なし | ドライランを実行（デフォルト） |
-| `--dry-run` | CHANGELOG プレビュー + バージョン計算 |
-| `--patch` | パッチリリース（バグ修正） |
-| `--minor` | マイナーリリース（新機能追加、後方互換あり） |
-| `--major` | メジャーリリース（破壊的変更） |
-| `--preflight` | 品質ゲートのみ実行 |
-| `--deploy` | リリース + デプロイ（`--patch` / `--minor` / `--major` と併用） |
-
-## リリースフロー
-
-1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認する
-2. **リリース種別選択**: patch / minor / major を選択する
-3. **品質ゲート（preflight）**: 全チェックを通過する
-4. **リリース実行**: バージョンバンプ→CHANGELOG 生成→commit + tag
-5. **リモートプッシュ**: コミットとタグをプッシュする
-6. **プルリクエスト作成**: リリースブランチからメインブランチへの PR を作成し、CHANGELOG の差分をレビューする
-7. **デプロイ**: 必要に応じて本番デプロイを実行する
-
-## 品質ゲート（preflight）
-
-リリース前に以下のチェックを直列実行する。全チェック通過が必須。
-
-| チェック | コマンド | 内容 |
-| :--- | :--- | :--- |
-| working tree クリーン | `release:preflight:clean` | 未コミット変更がないこと |
-| 静的解析 | `release:preflight:lint` | lint エラーがないこと |
-| ユニットテスト | `release:preflight:test` | 全テストパス |
-| ビルド確認 | `release:preflight:build` | ビルド成功 |
-| E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
-
-## バージョニング規則
-
-[Semantic Versioning](https://semver.org/) に従う。
-
-| 種類 | 変更例 | バージョン変化 |
-| :--- | :--- | :--- |
-| `patch` | バグ修正、軽微な改善 | `0.1.0` → `0.1.1` |
-| `minor` | 新機能追加（後方互換あり） | `0.1.0` → `0.2.0` |
-| `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
-
-モノレポ構成の場合、全パッケージのバージョンを同期管理する。
-
-## CHANGELOG 生成ルール
-
-[Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成する。
-
-| prefix | カテゴリ |
-| :--- | :--- |
-| `feat` | Features |
-| `fix` | Bug Fixes |
-| `docs` | Documentation |
-| `refactor` | Refactoring |
-| `test` | Tests |
-| `chore` / `perf` / `ci` / `style` / `build` | その他 |
-
-直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。
-
-## リリース実行ステップ
-
-| ステップ | 内容 |
-| :--- | :--- |
-| [1/4] バージョン更新 | セマンティックバージョニングに従って更新 |
-| [2/4] CHANGELOG 生成 | コミットを分類し CHANGELOG.md を生成 |
-| [3/4] git commit + tag | `release: vX.X.X` でコミット→`vX.X.X` タグ作成 |
-| [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
-
-## 途中から再開
-
-リリース作業の途中から再開する場合は、現在の状態を確認する。
-
-**Example:**
-
-```
-ユーザー: 「品質ゲートは通った。リリースを実行したい」
-回答: --preflight の結果を確認し、全チェック通過を検証する。
-      --patch / --minor / --major のいずれかでリリースを実行する。
-```
-
-## トラブルシューティング
-
-- **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行する
-- **テスト失敗**: テストを修正してからリリースを再実行する
-- **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
-
-## コンテキスト管理
-
-品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に `/compact` を実施する。
-
-## 注意事項
-
-- ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること（前提条件）
-- working tree がクリーンでないとリリース不可
-- リリース前に必ずドライランで内容を確認する
-- Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する
-
-## 関連スキル
-
-- `git-commit` — Conventional Commits 準拠のコミット作成
-- `managing-operations` — デプロイ・運用管理
-- `planning-releases` — リリース・イテレーション計画
-- `orchestrating-development` — 開発フェーズ全体のワークフロー
+---
+name: developing-release
+description: アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
+---
+
+# リリースワークフロー
+
+品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。
+
+リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。
+
+## 参照ドキュメント
+
+- @docs/reference/リリースガイド.md — リリースワークフロー全体
+
+## オプション
+
+| オプション | 説明 |
+|-----------|------|
+| なし | ドライランを実行（デフォルト） |
+| `--dry-run` | CHANGELOG プレビュー + バージョン計算 |
+| `--patch` | パッチリリース（バグ修正） |
+| `--minor` | マイナーリリース（新機能追加、後方互換あり） |
+| `--major` | メジャーリリース（破壊的変更） |
+| `--preflight` | 品質ゲートのみ実行 |
+| `--deploy` | リリース + デプロイ（`--patch` / `--minor` / `--major` と併用） |
+
+## リリースフロー
+
+1. **ドライラン**: CHANGELOG プレビューとバージョン計算を確認する
+2. **リリース種別選択**: patch / minor / major を選択する
+3. **品質ゲート（preflight）**: 全チェックを通過する
+4. **リリース実行**: バージョンバンプ→CHANGELOG 生成→commit + tag
+5. **リモートプッシュ**: コミットとタグをプッシュする
+6. **プルリクエスト作成**: リリースブランチからメインブランチへの PR を作成し、CHANGELOG の差分をレビューする
+7. **デプロイ**: 必要に応じて本番デプロイを実行する
+
+## 品質ゲート（preflight）
+
+リリース前に以下のチェックを直列実行する。全チェック通過が必須。
+
+| チェック | コマンド | 内容 |
+| :--- | :--- | :--- |
+| working tree クリーン | `release:preflight:clean` | 未コミット変更がないこと |
+| 静的解析 | `release:preflight:lint` | lint エラーがないこと |
+| ユニットテスト | `release:preflight:test` | 全テストパス |
+| ビルド確認 | `release:preflight:build` | ビルド成功 |
+| E2E テスト | `release:preflight:e2e` | E2E テスト全パス |
+
+## バージョニング規則
+
+[Semantic Versioning](https://semver.org/) に従う。
+
+| 種類 | 変更例 | バージョン変化 |
+| :--- | :--- | :--- |
+| `patch` | バグ修正、軽微な改善 | `0.1.0` → `0.1.1` |
+| `minor` | 新機能追加（後方互換あり） | `0.1.0` → `0.2.0` |
+| `major` | 破壊的変更 | `0.1.0` → `1.0.0` |
+
+モノレポ構成の場合、全パッケージのバージョンを同期管理する。
+
+## CHANGELOG 生成ルール
+
+[Conventional Commits](https://www.conventionalcommits.org/) に基づいて自動生成する。
+
+| prefix | カテゴリ |
+| :--- | :--- |
+| `feat` | Features |
+| `fix` | Bug Fixes |
+| `docs` | Documentation |
+| `refactor` | Refactoring |
+| `test` | Tests |
+| `chore` / `perf` / `ci` / `style` / `build` | その他 |
+
+直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。
+
+## リリース実行ステップ
+
+| ステップ | 内容 |
+| :--- | :--- |
+| [1/4] バージョン更新 | セマンティックバージョニングに従って更新 |
+| [2/4] CHANGELOG 生成 | コミットを分類し CHANGELOG.md を生成 |
+| [3/4] git commit + tag | `release: vX.X.X` でコミット→`vX.X.X` タグ作成 |
+| [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
+
+## 途中から再開
+
+リリース作業の途中から再開する場合は、現在の状態を確認する。
+
+**Example:**
+
+```
+ユーザー: 「品質ゲートは通った。リリースを実行したい」
+回答: --preflight の結果を確認し、全チェック通過を検証する。
+      --patch / --minor / --major のいずれかでリリースを実行する。
+```
+
+## トラブルシューティング
+
+- **working tree がクリーンでない**: 変更をコミットまたは `git stash` してからリリース再実行する
+- **テスト失敗**: テストを修正してからリリースを再実行する
+- **リリースを元に戻したい**: リモートプッシュ前なら `git tag -d vX.X.X && git reset --hard HEAD~1`
+
+## コンテキスト管理
+
+品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に `/compact` を実施する。
+
+## 注意事項
+
+- ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること（前提条件）
+- working tree がクリーンでないとリリース不可
+- リリース前に必ずドライランで内容を確認する
+- Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する
+
+## 関連スキル
+
+- `git-commit` — Conventional Commits 準拠のコミット作成
+- `managing-operations` — デプロイ・運用管理
+- `planning-releases` — リリース・イテレーション計画
+- `orchestrating-development` — 開発フェーズ全体のワークフロー

package/lib/assets/.claude/skills/generating-bmc/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: generating-bmc
+description: ビジネスモデルキャンバス（BMC）の SVG 図を生成。テンプレート SVG を基に、ビジネスアーキテクチャ分析書のビジネスモデルキャンバスデータを反映した SVG ファイルを出力する。「BMC を生成したい」「ビジネスモデルキャンバスの図を作りたい」「BMC の SVG を更新したい」「ビジネスモデルキャンバスを可視化したい」といった場面で発動する。ビジネスアーキテクチャ分析が完了した後、またはビジネスモデルキャンバスの内容が更新された場合にも積極的に使用すること。
+---
+
+# ビジネスモデルキャンバス SVG 生成
+
+ビジネスアーキテクチャ分析書（`business_architecture.md`）のビジネスモデルキャンバスセクションから、テンプレート SVG の構造を参考にした BMC の SVG 図を生成する。
+
+## 参照ドキュメントと成果物
+
+| 種類 | パス | 備考 |
+|------|------|------|
+| テンプレート | `docs/reference/images/BMC.drawio.svg` | BMC レイアウトのリファレンス（英語版、drawio 形式） |
+| 入力 | `docs/strategy/business_architecture.md` | ビジネスアーキテクチャ分析書 |
+| 成果物 | `docs/strategy/BMC.svg` | 生成された BMC の SVG 図 |
+
+## BMC の 9 ブロック
+
+ビジネスモデルキャンバスは以下の 9 ブロックで構成される。入力ドキュメントの `### ビジネスモデルキャンバス` セクション内の mindmap データからこれらを抽出する。
+
+| # | ブロック | 英語名 | 配置 |
+| :--- | :--- | :--- | :--- |
+| 1 | 主要パートナー | Key Partners | 左端列 |
+| 2 | 主要活動 | Key Activities | 左中列・上段 |
+| 3 | 主要リソース | Key Resources | 左中列・下段 |
+| 4 | 価値提案 | Value Propositions | 中央列 |
+| 5 | 顧客関係 | Customer Relationships | 右中列・上段 |
+| 6 | チャネル | Channels | 右中列・下段 |
+| 7 | 顧客セグメント | Customer Segments | 右端列 |
+| 8 | コスト構造 | Cost Structure | 下段・左半分 |
+| 9 | 収益源 | Revenue Streams | 下段・右半分 |
+
+## SVG レイアウト仕様
+
+### 全体構造
+
+- **サイズ**: 2253 x 1601 px（テンプレート準拠）
+- **上段**: 5 列構成（y=100 〜 y=1000）
+  - 列 2（主要活動 / 主要リソース）と列 4（顧客関係 / チャネル）は上下 2 分割
+- **下段**: 2 列構成（y=1000 〜 y=1580）
+  - 左: コスト構造、右: 収益源
+
+### スタイル
+
+- **フォント**: "Helvetica Neue", Arial, "Hiragino Kaku Gothic ProN", "Hiragino Sans", Meiryo, sans-serif
+- **背景色**: `#FAFAFA`
+- **付箋カード**: `fill: #FFF9C4; stroke: #E0D654`（黄色系）
+- **ヘッダー**: 18px bold + アイコン絵文字
+- **項目テキスト**: 12-13px
+- **サブテキスト（補足）**: 10-11px、`fill: #888` または `#666`
+
+### 各ブロックのアイコン
+
+| ブロック | アイコン |
+| :--- | :--- |
+| 主要パートナー | 🤝 |
+| 主要活動 | ⚙ |
+| 主要リソース | 🏭 |
+| 価値提案 | 🎁 |
+| 顧客関係 | ❤ |
+| チャネル | 🚚 |
+| 顧客セグメント | 👥 |
+| コスト構造 | 💰 |
+| 収益源 | 💵 |
+
+## 生成の進め方
+
+### 新規生成
+
+1. `docs/strategy/business_architecture.md` の `### ビジネスモデルキャンバス` セクションを読む
+2. mindmap データから 9 ブロックの項目を抽出する
+3. テンプレート SVG（`docs/reference/images/BMC.drawio.svg`）のレイアウト構造を参考にする
+4. 本スキルの SVG レイアウト仕様に従い、抽出したデータで SVG を生成する
+5. `docs/strategy/BMC.svg` に出力する
+6. `operating-docs --update` を実行して docs/index.md、mkdocs.yml、各ディレクトリの index.md を更新する
+
+### 更新時の再生成
+
+1. `docs/strategy/business_architecture.md` のビジネスモデルキャンバスの変更内容を確認する
+2. 既存の `docs/strategy/BMC.svg` を読み、変更が必要な箇所を特定する
+3. SVG を更新する（全体再生成でも差分編集でもよい）
+4. 必要に応じて `operating-docs --update` を実行する
+
+### SVG 生成時の注意事項
+
+- テンプレートの drawio SVG は複雑なエンコーディングを含むため、そのまま編集するのではなくレイアウト構造のみを参考にする
+- SVG は手書きの clean な XML として生成する（drawio メタデータは不要）
+- 日本語テキストが正しく表示されるよう、UTF-8 エンコーディングと日本語フォントファミリーを指定する
+- 各ブロック内の項目は付箋カード風の矩形（`<rect>` + `<text>`）で表現する
+- 項目数が多い場合は付箋カードのサイズやレイアウトを調整して収まるようにする
+- フッターに "Based on the Business Model Canvas by Strategyzer.com (CC BY-SA 3.0)" のクレジットを含める
+
+## 関連スキル
+
+- `analyzing-business` : ビジネスアーキテクチャ分析（入力データの作成）
+- `operating-docs` : ドキュメント管理・インデックス更新