@sk8metal/michi-cli 0.0.4 → 0.0.6

package/docs/{customization-guide.md → guides/customization.md}

@@ -4,7 +4,50 @@
 
 ## 概要
 
-Michiでは、チームごとに異なる開発フローに対応するため、Confluence/JIRAの作成粒度やワークフロー設定をカスタマイズ可能にしています。
+Michiでは、チームやPJごとに異なる開発フローに対応するため、Confluence/JIRAの作成粒度やワークフロー設定をカスタマイズ可能にしています。
+
+## cc-sddのカスタマイズとの関係
+
+Michiは[cc-sdd](https://github.com/gotalab/cc-sdd)をベースとしており、カスタマイズには2つの種類があります：
+
+### 1. cc-sddのカスタマイズ（テンプレート・ルール）
+
+**対象**: AIが生成するドキュメントの構造や判断基準
+- **templates/**: `requirements.md`, `design.md`, `tasks.md`の構造・フォーマット
+- **rules/**: AIの判断基準・生成原則
+- **steering/**: プロジェクトメモリ（`/kiro:steering-custom`で作成）
+
+**詳細**: [cc-sdd カスタマイズガイド](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/customization-guide.md)
+
+**主なカスタマイズ内容**:
+- 要件定義書の見出し形式（日本語/英語/カスタム）
+- 設計ドキュメントのセクション構造
+- タスク分解の粒度と形式
+- EARS形式の要件記述ルール
+- カスタムSteeringドキュメント（API標準、セキュリティポリシーなど）
+
+### 2. Michiのカスタマイズ（設定ファイル）
+
+**対象**: Confluence/JIRAの作成方法やワークフロー設定
+- **`.michi/config.json`**: Confluence階層構造、JIRA Story作成粒度、承認ゲート設定
+
+**詳細**: 本ドキュメント（以下を参照）
+
+**主なカスタマイズ内容**:
+- Confluenceページの階層構造（フラット/階層/セクション分割）
+- JIRA Story作成粒度（全作成/フェーズごと/選択フェーズのみ）
+- ワークフロー承認ゲート設定
+
+### 使い分け
+
+| カスタマイズ種類 | 対象 | 設定場所 | コマンド |
+|----------------|------|---------|---------|
+| **cc-sdd** | ドキュメント構造・AI判断基準 | `.kiro/settings/templates/`, `.kiro/settings/rules/`, `.kiro/steering/` | `/kiro:steering-custom` |
+| **Michi** | Confluence/JIRA作成方法 | `.michi/config.json` | `michi config:interactive` |
+
+**例**: 
+- 要件定義書の見出しを「要件 N:」から「REQ-N:」に変更 → **cc-sddのカスタマイズ**（`templates/requirements.md`を編集）
+- Confluenceページを階層構造にする → **Michiのカスタマイズ**（`.michi/config.json`で設定）
 
 ## 設定ファイルの構造
 
@@ -14,9 +57,11 @@ Michiでは、チームごとに異なる開発フローに対応するため、
 
 ### プロジェクト固有設定
 
-`.kiro/config.json` - プロジェクトルートに配置（オプション）
+`.michi/config.json` - プロジェクトルートに配置（オプション）
+
+**重要**: `.michi/config.json`は`.gitignore`に追加することを推奨します（チーム固有設定のため）
 
-**重要**: `.kiro/config.json`は`.gitignore`に追加することを推奨します（チーム固有設定のため）
+**注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。
 
 ### 設定のマージ順序
 
@@ -26,7 +71,7 @@ Michiでは、チームごとに異なる開発フローに対応するため、
 
 ### 設定値の詳細
 
-すべての設定値の詳細は [設定値リファレンス](./config-reference.md) を参照してください。
+すべての設定値の詳細は [設定値リファレンス](../reference/config.md) を参照してください。
 
 ## Confluence階層構造のカスタマイズ
 
@@ -297,14 +342,14 @@ Confluenceスペース
 }
 ```
 
-### 承認ゲートの設定
+### 承認者の設定
 
 **設定例: 日本語ロール名を使用**
 ```json
 {
   "workflow": {
     "approvalGates": {
-      "requirements": ["企画", "部長"],
+      "requirements": ["PL", "部長"],
       "design": ["アーキテクト", "部長"],
       "release": ["SM", "部長"]
     }
@@ -314,7 +359,7 @@ Confluenceスペース
 
 ## 対話式設定ツール
 
-`.kiro/config.json`を対話的に作成・更新できます：
+`.michi/config.json`を対話的に作成・更新できます：
 
 ```bash
 # 対話式設定ツールを実行
@@ -333,7 +378,7 @@ npm run config:interactive
    - ワークフロー設定のカスタマイズ
 3. **各設定を対話的に入力**: プロンプトに従って選択・入力
 4. **設定を確認**: 最終的な設定内容を確認
-5. **保存**: 設定ファイルを`.kiro/config.json`に保存
+5. **保存**: 設定ファイルを`.michi/config.json`に保存
 
 ### 設定項目
 
@@ -341,7 +386,7 @@ npm run config:interactive
 - **ページタイトル形式**: カスタマイズ可能
 - **JIRA Story作成粒度**: 全作成/フェーズごと/選択フェーズのみ
 - **ワークフロー有効化フェーズ**: 要件定義/設計/タスク分割から選択
-- **承認ゲート**: 各フェーズの承認者を設定
+- **承認者**: 各フェーズの承認者を設定
 
 ## 設定ファイルのバリデーション
 
@@ -408,7 +453,7 @@ npm run config:validate
 
 ### 設定ファイルが読み込まれない
 
-1. `.kiro/config.json`がプロジェクトルートに存在するか確認
+1. `.michi/config.json`がプロジェクトルートに存在するか確認
 2. JSONの構文エラーがないか確認
 3. 設定ファイルのパスが正しいか確認
 
@@ -426,7 +471,14 @@ npm run config:validate
 
 ## 参考リンク
 
-- [セットアップガイド](./setup.md)
+### Michi関連
+- [セットアップガイド](../getting-started/setup.md)
 - [ワークフローガイド](./workflow.md)
-- [新規プロジェクトセットアップ](./new-project-setup.md)
+- [新規プロジェクトセットアップ](../getting-started/new-project-setup.md)
+- [設定値リファレンス](../reference/config.md)
+
+### cc-sdd関連
+- [cc-sdd カスタマイズガイド](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/customization-guide.md) - テンプレート・ルール・Steeringのカスタマイズ方法
+- [cc-sdd コマンドリファレンス](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/command-reference.md) - `/kiro:steering-custom`などのコマンド詳細
+- [cc-sdd Spec-Driven Guide](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/spec-driven.md) - 仕様駆動開発のワークフロー
 

package/docs/guides/multi-project.md

@@ -0,0 +1,365 @@
+# マルチプロジェクト管理ガイド
+
+> **凡例について**: `<feature>` などの記号の意味は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
+
+## 概要
+
+Michiは、複数プロジェクト（3-5案件）を同時並行で管理できるように設計されています。
+
+## アーキテクチャ
+
+### プロジェクト構成
+
+**構成**: 1つのリポジトリ内で複数プロジェクトを管理します。各プロジェクトは独立したディレクトリに配置され、それぞれに`.kiro/project.json`を持ちます。
+
+```
+repository/  ← 1つのGitHubリポジトリ
+├── projects/
+│   ├── 20240115-payment-api/  ← プロジェクトA
+│   │   └── .kiro/
+│   │       ├── project.json
+│   │       └── specs/
+│   ├── 20240201-user-management/  ← プロジェクトB
+│   │   └── .kiro/
+│   └── 20240310-analytics-api/  ← プロジェクトC
+│       └── .kiro/
+└── michi/  ← 統合ハブ（オプション）
+    └── .kiro/
+```
+
+**プロジェクト識別方法**:
+- 各プロジェクトディレクトリに`.kiro/project.json`を配置
+- 作業ディレクトリ（`process.cwd()`）から`.kiro/project.json`を読み込んでプロジェクトを識別
+- プロジェクト切り替えは、該当ディレクトリに移動するだけ
+
+### 統合管理
+
+**Confluence**: 共有スペース（PRD, QA, RELEASE）
+- ラベルでプロジェクトを識別
+- プロジェクト横断ダッシュボード
+
+**JIRA**: プロジェクトキー別
+- PRJA（プロジェクトA）
+- PRJB（プロジェクトB）
+- MICHI（統合ハブ）
+
+## プロジェクトのセットアップ
+
+### 新規プロジェクト追加
+
+詳細な手順は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md) を参照してください。
+
+**クイックスタート**:
+1. 既存リポジトリに追加: `bash /path/to/michi/scripts/setup-existing.sh`
+2. 新規リポジトリ作成: `npm run create-project -- --name <id> --project-name <name> --jira-key <key>`
+
+**マルチプロジェクト特有の注意点**:
+- 1つのリポジトリ内で複数プロジェクトを管理
+- 各プロジェクトは独立したディレクトリに配置
+- `.kiro/project.json`でプロジェクトを識別
+- Confluenceラベルでプロジェクト横断検索が可能
+- プロジェクト切り替えは、該当ディレクトリに移動するだけ
+
+### 環境変数設定
+
+各プロジェクトで`.env`ファイルを設定します。詳細は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md#step-5-環境変数設定) を参照してください。
+
+### 動作確認
+
+セットアップ完了後、プロジェクト情報を確認します：
+
+```bash
+# プロジェクト情報を表示
+cat .kiro/project.json
+
+# テスト機能で確認（オプション）
+/kiro:spec-init テスト機能
+/kiro:spec-requirements test-feature
+npx @michi/cli phase:run test-feature requirements
+```
+
+## プロジェクト切り替え
+
+### 現在のプロジェクトを確認
+
+作業中のプロジェクトを確認するには：
+
+```bash
+# 現在のディレクトリを確認
+pwd
+
+# プロジェクト情報を表示
+cat .kiro/project.json
+
+# プロジェクトIDのみ表示
+cat .kiro/project.json | grep projectId
+```
+
+### Cursorで切り替え
+
+Cursor IDE内でプロジェクトを切り替える場合：
+
+**対話式切り替え（推奨）**:
+```
+/kiro:project-switch
+```
+
+パラメータを指定しない場合、リポジトリ内のプロジェクトリストが表示され、対話的に選択できます：
+
+```
+📋 利用可能なプロジェクト:
+1. 20240115-payment-api (プロジェクトA サービス1) [active]
+2. 20240201-user-management (プロジェクトA サービス2) [active]
+3. 20240310-analytics-api (プロジェクトB API) [active]
+
+選択してください (1-3): 1
+
+✅ プロジェクト切り替え: 20240115-payment-api
+📁 ディレクトリ: projects/20240115-payment-api
+
+プロジェクト情報:
+  名前: プロジェクトA サービス1
+  JIRA: PRJA
+  Confluence Labels: project:20240115-payment-api, service:payment
+  ステータス: active
+```
+
+**直接指定**:
+```
+/kiro:project-switch 20240115-payment-api
+```
+
+**実行内容**:
+1. プロジェクトIDに対応するディレクトリを特定（`projects/20240115-payment-api`）
+2. 該当ディレクトリに移動（Cursorの作業ディレクトリを変更）
+3. `.kiro/project.json` を読み込んで表示
+4. プロジェクト情報を表示
+
+### ターミナルで切り替え
+
+ターミナルでプロジェクトを切り替える場合：
+
+```bash
+# リポジトリルートに移動
+cd /path/to/repository
+
+# プロジェクトAに切り替え
+cd projects/20240115-payment-api
+
+# プロジェクト情報を確認
+cat .kiro/project.json
+
+# プロジェクトBに切り替え
+cd ../20240310-analytics-api
+
+# プロジェクト情報を確認
+cat .kiro/project.json
+```
+
+**ショートカット**:
+```bash
+# プロジェクトディレクトリへのエイリアスを設定（.zshrc または .bashrc）
+alias pj-a='cd /path/to/repository/projects/20240115-payment-api'
+alias pj-b='cd /path/to/repository/projects/20240310-analytics-api'
+
+# 使用例
+pj-a
+cat .kiro/project.json
+```
+
+### 切り替え後の確認
+
+プロジェクト切り替え後、以下のコマンドで正しく切り替わったか確認：
+
+```bash
+# 現在のディレクトリを確認
+pwd
+
+# プロジェクト情報を表示
+cat .kiro/project.json
+
+# プロジェクトIDを確認
+cat .kiro/project.json | jq .projectId
+
+# 仕様書の一覧を確認
+ls -la .kiro/specs/
+```
+
+### よくあるトラブル
+
+#### プロジェクトが見つからない
+
+**症状**: `/kiro:project-switch`でエラーが発生する
+
+**原因と解決方法**:
+1. プロジェクトディレクトリが存在するか確認
+   ```bash
+   ls -la projects/
+   ```
+
+2. プロジェクトIDが正しいか確認
+   ```bash
+   cat projects/20240115-payment-api/.kiro/project.json | grep projectId
+   ```
+
+3. パスが正しいか確認（絶対パスまたはリポジトリルートからの相対パス）
+
+#### `.kiro/project.json`が見つからない
+
+**症状**: プロジェクトディレクトリに移動したが、`.kiro/project.json`が存在しない
+
+**解決方法**:
+1. プロジェクトディレクトリが正しいか確認
+2. `.kiro/project.json`を作成（[新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md)を参照）
+
+## プロジェクト横断操作
+
+### すべてのプロジェクトを一覧表示
+
+```bash
+npm run project:list
+```
+
+出力例：
+```
+📋 プロジェクト一覧:
+
+| プロジェクト | ID | ステータス | JIRA | チーム |
+|------------|-------|----------|------|--------|
+| Michi | michi | active | MICHI | @developer1 |
+| プロジェクトA サービス1 | 20240115-payment-api | active | PRJA | @dev1, @dev2 |
+| プロジェクトB API | 20240310-analytics-api | active | PRJB | @dev3 |
+
+合計: 3 プロジェクト
+```
+
+### リソースダッシュボード生成
+
+```bash
+npm run project:dashboard
+```
+
+Confluenceに「プロジェクトリソースダッシュボード」ページを作成します。
+
+### プロジェクト横断見積もり集計
+
+```bash
+npm run multi-estimate
+```
+
+すべてのプロジェクトの見積もりを集計し、Excelファイルに出力します。
+
+## Confluenceダッシュボード
+
+### プロジェクト一覧ページ
+
+Confluenceで作成：
+
+**ページタイトル**: プロジェクト一覧
+
+**コンテンツ**:
+```
+{report-table:space=PRD|label=requirements|columns=title,labels,status}
+```
+
+**フィルタ例**:
+- プロジェクトAのみ: `label = "project:20240115-payment-api"`
+- レビュー待ち: `status = "レビュー待ち"`
+- 設計フェーズ: `label = "design"`
+
+### JIRAダッシュボード
+
+**フィルタ**:
+```
+project IN (MICHI, PRJA, PRJB) AND status IN ("In Progress", "In Review")
+```
+
+**グルーピング**: プロジェクトキー別
+
+**集計**: ストーリーポイント合計
+
+## プロジェクト間の依存関係
+
+プロジェクトは基本的に独立していますが、共通基盤がある場合：
+
+### 共通ライブラリプロジェクト
+
+```
+shared-infrastructure/
+└── .kiro/
+    └── project.json
+        {
+          "projectId": "shared-infra",
+          "projectName": "共通基盤",
+          "jiraProjectKey": "INFRA",
+          ...
+        }
+```
+
+### 依存関係の記述
+
+各プロジェクトの `.kiro/project.json` に追加：
+```json
+{
+  "dependencies": ["shared-infra"],
+  "dependents": ["20240115-payment-api", "20240310-analytics-api"]
+}
+```
+
+## ベストプラクティス
+
+### 命名規則の統一
+
+**プロジェクトID**: `{YYYYMMDD}-{PJ名}`
+- 例: `20240115-payment-api`, `20240201-user-management`
+- 形式: `YYYYMMDD-{kebab-case-name}`
+- 開始日はプロジェクト開始日（YYYYMMDD形式、ハイフンなし）
+- プロジェクトディレクトリ名としても使用
+
+**JIRA プロジェクトキー**: 3-4文字
+- 例: `PRJA`, `PRJB`, `MICHI`
+
+**Confluenceラベル**: `project:{projectId}, service:{service}`
+- 例: `project:20240115-payment-api, service:payment`
+
+**ラベル生成ロジック**: 詳細は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md#ラベル生成ロジック) を参照してください。
+### チーム構成の明確化
+
+各プロジェクトの `team` フィールドに担当者を記載：
+```json
+{
+  "team": ["@tech-lead", "@frontend-dev", "@backend-dev"]
+}
+```
+
+### ステータス管理
+
+プロジェクトのステータスを適切に更新：
+- `active`: 開発中
+- `maintenance`: 保守フェーズ
+- `completed`: 完了
+- `inactive`: 休止中
+
+## トラブルシューティング
+
+### プロジェクトが一覧に表示されない
+
+`.kiro/project.json` が正しく作成されているか確認：
+```bash
+cat .kiro/project.json
+```
+
+### Confluenceで他のプロジェクトが見える
+
+ラベルでフィルタリング：
+```
+label = "project:michi"
+```
+
+### JIRA チケットが混在
+
+プロジェクトキーでフィルタリング：
+```
+project = MICHI
+```
+