@k2works/claude-code-booster 4.4.1 → 4.5.0

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

@@ -1,123 +1,123 @@
----
-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` | `analyzing-business-architecture` の成果物 |
-| 入力（企業事例分析） | `docs/strategy/business_strategy.md` | `analyzing-business-strategy` の成果物 |
-| 成果物 | `docs/strategy/BMC.svg` | 生成された BMC の SVG 図 |
-
-### 入力ソースの選択
-
-本スキルは 2 つの入力ソースに対応する。どちらも `### ビジネスモデルキャンバス` セクション内に PlantUML mindmap 形式で 9 ブロックのデータを持つ前提で動作する。
-
-| 入力元スキル | 入力パス | 利用場面 |
-|------------|---------|---------|
-| `analyzing-business-architecture` | `docs/strategy/business_architecture.md` | 実プロジェクトのビジネスアーキテクチャ分析 |
-| `analyzing-business-strategy` | `docs/strategy/business_strategy.md` | 企業事例（ケーススタディ）の戦略分析 |
-
-両方のファイルが存在する場合は、`business_architecture.md` を優先する（実プロジェクトを事例分析より優先）。片方のみ存在する場合はそのファイルを使用する。どちらも存在しない場合は、先に `analyzing-business-architecture` または `analyzing-business-strategy` を実行するよう案内する。
-
-## BMC の 9 ブロック
-
-ビジネスモデルキャンバスは以下の 9 ブロックで構成される。入力ドキュメントのビジネスモデル系セクション内の mindmap データからこれらを抽出する。
-
-### セクション見出しの認識
-
-入力ドキュメントによって見出し表現が揺れるため、以下のいずれかのパターンにマッチするセクションを BMC セクションとして扱う：
-
-- `### ビジネスモデルキャンバス`（推奨・canonical）
-- `### ビジネスモデル`
-- `### ビジネスモデル（BMC）`
-- `### ビジネスモデル (BMC)`
-- `#### ビジネスモデル` / `#### ビジネスモデルキャンバス`（見出しレベルが深い場合）
-
-該当セクション内の最初の `@startmindmap` ブロックを BMC データとして解析する。ルートノード名（`* ビジネスモデル` や `* A 社ビジネスモデル` など）は事例名プレフィックスを含んでも構わない。9 ブロックの特定は「顧客 / 価値 / インフラ / 資金」の 4 分類配下のノード名で行う。
-
-| # | ブロック | 英語名 | 配置 |
-| :--- | :--- | :--- | :--- |
-| 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. 入力ソースを選択する（`business_architecture.md` または `business_strategy.md`）。両方ある場合は `business_architecture.md` を優先
-2. 選択した入力ファイルの `### ビジネスモデルキャンバス` セクションを読む
-3. mindmap データから 9 ブロックの項目を抽出する
-4. テンプレート SVG（`docs/reference/images/BMC.drawio.svg`）のレイアウト構造を参考にする
-5. 本スキルの SVG レイアウト仕様に従い、抽出したデータで SVG を生成する
-6. `docs/strategy/BMC.svg` に出力する
-7. `operating-docs --update` を実行して docs/index.md、mkdocs.yml、各ディレクトリの index.md を更新する
-
-### 更新時の再生成
-
-1. 入力ソース（`business_architecture.md` または `business_strategy.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-architecture` : ビジネスアーキテクチャ分析（実プロジェクト向けの入力データを作成）
-- `analyzing-business-strategy` : 企業事例分析（事例ベースの戦略ドキュメントから BMC セクションを提供）
-- `operating-docs` : ドキュメント管理・インデックス更新
+---
+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` | `analyzing-business-architecture` の成果物 |
+| 入力（企業事例分析） | `docs/strategy/business_strategy.md` | `analyzing-business-strategy` の成果物 |
+| 成果物 | `docs/strategy/BMC.svg` | 生成された BMC の SVG 図 |
+
+### 入力ソースの選択
+
+本スキルは 2 つの入力ソースに対応する。どちらも `### ビジネスモデルキャンバス` セクション内に PlantUML mindmap 形式で 9 ブロックのデータを持つ前提で動作する。
+
+| 入力元スキル | 入力パス | 利用場面 |
+|------------|---------|---------|
+| `analyzing-business-architecture` | `docs/strategy/business_architecture.md` | 実プロジェクトのビジネスアーキテクチャ分析 |
+| `analyzing-business-strategy` | `docs/strategy/business_strategy.md` | 企業事例（ケーススタディ）の戦略分析 |
+
+両方のファイルが存在する場合は、`business_architecture.md` を優先する（実プロジェクトを事例分析より優先）。片方のみ存在する場合はそのファイルを使用する。どちらも存在しない場合は、先に `analyzing-business-architecture` または `analyzing-business-strategy` を実行するよう案内する。
+
+## BMC の 9 ブロック
+
+ビジネスモデルキャンバスは以下の 9 ブロックで構成される。入力ドキュメントのビジネスモデル系セクション内の mindmap データからこれらを抽出する。
+
+### セクション見出しの認識
+
+入力ドキュメントによって見出し表現が揺れるため、以下のいずれかのパターンにマッチするセクションを BMC セクションとして扱う：
+
+- `### ビジネスモデルキャンバス`（推奨・canonical）
+- `### ビジネスモデル`
+- `### ビジネスモデル（BMC）`
+- `### ビジネスモデル (BMC)`
+- `#### ビジネスモデル` / `#### ビジネスモデルキャンバス`（見出しレベルが深い場合）
+
+該当セクション内の最初の `@startmindmap` ブロックを BMC データとして解析する。ルートノード名（`* ビジネスモデル` や `* A 社ビジネスモデル` など）は事例名プレフィックスを含んでも構わない。9 ブロックの特定は「顧客 / 価値 / インフラ / 資金」の 4 分類配下のノード名で行う。
+
+| # | ブロック | 英語名 | 配置 |
+| :--- | :--- | :--- | :--- |
+| 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. 入力ソースを選択する（`business_architecture.md` または `business_strategy.md`）。両方ある場合は `business_architecture.md` を優先
+2. 選択した入力ファイルの `### ビジネスモデルキャンバス` セクションを読む
+3. mindmap データから 9 ブロックの項目を抽出する
+4. テンプレート SVG（`docs/reference/images/BMC.drawio.svg`）のレイアウト構造を参考にする
+5. 本スキルの SVG レイアウト仕様に従い、抽出したデータで SVG を生成する
+6. `docs/strategy/BMC.svg` に出力する
+7. `operating-docs --update` を実行して docs/index.md、mkdocs.yml、各ディレクトリの index.md を更新する
+
+### 更新時の再生成
+
+1. 入力ソース（`business_architecture.md` または `business_strategy.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-architecture` : ビジネスアーキテクチャ分析（実プロジェクト向けの入力データを作成）
+- `analyzing-business-strategy` : 企業事例分析（事例ベースの戦略ドキュメントから BMC セクションを提供）
+- `operating-docs` : ドキュメント管理・インデックス更新

package/lib/assets/.claude/skills/operating-qt/SKILL.md

@@ -1,147 +1,147 @@
----
-name: operating-qt
-description: SonarQube によるコード品質管理を支援。ローカル SonarQube のセットアップ、スキャン実行、Quality Gate 確認、イシュー分析、メトリクス確認を行う。「SonarQube をセットアップしたい」「コード品質を分析したい」「Quality Gate を確認したい」「静的解析を実行したい」「SonarQube のイシューを確認したい」「コードの重複を調べたい」「カバレッジを SonarQube で見たい」といった場面で発動する。CI/CD パイプラインの品質ゲートチェックにも使用する。
----
-
-# コード品質管理（SonarQube）
-
-SonarQube を使った静的コード解析環境の構築と運用を支援する。SonarQube は Bug・Vulnerability・Code Smell・重複コード・カバレッジを一元的に可視化し、Quality Gate で品質基準を自動判定する。コード品質を継続的に計測することで、技術的負債の蓄積を早期に検知できる。
-
-## Instructions
-
-### 1. 参照ドキュメント
-
-@docs/reference/SonarQubeローカル環境セットアップ手順書.md にセットアップの詳細手順がある。環境構築時はこのドキュメントを参照する。
-
-### 2. 前提条件
-
-- Docker Desktop がインストール済みであること
-- RAM 4GB 以上を Docker Desktop に割り当て（推奨 6GB）
-- Windows の場合、WSL2 で `vm.max_map_count=524288` が設定済み
-
-### 3. コンポーネント構成
-
-| コンポーネント | コンテナ名 | ポート | イメージ |
-|--------------|-----------|-------|---------|
-| SonarQube | sonarqube | 9000 | `sonarqube:community` |
-| PostgreSQL | sonarqube-db | 内部 | `postgres:16-alpine` |
-
-Docker Compose ファイルは `ops/docker/sonarqube-local/docker-compose.yml` に配置する。
-
-### 4. Gulp タスク
-
-既存の `ops/scripts/sonar_local.js` で以下のタスクが利用可能。
-
-**セットアップ:**
-
-```bash
-npx gulp sonar-local:setup      # 初回セットアップ（Docker Compose 配置→起動→ヘルスチェック）
-```
-
-**コンテナ操作:**
-
-```bash
-npx gulp sonar-local:start      # 起動
-npx gulp sonar-local:stop       # 停止
-npx gulp sonar-local:restart    # 再起動
-npx gulp sonar-local:status     # 状態確認
-npx gulp sonar-local:logs       # ログ表示
-npx gulp sonar-local:open       # ダッシュボードをブラウザで開く
-```
-
-**スキャン・分析:**
-
-```bash
-npx gulp sonar-local:scan       # 全プロジェクトのスキャン実行
-npx gulp sonar-local:gate       # Quality Gate ステータス確認
-npx gulp sonar-local:issues     # メトリクス・イシュー・重複コード詳細
-npx gulp sonar-local:check      # スキャン → Quality Gate の一連フロー
-```
-
-**管理:**
-
-```bash
-npx gulp sonar-local:clean      # 環境完全削除（データ含む）
-npx gulp sonar-local:help       # ヘルプ表示
-```
-
-### 5. プロジェクト設定
-
-プロジェクトルートに `sonarqube.config.json` を配置して複数プロジェクトのスキャンを設定する。
-
-```json
-{
-  "projects": [
-    {
-      "name": "backend",
-      "label": "Backend",
-      "projectKey": "fleur-memoire-backend",
-      "scanType": "sonar-scanner",
-      "srcDir": "apps/backend"
-    },
-    {
-      "name": "frontend",
-      "label": "Frontend",
-      "projectKey": "fleur-memoire-frontend",
-      "scanType": "sonar-scanner",
-      "srcDir": "apps/frontend"
-    }
-  ]
-}
-```
-
-`scanType` は `sonar-scanner`（Node.js）、`sbt`、`maven`、`gradle` に対応。
-
-### 6. 環境変数
-
-`.env` に以下を設定する。
-
-| 変数 | 説明 | デフォルト |
-|------|------|----------|
-| `LOCAL_SONAR_PORT` | SonarQube ポート | 9000 |
-| `LOCAL_SONAR_DB_PASSWORD` | DB パスワード | sonarqube_password |
-| `SONAR_HOST_URL` | SonarQube URL | http://localhost:9000 |
-| `SONAR_TOKEN` | 分析トークン（スキャン時必須） | — |
-| `SONAR_PROJECT_KEY` | Quality Gate / Issues 対象キー | — |
-
-### 7. 初回セットアップフロー
-
-1. `npx gulp sonar-local:setup` でコンテナを構築・起動
-2. ブラウザで `http://localhost:9000` にアクセス（初期認証: admin / admin）
-3. admin パスワードを変更
-4. 分析トークンを生成（My Account → Security → Generate Tokens）
-5. `.env` に `SONAR_TOKEN=<生成したトークン>` を追加
-6. `sonarqube.config.json` を作成（複数プロジェクト対応時）
-7. `npx gulp sonar-local:scan` でスキャン実行
-
-### 8. 品質基準
-
-テスト戦略（@docs/design/test_strategy.md）で定義されたカバレッジ目標と SonarQube の Quality Gate を連携する。
-
-| メトリクス | 目標 |
-|-----------|------|
-| カバレッジ | ドメイン層 90%、全体 80% |
-| 重複率 | 3% 未満 |
-| Bug | 0 件 |
-| Vulnerability | 0 件 |
-| Code Smell | 可能な限り 0 件 |
-
-### 9. CI/CD 連携
-
-GitHub Actions で SonarQube スキャンを実行する場合は `operating-cicd` スキルを参照する。ローカルの SonarQube はあくまで開発中の品質確認用で、CI/CD では SonarCloud や別途ホスティングされた SonarQube を使用する。
-
-### 10. トラブルシューティング
-
-| 症状 | 原因 | 対処 |
-|------|------|------|
-| コンテナ起動後すぐ停止 | `vm.max_map_count` 不足 | WSL2 / Docker VM で `524288` に設定 |
-| ヘルスチェックがタイムアウト | メモリ不足 | Docker Desktop の RAM 割り当てを増やす |
-| スキャン時 401 エラー | トークン未設定 or 無効 | `.env` の `SONAR_TOKEN` を確認 |
-| `DOCKER_HOST` 接続エラー | 環境変数の干渉 | `cleanDockerEnv()` を使用（`shared.js`） |
-
-### 関連スキル
-
-- `operating-script` — 運用スクリプト作成ガイドに準拠したスクリプト作成
-- `operating-cicd` — CI/CD パイプラインでの品質ゲート連携
-- `operating-setup` — 環境構築の段階的実行
-- `orchestrating-operation` — 運用フェーズ全体のワークフロー
+---
+name: operating-qt
+description: SonarQube によるコード品質管理を支援。ローカル SonarQube のセットアップ、スキャン実行、Quality Gate 確認、イシュー分析、メトリクス確認を行う。「SonarQube をセットアップしたい」「コード品質を分析したい」「Quality Gate を確認したい」「静的解析を実行したい」「SonarQube のイシューを確認したい」「コードの重複を調べたい」「カバレッジを SonarQube で見たい」といった場面で発動する。CI/CD パイプラインの品質ゲートチェックにも使用する。
+---
+
+# コード品質管理（SonarQube）
+
+SonarQube を使った静的コード解析環境の構築と運用を支援する。SonarQube は Bug・Vulnerability・Code Smell・重複コード・カバレッジを一元的に可視化し、Quality Gate で品質基準を自動判定する。コード品質を継続的に計測することで、技術的負債の蓄積を早期に検知できる。
+
+## Instructions
+
+### 1. 参照ドキュメント
+
+@docs/reference/SonarQubeローカル環境セットアップ手順書.md にセットアップの詳細手順がある。環境構築時はこのドキュメントを参照する。
+
+### 2. 前提条件
+
+- Docker Desktop がインストール済みであること
+- RAM 4GB 以上を Docker Desktop に割り当て（推奨 6GB）
+- Windows の場合、WSL2 で `vm.max_map_count=524288` が設定済み
+
+### 3. コンポーネント構成
+
+| コンポーネント | コンテナ名 | ポート | イメージ |
+|--------------|-----------|-------|---------|
+| SonarQube | sonarqube | 9000 | `sonarqube:community` |
+| PostgreSQL | sonarqube-db | 内部 | `postgres:16-alpine` |
+
+Docker Compose ファイルは `ops/docker/sonarqube-local/docker-compose.yml` に配置する。
+
+### 4. Gulp タスク
+
+既存の `ops/scripts/sonar_local.js` で以下のタスクが利用可能。
+
+**セットアップ:**
+
+```bash
+npx gulp sonar-local:setup      # 初回セットアップ（Docker Compose 配置→起動→ヘルスチェック）
+```
+
+**コンテナ操作:**
+
+```bash
+npx gulp sonar-local:start      # 起動
+npx gulp sonar-local:stop       # 停止
+npx gulp sonar-local:restart    # 再起動
+npx gulp sonar-local:status     # 状態確認
+npx gulp sonar-local:logs       # ログ表示
+npx gulp sonar-local:open       # ダッシュボードをブラウザで開く
+```
+
+**スキャン・分析:**
+
+```bash
+npx gulp sonar-local:scan       # 全プロジェクトのスキャン実行
+npx gulp sonar-local:gate       # Quality Gate ステータス確認
+npx gulp sonar-local:issues     # メトリクス・イシュー・重複コード詳細
+npx gulp sonar-local:check      # スキャン → Quality Gate の一連フロー
+```
+
+**管理:**
+
+```bash
+npx gulp sonar-local:clean      # 環境完全削除（データ含む）
+npx gulp sonar-local:help       # ヘルプ表示
+```
+
+### 5. プロジェクト設定
+
+プロジェクトルートに `sonarqube.config.json` を配置して複数プロジェクトのスキャンを設定する。
+
+```json
+{
+  "projects": [
+    {
+      "name": "backend",
+      "label": "Backend",
+      "projectKey": "fleur-memoire-backend",
+      "scanType": "sonar-scanner",
+      "srcDir": "apps/backend"
+    },
+    {
+      "name": "frontend",
+      "label": "Frontend",
+      "projectKey": "fleur-memoire-frontend",
+      "scanType": "sonar-scanner",
+      "srcDir": "apps/frontend"
+    }
+  ]
+}
+```
+
+`scanType` は `sonar-scanner`（Node.js）、`sbt`、`maven`、`gradle` に対応。
+
+### 6. 環境変数
+
+`.env` に以下を設定する。
+
+| 変数 | 説明 | デフォルト |
+|------|------|----------|
+| `LOCAL_SONAR_PORT` | SonarQube ポート | 9000 |
+| `LOCAL_SONAR_DB_PASSWORD` | DB パスワード | sonarqube_password |
+| `SONAR_HOST_URL` | SonarQube URL | http://localhost:9000 |
+| `SONAR_TOKEN` | 分析トークン（スキャン時必須） | — |
+| `SONAR_PROJECT_KEY` | Quality Gate / Issues 対象キー | — |
+
+### 7. 初回セットアップフロー
+
+1. `npx gulp sonar-local:setup` でコンテナを構築・起動
+2. ブラウザで `http://localhost:9000` にアクセス（初期認証: admin / admin）
+3. admin パスワードを変更
+4. 分析トークンを生成（My Account → Security → Generate Tokens）
+5. `.env` に `SONAR_TOKEN=<生成したトークン>` を追加
+6. `sonarqube.config.json` を作成（複数プロジェクト対応時）
+7. `npx gulp sonar-local:scan` でスキャン実行
+
+### 8. 品質基準
+
+テスト戦略（@docs/design/test_strategy.md）で定義されたカバレッジ目標と SonarQube の Quality Gate を連携する。
+
+| メトリクス | 目標 |
+|-----------|------|
+| カバレッジ | ドメイン層 90%、全体 80% |
+| 重複率 | 3% 未満 |
+| Bug | 0 件 |
+| Vulnerability | 0 件 |
+| Code Smell | 可能な限り 0 件 |
+
+### 9. CI/CD 連携
+
+GitHub Actions で SonarQube スキャンを実行する場合は `operating-cicd` スキルを参照する。ローカルの SonarQube はあくまで開発中の品質確認用で、CI/CD では SonarCloud や別途ホスティングされた SonarQube を使用する。
+
+### 10. トラブルシューティング
+
+| 症状 | 原因 | 対処 |
+|------|------|------|
+| コンテナ起動後すぐ停止 | `vm.max_map_count` 不足 | WSL2 / Docker VM で `524288` に設定 |
+| ヘルスチェックがタイムアウト | メモリ不足 | Docker Desktop の RAM 割り当てを増やす |
+| スキャン時 401 エラー | トークン未設定 or 無効 | `.env` の `SONAR_TOKEN` を確認 |
+| `DOCKER_HOST` 接続エラー | 環境変数の干渉 | `cleanDockerEnv()` を使用（`shared.js`） |
+
+### 関連スキル
+
+- `operating-script` — 運用スクリプト作成ガイドに準拠したスクリプト作成
+- `operating-cicd` — CI/CD パイプラインでの品質ゲート連携
+- `operating-setup` — 環境構築の段階的実行
+- `orchestrating-operation` — 運用フェーズ全体のワークフロー