@sk8metal/michi-cli 0.3.0 → 0.5.0

package/docs/user-guide/getting-started/github-token-setup.md

@@ -230,9 +230,10 @@ nano .env
 # GitHub設定
 GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 GITHUB_ORG=your-organization  # または your-username
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **セキュリティ**:
 ```bash
 # .env ファイルのパーミッションを600に設定

package/docs/user-guide/getting-started/new-repository-setup.md

@@ -316,7 +316,7 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/20240115-payment-api
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/getting-started/quick-start.md

@@ -76,7 +76,7 @@ cat > .env <<EOF
 # GitHub設定（必須）
 GITHUB_TOKEN=your-github-token
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # JIRA設定（オプション）
 ATLASSIAN_URL=https://your-domain.atlassian.net

package/docs/user-guide/getting-started/setup.md

@@ -186,10 +186,37 @@ curl -o .env https://raw.githubusercontent.com/sk8metalme/michi/main/env.example
 wget -O .env https://raw.githubusercontent.com/sk8metalme/michi/main/env.example
 ```
 
-**注意**: 
+**注意**:
 - `.env` ファイルは作業するプロジェクトのルートディレクトリに作成されます
 - 別のディレクトリにいる場合は、まずプロジェクトルートに移動してください
 
+## Step 3.5: 設定の作成と管理
+
+Michiには2段階の設定があります。
+
+| 設定レベル | コマンド | 出力先 | タイミング |
+|---------|---------|--------|-----------|
+| **グローバル設定** | `npm run config:global` | `~/.michi/config.json` | 初回セットアップ時（推奨） |
+| **プロジェクト設定** | `michi init` または手動作成 | `.michi/config.json` | プロジェクトごとのカスタマイズ時 |
+
+### グローバル設定のメリット
+
+`npm run config:global` を使用すると、以下の設定を全プロジェクトで共有できます：
+- Confluence階層構造設定
+- JIRA Story作成粒度
+- ワークフロー承認ゲート
+
+### プロジェクト固有の設定
+
+プロジェクト固有の設定は以下の方法で作成できます：
+1. **自動コピー**: `michi init` 実行時にグローバル設定から自動コピー
+2. **手動作成**: グローバル設定をコピーして `.michi/config.json` として編集
+
+**推奨フロー:**
+1. 初回: `npm run config:global` でグローバル設定を作成
+2. プロジェクトごと: `michi init` で初期化（グローバル設定を自動コピー）
+3. カスタマイズ: 必要に応じて `.michi/config.json` を手動編集
+
 ### 3-2. 認証情報の設定
 
 `.env` ファイルを編集して、実際の認証情報を設定します：
@@ -203,8 +230,7 @@ ATLASSIAN_API_TOKEN=<ATLASSIANトークン>
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=<GitHubトークン>
-# 開発したいリポジトリ
-GITHUB_REPO=your-org/user-auth
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # Confluence設定
 CONFLUENCE_PRD_SPACE=PRD
@@ -258,15 +284,9 @@ SLACK_WEBHOOK_URL=<SlackWebhook URL>
 - **確認方法**: 3-3セクション「GitHub Token」を参照
 - **使用機能**: すべてのGitHub連携機能で認証に使用（API呼び出し時の認証トークン）
 
-**`GITHUB_REPO`**
-- **確認方法**: GitHubリポジトリのURLから取得
-- **確認手順**:
-  1. リポジトリのページにアクセス（例: `https://github.com/org/repo`）
-  2. URLの `/org/repo` 部分がリポジトリ名
-- **形式**: `組織名/リポジトリ名`
-- **例**: `sk8metalme/michi`
-- **使用機能**:
-  - PR自動作成（`michi github:create-pr`）: 指定されたリポジトリにPull Requestを作成（ワークフロー自動化で使用）
+> **Note**: リポジトリ情報（以前の `GITHUB_REPO` 環境変数）は `.kiro/project.json` の `repository` フィールドで管理されるようになりました。
+> 形式: `https://github.com/org/repo.git` または `git@github.com:org/repo.git`
+> 例: `.kiro/project.json` に `"repository": "https://github.com/sk8metalme/michi.git"` と設定
 
 ##### Confluence設定
 
@@ -783,8 +803,9 @@ APPROVAL_GATES_RELEASE=リリースマネージャー,QAリード,部長
 
 1. **`spec.json`**: 機能固有の設定（最優先）
 2. **`.michi/config.json`**: プロジェクト固有の設定
-3. **環境変数**: システム環境変数または`.env`ファイル
-4. **デフォルト値**: スキーマで定義されたデフォルト値
+3. **`~/.michi/config.json`**: グローバル設定
+4. **環境変数**: システム環境変数または`.env`ファイル
+5. **デフォルト値**: スキーマで定義されたデフォルト値
 
 #### よくある設定パターン
 

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

@@ -43,7 +43,7 @@ Michiは[cc-sdd](https://github.com/gotalab/cc-sdd)をベースとしており
 | カスタマイズ種類 | 対象 | 設定場所 | コマンド |
 |----------------|------|---------|---------|
 | **cc-sdd** | ドキュメント構造・AI判断基準 | `.kiro/settings/templates/`, `.kiro/settings/rules/`, `.kiro/steering/` | `/kiro:steering-custom` |
-| **Michi** | Confluence/JIRA作成方法 | `.michi/config.json` | `michi config:interactive` |
+| **Michi** | Confluence/JIRA作成方法 | `.michi/config.json` | 手動編集または`npm run config:global` |
 
 **例**: 
 - 要件定義書の見出しを「要件 N:」から「REQ-N:」に変更 → **cc-sddのカスタマイズ**（`templates/requirements.md`を編集）
@@ -357,28 +357,81 @@ Confluenceスペース
 }
 ```
 
-## 対話式設定ツール
+## グローバル設定
 
-`.michi/config.json`を対話的に作成・更新できます：
+全プロジェクトで共通の設定は、グローバル設定として保存できます。
 
-```bash
-# 対話式設定ツールを実行
-npx @sk8metal/michi-cli config:interactive
+### グローバル設定の作成
 
-# または
-michi config:interactive
+```bash
+npm run config:global
 ```
 
+このツールで `~/.michi/config.json` を作成できます。
+
+### グローバル設定のメリット
+
+- 新規プロジェクトごとに同じ設定を繰り返し入力する必要がない
+- 組織標準の設定を統一できる
+- プロジェクト固有の設定で上書き可能
+
+### 設定の優先順位
+
+設定値は以下の優先順位で決定されます：
+
+1. **`spec.json`**: 機能固有の設定（最優先）
+2. **`.michi/config.json`**: プロジェクト固有の設定
+3. **`~/.michi/config.json`**: グローバル設定
+4. **環境変数**: システム環境変数または`.env`ファイル
+5. **デフォルト値**: スキーマで定義されたデフォルト値
+
 ### 使い方
 
-1. **コマンド実行**: `npx @sk8metal/michi-cli config:interactive`
-2. **設定項目を選択**: 
+1. **コマンド実行**: `npm run config:global`
+2. **設定項目を選択**:
    - Confluence設定のカスタマイズ
    - JIRA設定のカスタマイズ
    - ワークフロー設定のカスタマイズ
 3. **各設定を対話的に入力**: プロンプトに従って選択・入力
 4. **設定を確認**: 最終的な設定内容を確認
-5. **保存**: 設定ファイルを`.michi/config.json`に保存
+5. **保存**: 設定ファイルを`~/.michi/config.json`に保存
+
+### プロジェクト設定との使い分け
+
+- **グローバル設定（`~/.michi/config.json`）**: 組織全体で共通の設定（Confluence階層構造、JIRA Story作成粒度など）
+- **プロジェクト設定（`.michi/config.json`）**: プロジェクト固有の設定（特定プロジェクトのみカスタマイズが必要な場合）
+
+**推奨フロー**:
+1. 初回: `npm run config:global` でグローバル設定を作成
+2. プロジェクトごと: `michi init` で初期化（グローバル設定を自動コピー）
+3. カスタマイズ: 必要に応じて `.michi/config.json` を手動編集
+
+## プロジェクト固有の設定
+
+プロジェクト固有の`.michi/config.json`は以下の方法で作成できます：
+
+### 自動作成（推奨）
+
+```bash
+# プロジェクト初期化時にグローバル設定から自動コピー
+michi init
+```
+
+### 手動作成
+
+1. グローバル設定をコピー：
+```bash
+cp ~/.michi/config.json .michi/config.json
+```
+
+2. プロジェクト固有のカスタマイズを適用：
+   - Confluence設定のカスタマイズ
+   - JIRA設定のカスタマイズ
+   - ワークフロー設定のカスタマイズ
+
+3. 設定ファイルを保存
+
+**注意**: グローバル設定（`~/.michi/config.json`）を作成する場合は、`npm run config:global` を使用してください。
 
 ### 設定項目
 

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/hands-on/claude-agent-setup.md

@@ -187,9 +187,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -201,7 +202,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/claude-setup.md

@@ -173,9 +173,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -187,7 +188,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/cursor-setup.md

@@ -140,9 +140,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -154,7 +155,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/workflow-walkthrough.md

@@ -182,7 +182,10 @@ vim .env
 # 最低限、以下を設定:
 # GITHUB_TOKEN=your-token
 # GITHUB_ORG=your-org
-# GITHUB_REPO=your-org/your-repo
+```
+
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 ```
 
 詳細: [Cursor IDEセットアップガイド](./cursor-setup.md)

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. **デバッグ方法**