@sk8metal/michi-cli 0.3.0 → 0.4.0

package/docs/user-guide/guides/workflow.md

@@ -8,54 +8,59 @@
 
 ## ワークフロー全体像
 
+> **注**: このワークフローは cc-sdd (Spec-Driven Development) の標準フローを Michi が拡張したものです。
+> - **cc-sdd 標準**: Phase 0.0-0.2, 0.5 (`/kiro:*` コマンド)
+> - **Michi 固有拡張**: Phase 0.3-0.4, 0.6-0.7, Phase 1-5, Phase A/B (テスト計画・実行、JIRA/Confluence連携)
+
 ```
-Phase 0.0: 仕様の初期化 (/kiro:spec-init)
+Phase 0.0: 仕様の初期化 (/kiro:spec-init) ← cc-sdd 標準
    ↓
-Phase 0.1: 要件定義 (/kiro:spec-requirements)
-   ↓ GitHub → Confluence同期
+Phase 0.1: 要件定義 (/kiro:spec-requirements) ← cc-sdd 標準
+   ↓ GitHub → Confluence同期 ← Michi 固有
    ↓ 企画・部長が承認
 
-Phase 0.2: 設計 (/kiro:spec-design)
-   ↓ GitHub → Confluence同期
-   ↓ 見積もり生成 → Excel出力
+Phase 0.2: 設計 (/michi:spec-design または /kiro:spec-design)
+   ↓ /michi:spec-design 推奨（Phase 0.3-0.4 ガイダンス付き）
+   ↓ GitHub → Confluence同期 ← Michi 固有
+   ↓ 見積もり生成 → Excel出力 ← Michi 固有
    ↓ アーキテクト・部長が承認
 
-Phase 0.3: テストタイプの選択
+Phase 0.3: テストタイプの選択 ← Michi 固有（重要）
    ↓ テスト計画フローに従う
 
-Phase 0.4: テスト仕様書の作成
+Phase 0.4: テスト仕様書の作成 ← Michi 固有（重要）
    ↓ テンプレートを使用
 
-Phase 0.5: タスク分割 (/kiro:spec-tasks)
+Phase 0.5: タスク分割 (/kiro:spec-tasks) ← cc-sdd 標準
    ↓ tasks.md生成
 
-Phase 0.6: タスクのJIRA同期
+Phase 0.6: タスクのJIRA同期 ← Michi 固有
    ↓ Epic/Story/Subtask自動作成
 
-Phase 0.7: Confluence同期
+Phase 0.7: Confluence同期 ← Michi 固有
    ↓
-Phase 1: 環境構築・基盤整備
+Phase 1: 環境構築・基盤整備 ← Michi 固有
    ↓ テスト環境セットアップ
 
-Phase 2: TDD実装 (/kiro:spec-impl)
+Phase 2: TDD実装 (/kiro:spec-impl) ← cc-sdd 標準
    ↓ テスト → コード → リファクタリング
 
-Phase A: PR作成前の自動テスト（CI/CD）
+Phase A: PR作成前の自動テスト（CI/CD） ← Michi 固有
    ↓ 単体テスト + Lint + ビルド
    ↓ GitHub PR作成
    ↓ PRマージ
 
-Phase 3: 追加の品質保証（PRマージ後）
+Phase 3: 追加の品質保証（PRマージ後） ← Michi 固有
    ↓ 静的解析・セキュリティスキャン
 
-Phase B: リリース準備時の手動テスト
+Phase B: リリース準備時の手動テスト ← Michi 固有
    ↓ 統合・E2E・パフォーマンス・セキュリティ
 
-Phase 4: リリース準備ドキュメント作成 (/kiro:release-prep)
+Phase 4: リリース準備ドキュメント作成 (/kiro:release-prep) ← Michi 固有
    ↓ Confluenceリリース手順書
    ↓ リリースJIRA起票
 
-Phase 5: リリース実行
+Phase 5: リリース実行 ← Michi 固有
    ↓ タグ作成 → CI/CD → GitHub Release作成
 ```
 
@@ -145,13 +150,18 @@ AIが自動的に：
 #### Phase 0.2 Step 1: 設計書の生成
 
 ```bash
-# 凡例
+# 推奨: Michi 拡張版（Phase 0.3-0.4 ガイダンス付き）
+/michi:spec-design <feature>
+
+# または cc-sdd 標準版
 /kiro:spec-design <feature>
 
 # 具体例
-/kiro:spec-design user-auth
+/michi:spec-design user-auth
 ```
 
+**推奨**: `/michi:spec-design` を使用すると、設計完了後に Phase 0.3-0.4（テスト計画）へのガイダンスが自動的に表示されます。
+
 AIが以下を生成：
 
 - アーキテクチャ図
@@ -189,9 +199,13 @@ michi confluence:sync user-auth design
 
 ### Phase 0.3-0.4: テスト計画
 
+> **Michi 固有機能**: Phase 0.3-0.4 は Michi 独自の拡張フェーズです。cc-sdd 標準には含まれません。
+>
+> `/michi:spec-design` コマンドを使用すると、設計完了後に自動的にこのフェーズへのガイダンスが表示されます。
+
 #### Phase 0.3: テストタイプの選択
 
-Phase 0.2（設計）完了後、Phase 0.4（テスト仕様書作成）の前に、どのテストタイプが必要かを決定します。
+Phase 0.2（設計）完了後、Phase 0.5（タスク分割）の前に、どのテストタイプが必要かを決定します。
 
 詳細は [テスト計画フロー](../testing/test-planning-flow.md#phase-03-テストタイプの選択) を参照してください。
 

package/docs/user-guide/reference/config.md

@@ -4,10 +4,30 @@
 
 ## 設定ファイルの場所
 
-プロジェクトルートの `.michi/config.json` に設定を記述します。
+Michiの設定ファイルは以下の2つの場所に配置できます：
+
+### グローバル設定
+
+**場所**: `~/.michi/config.json`
+
+**用途**: 全プロジェクトで共通の設定（組織標準の設定など）
+
+**作成方法**: `npm run config:global` コマンドを使用
+
+### プロジェクト固有設定
+
+**場所**: プロジェクトルートの `.michi/config.json`
+
+**用途**: プロジェクト固有の設定（グローバル設定を上書き）
+
+**作成方法**:
+- 自動作成: `michi init` コマンド実行時にグローバル設定から自動コピー
+- 手動作成: グローバル設定（`~/.michi/config.json`）をコピーして編集
 
 **注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。`.kiro/config.json` が存在する場合は警告が表示されます。
 
+### 設定ファイルのフォーマット
+
 ```json
 {
   "confluence": { ... },
@@ -130,8 +150,13 @@
 
 1. **`spec.json`**: 機能固有の設定（最優先）
 2. **`.michi/config.json`**: プロジェクト固有の設定
-3. **環境変数**: システム環境変数または`.env`ファイル
-4. **デフォルト値**: スキーマで定義されたデフォルト値
+3. **`~/.michi/config.json`**: グローバル設定
+4. **環境変数**: システム環境変数または`.env`ファイル
+5. **デフォルト値**: スキーマで定義されたデフォルト値
+
+**推奨される使い方**:
+- **グローバル設定（`~/.michi/config.json`）**: 組織全体で共通の設定（Confluence階層構造、JIRA Story作成粒度など）
+- **プロジェクト設定（`.michi/config.json`）**: プロジェクト固有の設定（特定プロジェクトのみカスタマイズが必要な場合）
 
 ## 設定例
 
@@ -359,7 +384,7 @@ npx tsx scripts/utils/config-validator.ts
 3. **優先順位の問題**
    - 環境変数が設定されている場合、環境変数の優先順位を確認
    - `spec.json`に設定がある場合、`spec.json`が最優先であることを確認
-   - 設定の優先順位: `spec.json` > `config.json` > 環境変数 > デフォルト値
+   - 設定の優先順位: `spec.json` > `.michi/config.json` > `~/.michi/config.json` > 環境変数 > デフォルト値
 
 4. **設定ファイルの読み込みエラー**
    - 設定ファイルの権限を確認: `chmod 644 .michi/config.json`
@@ -516,7 +541,7 @@ export CONFLUENCE_PRD_SPACE=Michi
    - JIRA同期時: 設定値のソースが表示される
 
 2. **設定ファイルの優先順位を理解**
-   - `spec.json` > `.michi/config.json` > 環境変数 > デフォルト値
+   - `spec.json` > `.michi/config.json` > `~/.michi/config.json` > 環境変数 > デフォルト値
    - 同じ設定値が複数箇所にある場合、優先順位の高いものが使用される
 
 3. **デバッグ方法**

package/docs/user-guide/reference/quick-reference.md

@@ -4,83 +4,65 @@
 
 ## 新規プロジェクト作成
 
-### パターンA: 既存リポジトリにMichi共通ルール・コマンドを追加（最も簡単 ⭐）
+### 推奨: `michi init` コマンド（最も簡単 ⭐）
 
 ```bash
-# 既存プロジェクトに移動
+# 既存リポジトリに移動
 cd /path/to/existing-repo
 
-# Michiの共通ルール・コマンド・テンプレートをコピー
-npx tsx /path/to/michi/scripts/setup-existing-project.ts --michi-path /path/to/michi
+# 1コマンドで初期設定完了
+michi init --michi-path /path/to/michi
 ```
 
-このスクリプトが自動的に：
+このコマンドが自動的に：
 
-- 共通ルール（`.cursor/rules/`）をコピー
-- カスタムコマンド（`.cursor/commands/kiro/`）をコピー
+- プロジェクトメタデータ（`.kiro/project.json`）を作成
+- 環境変数テンプレート（`.env`）を作成
+- 共通ルール・コマンドをコピー（`--michi-path` 指定時）
 - Steeringテンプレート（`.kiro/steering/`）をコピー
 - Specテンプレート（`.kiro/settings/templates/`）をコピー
+- ワークフロー設定（`.michi/config.json`）を作成
+  - グローバル設定（`~/.michi/config.json`）があればコピー
+  - なければ対話的に設定
 
-**次のステップ**:
-
-1. cc-sddを導入: `npx cc-sdd@latest --lang ja --cursor`
-2. 設定を対話的に作成: `npm run setup:interactive`
-
-### パターンB: 新規リポジトリを作成してセットアップ
+**オプション**:
 
 ```bash
-# Michiから実行
-cd /path/to/michi
-
-# 凡例
-npm run create-project -- \
-  --name "<project-id>" \
-  --project-name "<project-name>" \
-  --jira-key "<jira-key>"
-
-# 具体例
-npm run create-project -- \
-  --name "20240115-payment-api" \
-  --project-name "プロジェクトA" \
-  --jira-key "PRJA"
+# 非対話モード（プロジェクト名とJIRAキーを指定）
+michi init \
+  --name "project-id" \
+  --project-name "プロジェクト名" \
+  --jira-key "PRJA" \
+  --michi-path /path/to/michi \
+  -y
+
+# ワークフロー設定をスキップ
+michi init --michi-path /path/to/michi --skip-config
+
+# 環境を指定（デフォルト: Cursor）
+michi init --michi-path /path/to/michi --cursor
+michi init --michi-path /path/to/michi --claude
 ```
 
-**リポジトリ名**: `--name`で指定した値がそのままGitHubリポジトリ名として使用されます。
-
-**例**:
+**次のステップ**:
 
-- `--name "20240115-payment-api"` → GitHubリポジトリ: `org/20240115-payment-api`
-- `--name "payment-api"` → GitHubリポジトリ: `org/payment-api`
+1. `.env` ファイルの内容を確認・編集
+2. `.michi/config.json` の内容を確認（必要に応じて編集）
+3. 開発開始: `/kiro:spec-init <機能説明>`
 
-**注意**: リポジトリ名はkebab-case（小文字、ハイフン区切り）を推奨します。
+### 代替: 個別セットアップ
 
-### パターンC: 完全手動セットアップ
+グローバル設定を先に作成する場合:
 
 ```bash
-# 1. リポジトリ作成・クローン
-gh repo create org/repo-name --private
-jj git clone https://github.com/org/repo-name
-cd repo-name
-
-# 2. cc-sdd導入
-npx cc-sdd@latest --cursor --lang ja --yes
-
-# 3. プロジェクトメタデータ作成
-cat > .kiro/project.json << 'EOF'
-{
-  "projectId": "repo-name",
-  "projectName": "プロジェクト名",
-  "jiraProjectKey": "PRJX",
-  "confluenceLabels": ["project:x", "service:y"]
-}
-EOF
-
-# 4. Michiから共通ルール・コマンド・テンプレートをコピー
-npx tsx /path/to/michi/scripts/setup-existing-project.ts \
-  --michi-path /path/to/michi
-
-# 5. npm install
-# 6. 初期コミット
+# 1. グローバル設定を作成（組織で一度だけ）
+michi config:global
+
+# 2. プロジェクト初期設定
+cd /path/to/project
+michi init --michi-path /path/to/michi
+
+# グローバル設定が自動的にコピーされます
 ```
 
 詳細: [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md)
@@ -128,20 +110,31 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 ## コマンド一覧
 
-| コマンド                                 | 説明                       | 分類       |
-| ---------------------------------------- | -------------------------- | ---------- |
-| `/kiro:spec-init <description>`          | 仕様初期化                 | cc-sdd     |
-| `/kiro:spec-requirements <feature>`      | 要件定義生成               | cc-sdd     |
-| `/kiro:spec-design <feature>`            | 設計生成                   | cc-sdd     |
-| `/kiro:spec-tasks <feature>`             | タスク分割                 | cc-sdd     |
-| `/kiro:spec-impl <feature> <tasks>`      | TDD実装                    | cc-sdd     |
-| `/kiro:spec-status <feature>`            | 進捗確認                   | cc-sdd     |
-| `/kiro:steering`                         | Steering作成/更新          | cc-sdd     |
-| `/kiro:steering-custom`                  | カスタムSteering作成       | cc-sdd     |
-| `/kiro:validate-gap <feature>`           | 既存コードと要件の差異分析 | cc-sdd     |
-| `/kiro:validate-design <feature>`        | 設計の品質レビューと検証   | cc-sdd     |
-| `/kiro:confluence-sync <feature> [type]` | Confluence同期             | Michi only |
-| `/kiro:project-switch <project_id>`      | プロジェクト切り替え       | Michi only |
+### cc-sdd 標準コマンド
+
+| コマンド                                 | 説明                       |
+| ---------------------------------------- | -------------------------- |
+| `/kiro:spec-init <description>`          | 仕様初期化                 |
+| `/kiro:spec-requirements <feature>`      | 要件定義生成               |
+| `/kiro:spec-design <feature>`            | 設計生成（cc-sdd標準版）   |
+| `/kiro:spec-tasks <feature>`             | タスク分割                 |
+| `/kiro:spec-impl <feature> <tasks>`      | TDD実装                    |
+| `/kiro:spec-status <feature>`            | 進捗確認                   |
+| `/kiro:steering`                         | Steering作成/更新          |
+| `/kiro:steering-custom`                  | カスタムSteering作成       |
+| `/kiro:validate-gap <feature>`           | 既存コードと要件の差異分析 |
+| `/kiro:validate-design <feature>`        | 設計の品質レビューと検証   |
+
+### Michi 拡張コマンド
+
+> **注**: これらのコマンドは Michi 独自の拡張機能です。cc-sdd 標準には含まれません。
+
+| コマンド                                 | 説明                                           |
+| ---------------------------------------- | ---------------------------------------------- |
+| `/michi:spec-design <feature>`           | 設計生成（Phase 0.3-0.4 ガイダンス付き）⭐推奨 |
+| `/michi:validate-design <feature>`       | 設計レビュー（テスト計画完了確認付き）         |
+| `/michi:confluence-sync <feature> [type]` | Confluence同期                                 |
+| `/michi:project-switch <project_id>`      | プロジェクト切り替え                           |
 
 ## Michi CLIコマンド一覧
 
@@ -149,6 +142,8 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 | コマンド                                    | 説明                                              |
 | ------------------------------------------- | ------------------------------------------------- |
+| `michi init`                                | プロジェクト初期設定（推奨）⭐                    |
+| `michi config:global`                       | グローバル設定作成（~/.michi/config.json）        |
 | `michi jira:sync <feature>`                 | JIRA連携（tasks.md → Epic/Stories）               |
 | `michi confluence:sync <feature> [type]`    | Confluence同期（requirements/design）             |
 | `michi phase:run <feature> <phase>`         | フェーズ実行（requirements/design/tasks）         |
@@ -157,7 +152,6 @@ gh pr create --head <project-id>/feature/<feature> --base main
 | `michi project:list`                        | プロジェクト一覧                                  |
 | `michi project:dashboard`                   | リソースダッシュボード生成                        |
 | `michi workflow:run --feature <name>`       | 統合ワークフロー実行                              |
-| `michi config:interactive`                  | 対話式設定ツール（.michi/config.json作成）        |
 | `michi config:validate`                     | 設定ファイルのバリデーション                      |
 | `michi tasks:convert <feature>`             | AI-DLC形式のtasks.mdをMichiワークフロー形式に変換 |
 | `michi jira:transition <issueKey> <status>` | JIRAチケットのステータス変更                      |
@@ -185,7 +179,7 @@ gh pr create --head <project-id>/feature/<feature> --base main
 ### 方法1: Cursorコマンド
 
 ```
-/kiro:project-switch <project-id>
+/michi:project-switch <project-id>
 ```
 
 ### 方法2: ターミナル

package/docs/user-guide/testing/test-planning-flow.md

@@ -1,5 +1,9 @@
 # テスト計画フロー
 
+> **Michi 固有ワークフロー**: このテスト計画フロー（Phase 0.3-0.4, Phase 1, Phase A/B/3）は Michi 独自の拡張機能です。cc-sdd 標準には含まれません。
+>
+> `/michi:spec-design` コマンドを使用すると、設計完了後に自動的に Phase 0.3-0.4 へのガイダンスが表示されます。
+
 このドキュメントでは、michiを使用したプロジェクトでのテスト計画の流れを説明します。
 
 ## Phase 0.3: テストタイプの選択

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -46,12 +46,10 @@
     "build": "tsc && node scripts/copy-static-assets.js",
     "postbuild": "node scripts/set-permissions.js",
     "prepare": "husky",
-    "setup:interactive": "tsx scripts/setup-interactive.ts",
     "michi:setup:cursor": "tsx src/cli.ts setup-existing --cursor",
     "michi:setup:claude": "tsx src/cli.ts setup-existing --claude",
     "michi:setup:claude-agent": "tsx src/cli.ts setup-existing --claude-agent",
     "create-project": "tsx scripts/create-project.ts",
-    "setup-existing": "tsx scripts/setup-existing-project.ts",
     "confluence:sync": "tsx scripts/confluence-sync.ts",
     "jira:sync": "tsx scripts/jira-sync.ts",
     "github:create-pr": "tsx scripts/pr-automation.ts",
@@ -66,7 +64,7 @@
     "preflight": "tsx scripts/pre-flight-check.ts",
     "pre-publish": "bash scripts/pre-publish-check.sh",
     "test:package": "bash scripts/test-npm-package.sh",
-    "config:interactive": "tsx scripts/config-interactive.ts",
+    "config:global": "tsx scripts/config-global.ts",
     "config:validate": "tsx scripts/utils/config-validator.ts",
     "test:interactive": "tsx scripts/test-interactive.ts",
     "test": "vitest",

package/scripts/config-global.ts

@@ -0,0 +1,160 @@
+/**
+ * グローバル設定ツール
+ * ~/.michi/config.json を対話的に作成・更新
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import { createInterface, confirm } from './utils/interactive-helpers.js';
+import {
+  getConfluenceConfig,
+  getJiraConfig,
+  getWorkflowConfig,
+  type ConfluenceConfigResult,
+  type JiraConfigResult,
+  type WorkflowConfigResult,
+} from './utils/config-sections.js';
+import { getGlobalConfigPath } from './utils/config-loader.js';
+import { AppConfigSchema } from './config/config-schema.js';
+
+/**
+ * プロジェクト設定全体
+ */
+interface ProjectConfig {
+  confluence?: ConfluenceConfigResult;
+  jira?: JiraConfigResult;
+  workflow?: WorkflowConfigResult;
+}
+
+/**
+ * メイン処理
+ */
+async function main(): Promise<void> {
+  const rl = createInterface();
+
+  try {
+    console.log('🌐 Michi グローバル設定ツール');
+    console.log('='.repeat(60));
+    console.log('このツールで ~/.michi/config.json を作成・更新できます。');
+    console.log('');
+    console.log('グローバル設定は、すべてのプロジェクトに適用されます。');
+    console.log('プロジェクト固有の設定は .michi/config.json で上書きできます。');
+    console.log('');
+
+    const globalConfigPath = getGlobalConfigPath();
+    const globalConfigDir = dirname(globalConfigPath);
+
+    let existingConfig: ProjectConfig | null = null;
+
+    // 既存の設定ファイルを確認
+    if (existsSync(globalConfigPath)) {
+      console.log(`⚠️  既存のグローバル設定ファイルが見つかりました: ${globalConfigPath}`);
+      const overwrite = await confirm(rl, '上書きしますか？', false);
+
+      if (!overwrite) {
+        console.log('中止しました。');
+        process.exit(0);
+      }
+
+      try {
+        const content = readFileSync(globalConfigPath, 'utf-8');
+        existingConfig = JSON.parse(content) as ProjectConfig;
+        console.log('既存の設定を読み込みました。\n');
+      } catch {
+        console.log(
+          '既存の設定ファイルの読み込みに失敗しました。新規作成します。\n',
+        );
+      }
+    }
+
+    // 設定を対話的に取得
+    const config: ProjectConfig = existingConfig || {};
+
+    // Confluence設定
+    const configureConfluence = await confirm(
+      rl,
+      'Confluence設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureConfluence) {
+      config.confluence = await getConfluenceConfig(rl);
+    }
+
+    // JIRA設定
+    const configureJira = await confirm(
+      rl,
+      'JIRA設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureJira) {
+      config.jira = await getJiraConfig(rl);
+    }
+
+    // ワークフロー設定
+    const configureWorkflow = await confirm(
+      rl,
+      'ワークフロー設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureWorkflow) {
+      config.workflow = await getWorkflowConfig(rl);
+    }
+
+    // 設定の確認
+    console.log('\n📋 設定内容の確認');
+    console.log('='.repeat(60));
+    console.log(JSON.stringify(config, null, 2));
+    console.log('');
+
+    const confirmSave = await confirm(rl, 'この設定を保存しますか？', true);
+
+    if (!confirmSave) {
+      console.log('保存をキャンセルしました。');
+      process.exit(0);
+    }
+
+    // ディレクトリを作成（存在しない場合）
+    if (!existsSync(globalConfigDir)) {
+      mkdirSync(globalConfigDir, { recursive: true });
+      console.log(`\n📁 ディレクトリを作成しました: ${globalConfigDir}`);
+    }
+
+    // 設定ファイルを保存
+    writeFileSync(globalConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    console.log(`\n✅ グローバル設定ファイルを保存しました: ${globalConfigPath}`);
+
+    // バリデーション（スキーマチェックのみ）
+    console.log('\n🔍 設定ファイルのバリデーション...');
+    try {
+      AppConfigSchema.parse(config);
+      console.log('✅ 設定ファイルは有効です。');
+    } catch (error) {
+      console.warn('⚠️  設定ファイルに問題があります:');
+      console.warn(error instanceof Error ? error.message : error);
+      console.warn('   プロジェクト固有の設定で補完することができます。');
+    }
+
+    console.log('\n🎉 グローバル設定が完了しました！');
+    console.log('   この設定はすべてのプロジェクトに適用されます。');
+    console.log('   プロジェクト固有の設定で上書きしたい場合は:');
+    console.log('   グローバル設定をコピーして .michi/config.json として編集してください');
+  } catch (error) {
+    console.error(
+      '❌ エラーが発生しました:',
+      error instanceof Error ? error.message : error,
+    );
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error('❌ 予期しないエラー:', error);
+    process.exit(1);
+  });
+}
+
+export { main as configGlobal };