@sk8metal/michi-cli 0.8.4 → 0.8.5

package/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.5] - 2025-12-22
+
+### Added
+
+- **Multi-Repo AI支援コマンド**: AI駆動によるMulti-Repoプロジェクトの初期化・要件定義・設計書生成
+  - `/michi_multi_repo:spec-init`: プロジェクト説明から自動初期化、spec.jsonでメタデータ管理
+    - プロジェクト名の自動生成（feature-name形式）
+    - ディレクトリ構造の自動作成（`docs/michi/{project-name}/`）
+    - テンプレートファイルの自動展開
+    - `.michi/config.json`への自動登録
+  - `/michi_multi_repo:spec-requirements`: EARS形式の要件定義書自動生成
+    - 登録リポジトリ情報の自動反映
+    - サービス構成図（Mermaid）の作成
+    - インターフェース要件の定義
+    - サービス間依存関係の明記
+  - `/michi_multi_repo:spec-design`: C4モデルに基づいた設計書自動生成
+    - システム全体図の自動生成
+    - サービス横断アーキテクチャの設計
+    - デプロイメントアーキテクチャの可視化
+    - セキュリティ・データモデルの設計
+  - テンプレート拡張: Multi-Repo固有テンプレート
+    - `templates/multi-repo/spec.json`: メタデータ管理（phase、approvals状態）
+    - `templates/multi-repo/overview/{requirements,architecture,sequence}.md`
+    - `templates/multi-repo/steering/multi-repo.md`
+    - `templates/multi-repo/tests/strategy.md`
+    - `templates/multi-repo/docs/{ci-status,release-notes}.md`
+  - コマンド配布機構: `templates/claude/commands/michi_multi_repo/`でGit管理
+
 ## [0.8.4] - 2025-12-20
 
 ### Fixed

package/README.md

@@ -452,6 +452,47 @@ APPROVAL_GATES_RELEASE=SM,部長
 
 ## 他のリポジトリでプロジェクトを進める
 
+### Multi-Repoプロジェクトの管理（NEW）
+
+**新機能**: 複数のGitHubリポジトリを単一プロジェクトとして統合管理するMulti-Repo機能が追加されました。
+
+**使用ケース**:
+- マイクロサービスアーキテクチャで複数のサービスリポジトリを管理
+- フロントエンド・バックエンド・インフラを別リポジトリで管理
+- 複数リポジトリのCI/CD状態を一元管理
+- 複数リポジトリの統合ドキュメントをConfluenceで管理
+
+**AI支援による初期化・設計（推奨）**:
+
+```bash
+# 1. AIでプロジェクト初期化（プロジェクト説明から自動生成）
+/michi_multi_repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
+
+# 2. リポジトリ登録（CLIコマンド）
+michi multi-repo:add-repo my-microservices --name frontend --url https://github.com/org/frontend --branch main
+michi multi-repo:add-repo my-microservices --name backend --url https://github.com/org/backend --branch main
+
+# 3. AIで要件定義書生成
+/michi_multi_repo:spec-requirements my-microservices
+
+# 4. AIで設計書生成（アーキテクチャ図含む）
+/michi_multi_repo:spec-design my-microservices
+
+# 5. Confluence同期
+michi multi-repo:confluence-sync my-microservices
+```
+
+**従来のCLIコマンドでの初期化**:
+
+```bash
+# CLIコマンドのみで初期化
+michi multi-repo:init my-microservices --jira MSV --confluence-space MSV
+michi multi-repo:add-repo my-microservices --name frontend --url https://github.com/org/frontend --branch main
+michi multi-repo:list  # プロジェクト確認
+```
+
+詳細は [Multi-Repo管理ガイド](./docs/user-guide/guides/multi-repo-guide.md) を参照してください。
+
 ### 推奨ワークフロー（cc-sdd準拠）
 
 既存リポジトリにMichiを導入する標準的な手順です：

package/docs/README.md

@@ -25,6 +25,7 @@ Michiを使った開発の実践的なガイドです。
 |------------|------|
 | [ワークフローガイド](./guides/workflow.md) ⭐ | AI開発フローの詳細 |
 | [フェーズ自動化ガイド](./guides/phase-automation.md) ⭐ | Confluence/JIRA自動作成 |
+| [Multi-Repo管理ガイド](./guides/multi-repo-guide.md) | マイクロサービス等複数リポジトリの統合管理、AI支援初期化・要件定義・設計 |
 | [マルチプロジェクト管理](./guides/multi-project.md) | 複数プロジェクトの同時管理 |
 | [カスタマイズガイド](./guides/customization.md) | Confluence/JIRA階層構造のカスタマイズ |
 

package/docs/user-guide/guides/multi-repo-guide.md

@@ -906,6 +906,119 @@ michi config:validate
 
 **A**: 現在、削除用のコマンドはありません。`.michi/config.json` を直接編集して該当プロジェクトを削除してください。将来のバージョンで削除コマンドを追加予定です。
 
+## AI支援要件定義・設計
+
+Multi-Repoプロジェクトでは、AI支援による要件定義・設計書の自動生成が可能です。
+
+### 前提条件
+
+- プロジェクトが初期化されていること（`/michi_multi_repo:spec-init` または `michi multi-repo:init`）
+- 1つ以上のリポジトリが登録されていること（`michi multi-repo:add-repo`）
+
+### 6. AIプロジェクト初期化（NEW）
+
+Multi-Repoプロジェクトを AI支援で初期化します。`michi multi-repo:init` の代替コマンドです。
+
+```bash
+/michi_multi_repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
+```
+
+**例**:
+```bash
+/michi_multi_repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
+```
+
+**機能**:
+- プロジェクト説明からプロジェクト名を自動生成
+- ディレクトリ構造を作成（`docs/michi/{project}/`）
+- メタデータファイル（`spec.json`）を作成
+- `.michi/config.json` の `multiRepoProjects` に登録
+- 初期テンプレートファイルを生成
+
+**出力**:
+- `docs/michi/{project}/spec.json` - メタデータ（phase: initialized）
+- `docs/michi/{project}/overview/requirements.md` - 要件定義書（初期化済み）
+- `docs/michi/{project}/overview/architecture.md` - 設計書（テンプレート）
+- `.michi/config.json` - multiRepoProjects に追加
+
+**`michi multi-repo:init` との違い**:
+- プロジェクト説明を入力して自動的にプロジェクト名を生成
+- spec.json でメタデータ管理（phase、承認状態等）
+- AIコマンドで一貫したワークフローを実現
+
+### 7. AI要件定義書の生成
+
+プロジェクトの要件定義書をAI支援で自動生成します。
+
+```bash
+/michi_multi_repo:spec-requirements <project-name>
+```
+
+**例**:
+```bash
+/michi_multi_repo:spec-requirements my-microservices
+```
+
+**生成される内容**:
+- プロジェクト概要
+- サービス構成（登録リポジトリ一覧、依存関係図）
+- インターフェース要件（API契約、イベント契約）
+- 機能要件（EARS形式）
+- 非機能要件（パフォーマンス、セキュリティ等）
+
+**出力先**: `docs/michi/{project}/overview/requirements.md`
+
+### 8. AI設計書の生成
+
+プロジェクトの技術設計書をAI支援で自動生成します。
+
+```bash
+/michi_multi_repo:spec-design <project-name> [-y]
+```
+
+**例**:
+```bash
+/michi_multi_repo:spec-design my-microservices
+```
+
+**生成される内容**:
+- システム全体図（C4モデル）
+- サービス横断アーキテクチャ
+- サービス間通信設計
+- 共有コンポーネント
+- デプロイメントアーキテクチャ
+- データフロー図
+
+**出力先**: `docs/michi/{project}/overview/architecture.md`
+
+**オプション**:
+- `-y`: 既存ファイルの上書きを自動承認
+
+### ワークフロー例（AIコマンド使用）
+
+```bash
+# 1. AI初期化（NEW - michi multi-repo:init の代替）
+/michi_multi_repo:spec-init "マイクロサービスアーキテクチャでECサイトを構築" --jira MSV --confluence-space MSV
+
+# 2. リポジトリ登録
+michi multi-repo:add-repo my-microservices --name frontend --url https://github.com/myorg/frontend --branch main
+michi multi-repo:add-repo my-microservices --name backend --url https://github.com/myorg/backend --branch main
+michi multi-repo:add-repo my-microservices --name database --url https://github.com/myorg/db-schema --branch main
+
+# 3. AI要件定義書生成（NEW）
+/michi_multi_repo:spec-requirements my-microservices
+
+# 4. AI設計書生成（NEW）
+/michi_multi_repo:spec-design my-microservices
+
+# 5. Confluence同期
+michi multi-repo:confluence-sync my-microservices --doc-type requirements
+michi multi-repo:confluence-sync my-microservices --doc-type architecture
+
+# 6. CI結果確認
+michi multi-repo:ci-status my-microservices
+```
+
 ## 関連ドキュメント
 
 - [ワークフローガイド](./workflow.md): Michiの全体的な開発ワークフロー

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",

package/templates/claude/commands/michi_multi_repo/spec-design.md

@@ -0,0 +1,296 @@
+---
+description: Multi-Repoプロジェクトの設計書をAI支援で生成
+allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch
+argument-hint: <project-name> [-y]
+---
+
+# Multi-Repo Design Generator
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの包括的な技術設計書を生成
+- **Success Criteria**:
+  - 全サービスのアーキテクチャを統合
+  - サービス間通信の設計を明確化
+  - 各サービスの技術スタックを反映
+  - C4モデルに基づいた視覚的な設計図を含む
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の技術設計書を生成します。
+
+## Execution Steps
+
+### Step 1: コンテキスト読み込み
+1. `.michi/config.json` からプロジェクト情報取得
+   - プロジェクト名、JIRAキー、Confluenceスペース
+   - 登録リポジトリ一覧
+2. `docs/michi/$1/overview/requirements.md` から要件読み込み
+   - 要件定義書が存在しない場合は、先に `/michi_multi_repo:spec-requirements $1` の実行を促す
+3. `.kiro/settings/rules/design-principles.md` から設計原則取得（存在する場合）
+4. `.kiro/settings/templates/specs/design.md` から構造参照（存在する場合）
+
+### Step 2: Discovery & Analysis
+
+**Multi-Repo固有の分析**:
+
+1. **各リポジトリの技術スタック調査**
+   - package.json / build.gradle / composer.json / requirements.txt
+   - 使用フレームワーク、ライブラリバージョン
+   - 依存関係の分析
+
+2. **サービス間通信パターンの特定**
+   - REST API / GraphQL / gRPC
+   - メッセージキュー / イベントバス（Kafka、RabbitMQ等）
+   - 同期通信 vs 非同期通信
+
+3. **共有コンポーネントの識別**
+   - 共通ライブラリ
+   - 共有データモデル
+   - 共通インフラストラクチャ（ログ、監視、認証等）
+
+4. **データフローの分析**
+   - サービス間のデータ連携
+   - データの永続化方式
+   - キャッシュ戦略
+
+### Step 3: 設計書生成
+
+以下のセクションを含む設計書を生成します：
+
+1. **システム全体図**
+   - C4モデル - システムコンテキスト図（Mermaid）
+   - 全サービスの配置とフロー
+   - 外部システムとの連携
+
+2. **サービス横断アーキテクチャ**
+   - マイクロサービス構成図（C4モデル推奨）
+   - サービス間API契約定義
+   - イベントスキーマ定義
+   - データフロー図
+
+3. **各サービスの設計**
+   - コンポーネント図
+   - インターフェース定義
+   - データモデル
+   - 主要クラス/モジュール構造
+
+4. **セキュリティ設計**
+   - 認証・認可の連携（OAuth2、JWT等）
+   - 通信暗号化（TLS、mTLS）
+   - シークレット管理
+
+5. **デプロイメントアーキテクチャ**
+   - インフラストラクチャ構成（Kubernetes、Docker等）
+   - ネットワーク設計
+   - スケーリング戦略
+
+6. **データモデル**
+   - サービス横断のデータフロー
+   - データベーススキーマ（サービスごと）
+   - データ整合性の保証方法
+
+### Step 4: ファイル保存
+- 出力先: `docs/michi/$1/overview/architecture.md`
+- 既存ファイルがある場合は、上書き確認（`-y` フラグで自動承認）
+
+### Step 5: メタデータ更新（spec.json）
+- `docs/michi/$1/spec.json` を読み込み
+- phase を `"design-generated"` に更新
+- `approvals.design.generated` を `true` に更新
+- `updated_at` を現在のISO 8601タイムスタンプに更新
+- spec.json を保存
+
+## Multi-Repo固有セクション
+
+設計書に以下のセクションを必ず含めること：
+
+```markdown
+## サービス横断アーキテクチャ
+
+### C4モデル - システムコンテキスト図
+
+\`\`\`mermaid
+C4Context
+    title System Context Diagram
+
+    Person(user, "User", "エンドユーザー")
+    System(frontend, "Frontend Service", "Webアプリケーション")
+    System(backend, "Backend Service", "APIサーバー")
+    System_Ext(external_api, "External API", "外部サービス")
+
+    Rel(user, frontend, "Uses", "HTTPS")
+    Rel(frontend, backend, "API calls", "REST/HTTPS")
+    Rel(backend, external_api, "Integrates", "REST/HTTPS")
+\`\`\`
+
+### サービス間通信
+
+| 呼び出し元 | 呼び出し先 | 方式 | プロトコル | 用途 |
+|-----------|-----------|------|-----------|------|
+| Frontend | API Gateway | 同期 | REST/HTTPS | ユーザーリクエスト処理 |
+| API Gateway | Auth Service | 同期 | gRPC | 認証・認可 |
+| User Service | Notification Service | 非同期 | Kafka | ユーザー作成イベント通知 |
+
+### 共有コンポーネント
+
+**共通ライブラリ**:
+- `@org/shared-types`: TypeScript型定義（全サービスで共有）
+- `@org/logger`: 統一ログライブラリ
+
+**共通インフラ**:
+- Elasticsearch: ログ集約
+- Prometheus + Grafana: メトリクス監視
+- Keycloak: 統合認証基盤
+
+### デプロイメントアーキテクチャ
+
+\`\`\`mermaid
+graph TB
+    subgraph "Production Kubernetes Cluster"
+        LB[Load Balancer]
+        FE1[Frontend Pod 1]
+        FE2[Frontend Pod 2]
+        BE1[Backend Pod 1]
+        BE2[Backend Pod 2]
+        DB[(PostgreSQL)]
+
+        LB --> FE1
+        LB --> FE2
+        FE1 --> BE1
+        FE2 --> BE2
+        BE1 --> DB
+        BE2 --> DB
+    end
+\`\`\`
+
+### データフロー
+
+\`\`\`mermaid
+sequenceDiagram
+    participant User
+    participant Frontend
+    participant API Gateway
+    participant Auth Service
+    participant User Service
+    participant Database
+
+    User->>Frontend: リクエスト
+    Frontend->>API Gateway: API呼び出し
+    API Gateway->>Auth Service: トークン検証
+    Auth Service-->>API Gateway: 検証成功
+    API Gateway->>User Service: ユーザー情報取得
+    User Service->>Database: クエリ実行
+    Database-->>User Service: データ返却
+    User Service-->>API Gateway: レスポンス
+    API Gateway-->>Frontend: レスポンス
+    Frontend-->>User: 表示
+\`\`\`
+```
+
+## Important Constraints
+- 実装詳細ではなく、アーキテクチャ設計に焦点を当てる
+- サービス間の境界とインターフェースを明確にする
+- 技術選定の理由を記述する
+- スケーラビリティとパフォーマンスを考慮
+- セキュリティ要件を設計に反映
+
+</instructions>
+
+## Tool Guidance
+- **Read first**: プロジェクト設定、要件定義書、設計原則、テンプレートを読み込み
+- **Glob/Grep**: 各リポジトリの技術スタック調査（ローカルクローンがある場合）
+- **Write last**: 設計書を最後に保存
+- **WebSearch/WebFetch**: 最新の設計パターンやベストプラクティスが必要な場合のみ使用
+
+## Output Description
+以下の情報を出力してください：
+
+1. **生成された設計書のパス**: `docs/michi/{project}/overview/architecture.md`
+2. **分析したリポジトリの一覧**: サービス名と技術スタックの要約
+3. **次のステップ**:
+   - 設計書の確認
+   - Confluence同期
+   - 各リポジトリでの個別実装
+
+**出力形式**:
+```markdown
+## 設計書生成完了
+
+### 出力ファイル
+`docs/michi/{project}/overview/architecture.md`
+
+### 分析したサービス
+- **Frontend**: React + TypeScript（3リポジトリ依存）
+- **Backend**: Node.js + Express（2リポジトリ依存）
+- **Auth Service**: Go + gRPC（独立）
+
+### アーキテクチャ概要
+- **通信方式**: REST API（同期）、Kafka（非同期イベント）
+- **データベース**: PostgreSQL（サービスごとにDB分離）
+- **デプロイ**: Kubernetes（Pod自動スケーリング）
+
+### 次のステップ
+1. 設計書を確認: `docs/michi/{project}/overview/architecture.md`
+2. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type architecture`
+3. 各リポジトリで実装を開始:
+   - `/kiro:spec-init` で個別仕様を作成
+   - または直接実装を開始
+```
+
+## Safety & Fallback
+
+### Error Scenarios
+- **要件定義書未作成**:
+  ```
+  エラー: 要件定義書が見つかりません: `docs/michi/{project}/overview/requirements.md`
+
+  先に要件定義書を生成してください：
+  /michi_multi_repo:spec-requirements {project}
+  ```
+
+- **プロジェクト未登録**:
+  ```
+  エラー: プロジェクト '{project}' が見つかりません。
+
+  次のコマンドでプロジェクトを初期化してください：
+  michi multi-repo:init {project} --jira {JIRA_KEY} --confluence-space {SPACE}
+  ```
+
+- **リポジトリアクセス不可**:
+  ```
+  警告: 一部のリポジトリのローカルクローンがありません。
+
+  設定情報（URL、ブランチ）から推測して設計書を生成します。
+  より詳細な設計が必要な場合は、リポジトリをクローンしてから再実行してください。
+  ```
+
+- **既存ファイル存在（`-y` フラグなし）**:
+  ```
+  警告: 既存の設計書が存在します: `docs/michi/{project}/overview/architecture.md`
+
+  上書きしてもよろしいですか？ (y/n)
+  または `-y` フラグを使用して自動承認できます。
+  ```
+
+### Fallback Strategy
+- **設計原則ファイル不在**: 基本的な設計原則（SOLID、DRY等）を適用
+- **技術スタック不明**: README や設定ファイルから推測、または "未指定" として記載
+- **依存関係不明**: 基本的なクライアント-サーバー構成を仮定
+- **テンプレート不在**: インラインで基本構造を使用
+
+### Next Phase: Implementation
+
+**設計書承認後**:
+1. 設計書を確認: `docs/michi/{project}/overview/architecture.md`
+2. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type architecture`
+3. **各リポジトリで個別実装**:
+   - リポジトリごとに `/kiro:spec-init` で仕様作成
+   - または直接実装を開始
+4. **CI/CD設定**: `michi multi-repo:ci-status {project}` でCI結果を監視
+
+**修正が必要な場合**:
+- フィードバックを提供し、`/michi_multi_repo:spec-design $1` を再実行
+- `-y` フラグで自動上書き可能
+
+think hard

package/templates/claude/commands/michi_multi_repo/spec-init.md

@@ -0,0 +1,228 @@
+---
+description: Multi-Repoプロジェクトを初期化し、プロジェクト説明とメタデータを設定
+allowed-tools: Bash, Glob, Read, Write, Edit
+argument-hint: "<project-description>" --jira <JIRA_KEY> --confluence-space <SPACE>
+---
+
+# Multi-Repo Specification Initialization
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの初期化（`michi multi-repo:init` の代替）
+- **Success Criteria**:
+  - プロジェクト説明からfeature-name形式のプロジェクト名を生成
+  - ディレクトリ構造を作成
+  - spec.jsonでメタデータ管理を開始
+  - `.michi/config.json` のmultiRepoProjectsに登録
+  - 次のステップ（リポジトリ登録、要件定義）への明確な誘導
+</background_information>
+
+<instructions>
+## Core Task
+プロジェクト説明 **$1** から Multi-Repoプロジェクトを初期化し、`michi multi-repo:init` と同等の機能をAIコマンドとして提供します。
+
+## 引数解析
+
+引数の形式:
+```
+/michi_multi_repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
+```
+
+パラメータ:
+- **$1**: プロジェクト説明（必須） - 例: "マイクロサービスアーキテクチャでECサイトを構築"
+- **--jira**: JIRAプロジェクトキー（必須） - 例: MSV
+- **--confluence-space**: Confluenceスペースキー（必須） - 例: MSV
+
+## Execution Steps
+
+### Step 1: 引数解析とバリデーション
+
+1. **プロジェクト説明の取得**: $1 からプロジェクト説明を抽出
+2. **JIRA/Confluenceキーの取得**:
+   - `--jira` オプションの値を取得（なければエラー）
+   - `--confluence-space` オプションの値を取得（なければエラー）
+3. **バリデーション**:
+   - JIRAキー: 2-10文字の大文字英字のみ（正規表現: `^[A-Z]{2,10}$`）
+   - Confluenceスペースキー: 空でない文字列
+
+### Step 2: プロジェクト名の生成
+
+1. **feature-name形式に変換**:
+   - プロジェクト説明から簡潔なプロジェクト名を生成
+   - 形式: 小文字英数字とハイフン（例: `my-microservices`, `ec-platform`）
+   - 日本語説明の場合は英語に変換
+
+2. **一意性チェック**:
+   - `.michi/config.json` の `multiRepoProjects` を確認
+   - 重複する場合は数値サフィックスを追加（例: `my-project-2`）
+
+### Step 3: ディレクトリ構造の作成
+
+以下のディレクトリとファイルを作成:
+
+```
+docs/michi/{project-name}/
+├── spec.json                    # メタデータファイル（NEW）
+├── overview/
+│   ├── requirements.md          # 要件定義書（プロジェクト説明を含む）
+│   ├── architecture.md          # アーキテクチャ設計書（テンプレート）
+│   └── sequence.md              # シーケンス図（テンプレート）
+├── steering/
+│   └── multi-repo.md            # ステアリングドキュメント（テンプレート）
+├── tests/
+│   ├── scripts/                 # テストスクリプト配置用
+│   ├── results/                 # テスト結果保存用
+│   ├── unit/
+│   ├── integration/
+│   ├── e2e/
+│   └── performance/
+└── docs/
+    ├── ci-status.md             # CI結果サマリー（テンプレート）
+    └── release-notes.md         # リリースノート（テンプレート）
+```
+
+### Step 4: メタデータ初期化
+
+1. **spec.jsonの生成**:
+   - テンプレート: `templates/multi-repo/spec.json`
+   - プレースホルダー置換:
+     - `{{PROJECT_NAME}}` → 生成されたプロジェクト名
+     - `{{CREATED_AT}}` → 現在のISO 8601タイムスタンプ
+     - `{{JIRA_KEY}}` → JIRAキー
+     - `{{CONFLUENCE_SPACE}}` → Confluenceスペースキー
+   - 出力先: `docs/michi/{project-name}/spec.json`
+
+2. **requirements.mdの初期化**:
+   - テンプレート: `templates/multi-repo/overview/requirements.md`
+   - 「概要」セクションにプロジェクト説明を記載
+   - プレースホルダー置換
+   - 出力先: `docs/michi/{project-name}/overview/requirements.md`
+
+3. **その他テンプレートファイルのレンダリング**:
+   - `templates/multi-repo/overview/architecture.md` → `docs/michi/{project-name}/overview/architecture.md`
+   - `templates/multi-repo/overview/sequence.md` → `docs/michi/{project-name}/overview/sequence.md`
+   - `templates/multi-repo/steering/multi-repo.md` → `docs/michi/{project-name}/steering/multi-repo.md`
+   - `templates/multi-repo/tests/strategy.md` → `docs/michi/{project-name}/tests/strategy.md`
+   - `templates/multi-repo/docs/ci-status.md` → `docs/michi/{project-name}/docs/ci-status.md`
+   - `templates/multi-repo/docs/release-notes.md` → `docs/michi/{project-name}/docs/release-notes.md`
+
+### Step 5: .michi/config.json の更新
+
+1. **config.jsonの読み込み**: `.michi/config.json` を読み込む
+2. **multiRepoProjects に追加**:
+   ```json
+   {
+     "name": "{project-name}",
+     "jiraKey": "{JIRA_KEY}",
+     "confluenceSpace": "{CONFLUENCE_SPACE}",
+     "createdAt": "{ISO 8601 timestamp}",
+     "repositories": []
+   }
+   ```
+3. **保存**: `.michi/config.json` を保存
+
+## Important Constraints
+- プロジェクト名は1-100文字、パストラバーサル文字（`/`, `\`, `..`）、制御文字は禁止
+- JIRAキーは2-10文字の大文字英字のみ
+- Confluenceスペースキーは空でない文字列
+- 既存プロジェクト名と重複する場合は数値サフィックスを自動追加
+- DO NOT generate requirements/design at this stage（要件・設計は後続コマンドで生成）
+
+</instructions>
+
+## Tool Guidance
+- **Glob**: `.michi/config.json` 存在確認、プロジェクト名の一意性チェック
+- **Read**: テンプレートファイル読み込み、config.json 読み込み
+- **Write**: spec.json、requirements.md、config.json、その他テンプレート出力
+- **Edit**: config.json の multiRepoProjects 配列に追加（必要に応じて）
+
+## Output Description
+日本語で以下の情報を出力してください:
+
+1. **生成されたプロジェクト名**: `{project-name}` 形式（1-2文で理由を説明）
+2. **プロジェクト概要**: プロジェクト説明の要約（1文）
+3. **作成されたファイル**: 箇条書きで主要ファイルのパス
+4. **次のステップ**: 次に実行すべきコマンド（リポジトリ登録、要件定義）
+
+**出力形式**:
+```markdown
+## Multi-Repoプロジェクト初期化完了
+
+### プロジェクト名
+`{project-name}`
+
+プロジェクト説明「{description}」から生成しました。
+
+### プロジェクト概要
+{プロジェクト説明の要約}
+
+### 作成されたファイル
+- `docs/michi/{project}/spec.json` - メタデータ（phase: initialized）
+- `docs/michi/{project}/overview/requirements.md` - 要件定義書（初期化済み）
+- `docs/michi/{project}/overview/architecture.md` - 設計書（テンプレート）
+- `.michi/config.json` - multiRepoProjects に登録
+
+### 次のステップ
+
+1. **リポジトリを登録**:
+   \`\`\`bash
+   michi multi-repo:add-repo {project} --name frontend --url https://github.com/org/frontend --branch main
+   michi multi-repo:add-repo {project} --name backend --url https://github.com/org/backend --branch main
+   \`\`\`
+
+2. **AI要件定義書を生成**:
+   \`\`\`bash
+   /michi_multi_repo:spec-requirements {project}
+   \`\`\`
+
+3. **AI設計書を生成**:
+   \`\`\`bash
+   /michi_multi_repo:spec-design {project}
+   \`\`\`
+
+4. **Confluenceに同期**:
+   \`\`\`bash
+   michi multi-repo:confluence-sync {project}
+   \`\`\`
+```
+
+## Safety & Fallback
+
+### Error Scenarios
+
+- **引数不足**:
+  ```
+  エラー: 必須パラメータが不足しています。
+
+  使用方法:
+  /michi_multi_repo:spec-init "<プロジェクト説明>" --jira <JIRA_KEY> --confluence-space <SPACE>
+
+  例:
+  /michi_multi_repo:spec-init "マイクロサービスでECサイト構築" --jira MSV --confluence-space MSV
+  ```
+
+- **JIRAキーが不正**:
+  ```
+  エラー: JIRAキーは2-10文字の大文字英字のみです（例: MSV, PROJ）
+  ```
+
+- **プロジェクト名重複**:
+  ```
+  警告: プロジェクト名 '{project-name}' は既に存在します。
+  自動的に '{project-name-2}' として作成しました。
+  ```
+
+- **config.json が存在しない**:
+  ```
+  エラー: .michi/config.json が見つかりません。
+
+  Michiプロジェクトのルートディレクトリで実行してください。
+  または、次のコマンドで初期設定を行ってください:
+  michi config:init
+  ```
+
+### Fallback Strategy
+- プロジェクト名生成が曖昧な場合: 2-3の候補を提示し、ユーザーに選択を求める
+- テンプレートファイル不在: エラーメッセージと対処方法を表示
+- ディレクトリ作成失敗: パーミッションまたはディスク容量の確認を促す
+
+think hard

package/templates/claude/commands/michi_multi_repo/spec-requirements.md

@@ -0,0 +1,198 @@
+---
+description: Multi-Repoプロジェクトの要件定義書をAI支援で生成
+allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch
+argument-hint: <project-name>
+---
+
+# Multi-Repo Requirements Generation
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの包括的な要件定義書をEARS形式で生成
+- **Success Criteria**:
+  - 登録された全リポジトリの情報を反映
+  - リポジトリ間の依存関係とインターフェースを明記
+  - EARS形式の受入基準を含む
+  - サービス構成図（Mermaid）を含む
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の要件定義書を生成します。
+
+## Execution Steps
+
+### Step 1: プロジェクト情報の取得
+1. `.michi/config.json` を読み込み、プロジェクト `$1` の情報を取得
+2. プロジェクトが登録されていない場合は、`michi multi-repo:init` の実行を促す
+3. 登録されたリポジトリ一覧を確認
+4. リポジトリ数が0の場合は警告を出し、基本構造のみ生成
+
+### Step 2: コンテキスト収集
+1. **EARS形式ルール**: `.kiro/settings/rules/ears-format.md` を読み込み
+   - EARS形式（Event-Action-Response-System）の構文を理解
+2. **既存要件テンプレート**: `templates/multi-repo/overview/requirements.md` を確認
+3. **各リポジトリの情報収集**:
+   - リポジトリ名、URL、ブランチ
+   - 技術スタック（package.json、build.gradle、composer.json等から推測）
+   - 主要機能（README.mdから抽出）
+   - 注: ローカルクローンがない場合は、設定情報から推測
+
+### Step 3: 要件定義書生成
+以下のセクションを含む要件定義書を生成します：
+
+1. **プロジェクト概要**
+   - プロジェクト名、JIRAキー、Confluenceスペース
+   - 複数リポジトリを統合したシステムの概要
+   - ビジネス価値
+
+2. **サービス構成**
+   - 登録リポジトリ一覧（表形式）
+   - サービス間依存関係（Mermaidダイアグラム）
+   - 各サービスの役割説明
+
+3. **インターフェース要件**
+   - サービス間API契約（エンドポイント一覧）
+   - イベント契約（Pub/Sub、メッセージキュー等）
+   - データフォーマット
+
+4. **機能要件**
+   - 各サービスの機能要件をEARS形式で記述
+   - サービス横断的な機能要件（認証、ログ集約等）
+
+5. **非機能要件**
+   - パフォーマンス要件（レスポンスタイム、スループット）
+   - セキュリティ要件（認証・認可、通信暗号化）
+   - 可用性要件（SLA、冗長化）
+   - 保守性要件（モニタリング、ログ）
+
+### Step 4: ファイル保存
+- 出力先: `docs/michi/$1/overview/requirements.md`
+- 既存ファイルがある場合は、上書き確認を実施
+- ファイル保存後、完了メッセージを表示
+
+### Step 5: メタデータ更新（spec.json）
+- `docs/michi/$1/spec.json` を読み込み
+- phase を `"requirements-generated"` に更新
+- `approvals.requirements.generated` を `true` に更新
+- `updated_at` を現在のISO 8601タイムスタンプに更新
+- spec.json を保存
+
+## Multi-Repo固有セクション
+要件定義書に以下のセクションを必ず含めること：
+
+```markdown
+## サービス構成
+
+### 登録リポジトリ一覧
+
+| サービス名 | リポジトリURL | ブランチ | 役割 | 技術スタック |
+|-----------|---------------|---------|------|-------------|
+| frontend | https://github.com/org/frontend | main | ユーザーインターフェース | React, TypeScript |
+| backend | https://github.com/org/backend | main | APIサーバー | Node.js, Express |
+
+### サービス間依存関係
+
+\`\`\`mermaid
+graph TB
+    A[Frontend] -->|REST API| B[API Gateway]
+    B -->|HTTP| C[Auth Service]
+    B -->|HTTP| D[User Service]
+    C -->|gRPC| E[Database]
+    D -->|gRPC| E
+\`\`\`
+
+## インターフェース要件
+
+### API契約
+
+**Auth Service → User Service**
+- エンドポイント: `POST /api/v1/auth/verify`
+- プロトコル: HTTP/REST
+- データ形式: JSON
+
+### イベント契約
+
+**User Service → Notification Service**
+- イベント: `user.created`
+- プロトコル: Kafka
+- スキーマ: { userId, email, createdAt }
+```
+
+## Important Constraints
+- EARS形式を厳守（When/If/While/Where/The system shall）
+- サービス名を明確にする（例: The Frontend Service shall...）
+- 要件はテスト可能であること
+- 実装詳細は含めない（WHAT、not HOW）
+
+</instructions>
+
+## Tool Guidance
+- **Read first**: プロジェクト設定、EARS形式ルール、テンプレートを読み込み
+- **Write last**: 要件定義書を最後に保存
+- **WebSearch/WebFetch**: 外部ドメイン知識が必要な場合のみ使用
+
+## Output Description
+以下の情報を出力してください：
+
+1. **生成された要件定義書のパス**: `docs/michi/{project}/overview/requirements.md`
+2. **含まれるリポジトリ/サービスの一覧**: サービス名と役割の要約
+3. **次のステップ**:
+   - `/michi_multi_repo:spec-design $1` で設計書を生成
+   - `michi multi-repo:confluence-sync $1 --doc-type requirements` でConfluenceに同期
+
+**出力形式**:
+```markdown
+## 要件定義書生成完了
+
+### 出力ファイル
+`docs/michi/{project}/overview/requirements.md`
+
+### 含まれるサービス
+- **Frontend**: ユーザーインターフェース（React）
+- **Backend**: APIサーバー（Node.js）
+- **Database**: データ永続化（PostgreSQL）
+
+### 次のステップ
+1. 要件定義書を確認: `docs/michi/{project}/overview/requirements.md`
+2. 設計書を生成: `/michi_multi_repo:spec-design {project}`
+3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type requirements`
+```
+
+## Safety & Fallback
+
+### Error Scenarios
+- **プロジェクト未登録**:
+  ```
+  エラー: プロジェクト '{project}' が見つかりません。
+
+  次のコマンドでプロジェクトを初期化してください：
+  michi multi-repo:init {project} --jira {JIRA_KEY} --confluence-space {SPACE}
+  ```
+
+- **リポジトリ未登録**:
+  ```
+  警告: プロジェクト '{project}' にリポジトリが登録されていません。
+
+  基本的な要件定義書の骨格を生成しますが、サービス固有の情報は含まれません。
+
+  次のコマンドでリポジトリを登録してください：
+  michi multi-repo:add-repo {project} --name {name} --url {url} --branch {branch}
+  ```
+
+- **既存ファイル存在**:
+  ```
+  警告: 既存の要件定義書が存在します: `docs/michi/{project}/overview/requirements.md`
+
+  上書きしてもよろしいですか？ (y/n)
+  ```
+
+- **EARS形式ルール未取得**:
+  - `.kiro/settings/rules/ears-format.md` が存在しない場合、基本的なEARS形式を使用
+  - 警告メッセージを表示
+
+### Fallback Strategy
+- ローカルクローンがないリポジトリ: 設定情報（名前、URL）のみから推測
+- 技術スタック不明: "未指定" として記載
+- 依存関係不明: 基本的なクライアント-サーバー構成を仮定
+
+think hard

package/templates/multi-repo/overview/architecture.md

@@ -95,6 +95,87 @@ erDiagram
 
 <!-- スケーラビリティ設計を記述してください -->
 
+## サービス横断アーキテクチャ
+
+<!-- AI生成コマンド（/michi_multi_repo:spec-design）を使用すると、自動的にサービス横断アーキテクチャが挿入されます -->
+
+### C4モデル - システムコンテキスト図
+
+```mermaid
+C4Context
+    title System Context Diagram
+
+    Person(user, "User", "エンドユーザー")
+    System(system, "{{PROJECT_NAME}}", "マルチリポジトリシステム")
+    System_Ext(external, "External System", "外部システム")
+
+    Rel(user, system, "Uses", "HTTPS")
+    Rel(system, external, "Integrates", "REST/HTTPS")
+```
+
+### サービス間通信
+
+<!-- AI生成コマンドを使用すると、サービス間通信の詳細が自動生成されます -->
+
+| 呼び出し元 | 呼び出し先 | 方式 | プロトコル | 用途 |
+|-----------|-----------|------|-----------|------|
+| Frontend | API Gateway | 同期 | REST/HTTPS | ユーザーリクエスト処理 |
+| Service A | Service B | 同期 | gRPC | サービス間通信 |
+| Service B | Service C | 非同期 | Kafka | イベント通知 |
+
+### 共有コンポーネント
+
+<!-- AI生成コマンドを使用すると、共有コンポーネントが自動的に抽出されます -->
+
+**共通ライブラリ**:
+- `@org/shared-types`: 型定義（全サービスで共有）
+- `@org/logger`: 統一ログライブラリ
+
+**共通インフラ**:
+- Elasticsearch: ログ集約
+- Prometheus + Grafana: メトリクス監視
+- 認証基盤: 統合認証サービス
+
+### デプロイメントアーキテクチャ
+
+```mermaid
+graph TB
+    subgraph "Production Environment"
+        LB[Load Balancer]
+        FE1[Frontend Pod 1]
+        FE2[Frontend Pod 2]
+        BE1[Backend Pod 1]
+        BE2[Backend Pod 2]
+        DB[(Database)]
+
+        LB --> FE1
+        LB --> FE2
+        FE1 --> BE1
+        FE2 --> BE2
+        BE1 --> DB
+        BE2 --> DB
+    end
+```
+
+### データフロー
+
+<!-- AI生成コマンドを使用すると、サービス間のデータフローシーケンス図が自動生成されます -->
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Frontend
+    participant Backend
+    participant Database
+
+    User->>Frontend: リクエスト
+    Frontend->>Backend: API呼び出し
+    Backend->>Database: クエリ実行
+    Database-->>Backend: データ返却
+    Backend-->>Frontend: レスポンス
+    Frontend-->>User: 表示
+```
+
 ## 変更履歴
 
 | 日付 | バージョン | 変更内容 | 担当者 |

package/templates/multi-repo/overview/requirements.md

@@ -61,6 +61,48 @@
 
 <!-- リスクと制限事項を記述してください -->
 
+## サービス構成
+
+### 登録リポジトリ一覧
+
+<!-- AI生成コマンド（/michi_multi_repo:spec-requirements）を使用すると、自動的に登録リポジトリ情報が挿入されます -->
+
+| サービス名 | リポジトリURL | ブランチ | 役割 | 技術スタック |
+|-----------|---------------|---------|------|-------------|
+| <!-- 例: frontend --> | <!-- 例: https://github.com/org/frontend --> | <!-- 例: main --> | <!-- 例: ユーザーインターフェース --> | <!-- 例: React, TypeScript --> |
+
+### サービス間依存関係
+
+<!-- AI生成コマンドを使用すると、サービス間の依存関係図が自動生成されます -->
+
+```mermaid
+graph TB
+    A[Service A] -->|API| B[Service B]
+    B -->|gRPC| C[Service C]
+```
+
+## インターフェース要件
+
+### API契約
+
+<!-- サービス間のAPI契約を記述してください -->
+<!-- AI生成コマンドを使用すると、要件定義書から自動的にAPI契約が抽出されます -->
+
+**サービスA → サービスB**
+- エンドポイント: `POST /api/v1/resource`
+- プロトコル: HTTP/REST
+- データ形式: JSON
+
+### イベント契約
+
+<!-- Pub/Subイベントのスキーマを記述してください -->
+<!-- AI生成コマンドを使用すると、イベント駆動設計のスキーマが自動生成されます -->
+
+**サービスA → サービスB**
+- イベント: `resource.created`
+- プロトコル: Kafka / RabbitMQ
+- スキーマ: { resourceId, name, createdAt }
+
 ## 変更履歴
 
 | 日付 | バージョン | 変更内容 | 担当者 |

package/templates/multi-repo/spec.json

@@ -0,0 +1,20 @@
+{
+  "project_name": "{{PROJECT_NAME}}",
+  "created_at": "{{CREATED_AT}}",
+  "updated_at": "{{CREATED_AT}}",
+  "language": "ja",
+  "phase": "initialized",
+  "jira_key": "{{JIRA_KEY}}",
+  "confluence_space": "{{CONFLUENCE_SPACE}}",
+  "approvals": {
+    "requirements": {
+      "generated": false,
+      "approved": false
+    },
+    "design": {
+      "generated": false,
+      "approved": false
+    }
+  },
+  "ready_for_implementation": false
+}