@sk8metal/michi-cli 0.8.4 → 0.8.6

package/CHANGELOG.md

@@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.6] - 2025-12-22
+
+### Fixed
+
+- **Multi-Repo templates not copied to dist during build** (#118)
+  - Fixed `michi multi-repo:init` failing with "Multi-Repo template not found" error
+  - Added `copyDirectory()` function to `scripts/copy-static-assets.js` to recursively copy template directories
+  - `templates/multi-repo/` is now correctly copied to `dist/templates/multi-repo/` during build
+  - All Multi-Repo templates (requirements.md, architecture.md, sequence.md, etc.) are now properly included in npm package
+
+## [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

@@ -4,6 +4,7 @@
 
 AI駆動開発ワークフロー自動化プラットフォーム
 
+[![npm version](https://badge.fury.io/js/@sk8metal%2Fmichi-cli.svg?icon=si%3Anpm)](https://badge.fury.io/js/@sk8metal%2Fmichi-cli)
 [![CI](https://github.com/sk8metalme/michi/actions/workflows/ci.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/ci.yml)
 [![Test Setup](https://github.com/sk8metalme/michi/actions/workflows/test-setup.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/test-setup.yml)
 [![Security](https://github.com/sk8metalme/michi/actions/workflows/security.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/security.yml)
@@ -452,6 +453,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/dist/templates/multi-repo/docs/ci-status.md

@@ -0,0 +1,51 @@
+# {{PROJECT_NAME}} - CI Status
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **最終更新**: {{CREATED_AT}}
+
+## CI結果サマリー
+
+| リポジトリ名 | ビルドステータス | テストステータス | カバレッジ | 最終実行日時 | 失敗詳細 |
+|------------|---------------|---------------|----------|------------|----------|
+| <!-- リポジトリ名 --> | <!-- ✅/❌/⏳/❓ --> | <!-- ✅/❌/⏳/❓ --> | <!-- XX% --> | <!-- YYYY-MM-DD HH:mm:ss --> | <!-- GitHub URL --> |
+
+<!-- 
+ステータスアイコン:
+- ✅ success: ビルド・テスト成功
+- ❌ failure: ビルド・テスト失敗
+- ⏳ running: 実行中
+- ❓ unknown: 不明・未実行
+
+このファイルは `multi-repo:ci-status <project-name>` コマンドで自動更新されます。
+-->
+
+## 統計情報
+
+- **総リポジトリ数**: 0
+- **成功**: 0
+- **失敗**: 0
+- **実行中**: 0
+- **不明**: 0
+
+## 注意事項
+
+このドキュメントは自動生成されます。手動で編集しないでください。
+最新のCI結果を取得するには、以下のコマンドを実行してください:
+
+```bash
+npm run michi multi-repo:ci-status {{PROJECT_NAME}}
+```
+
+差分表示オプション:
+
+```bash
+npm run michi multi-repo:ci-status {{PROJECT_NAME}} --diff
+```
+
+## 変更履歴
+
+自動生成のため、変更履歴は記録されません。

package/dist/templates/multi-repo/docs/release-notes.md

@@ -0,0 +1,99 @@
+# {{PROJECT_NAME}} - リリースノート
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## リリースノート一覧
+
+### バージョン 1.0.0 (YYYY-MM-DD)
+
+#### 新機能 (New Features)
+
+- <!-- 新機能を記述してください -->
+
+#### 改善 (Improvements)
+
+- <!-- 改善内容を記述してください -->
+
+#### バグ修正 (Bug Fixes)
+
+- <!-- バグ修正を記述してください -->
+
+#### Breaking Changes
+
+- <!-- 破壊的変更を記述してください（ない場合は「なし」） -->
+
+#### 既知の問題 (Known Issues)
+
+- <!-- 既知の問題を記述してください -->
+
+---
+
+## リリースノート作成ガイド
+
+### 新機能 (New Features)
+
+ユーザーに提供される新しい機能を記述します。
+
+**フォーマット例**:
+```
+- [機能名] 簡潔な説明 (関連JIRA: {{JIRA_KEY}}-XXX)
+```
+
+### 改善 (Improvements)
+
+既存機能の改善、パフォーマンス向上、UX改善などを記述します。
+
+**フォーマット例**:
+```
+- [改善内容] 詳細説明 (関連JIRA: {{JIRA_KEY}}-XXX)
+```
+
+### バグ修正 (Bug Fixes)
+
+修正されたバグを記述します。
+
+**フォーマット例**:
+```
+- [バグの内容] 修正内容 (関連JIRA: {{JIRA_KEY}}-XXX)
+```
+
+### Breaking Changes
+
+既存の動作を変更する破壊的変更を記述します。
+マイグレーション手順を含めてください。
+
+**フォーマット例**:
+```
+- [変更内容] 影響範囲とマイグレーション手順 (関連JIRA: {{JIRA_KEY}}-XXX)
+```
+
+### 既知の問題 (Known Issues)
+
+リリース時点で既知の問題を記述します。
+回避策や対応予定を含めてください。
+
+**フォーマット例**:
+```
+- [問題の内容] 回避策または対応予定 (関連JIRA: {{JIRA_KEY}}-XXX)
+```
+
+---
+
+## Confluence同期
+
+このリリースノートをConfluenceに同期するには、以下のコマンドを実行してください:
+
+```bash
+npm run michi multi-repo:sync {{PROJECT_NAME}} --doc release-notes
+```
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

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

@@ -0,0 +1,183 @@
+# {{PROJECT_NAME}} - アーキテクチャ設計書
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## システム構成図
+
+```mermaid
+graph TB
+    A[クライアント] --> B[APIゲートウェイ]
+    B --> C[バックエンドサービス]
+    C --> D[データベース]
+    C --> E[外部API]
+```
+
+<!-- システム構成図を更新してください -->
+
+## アーキテクチャパターン
+
+<!-- 採用するアーキテクチャパターンを記述してください -->
+<!-- 例: マイクロサービス、レイヤードアーキテクチャ、ヘキサゴナルアーキテクチャ -->
+
+### レイヤー構成
+
+<!-- レイヤー構成を記述してください -->
+
+## コンポーネント図
+
+```mermaid
+graph LR
+    subgraph "プレゼンテーション層"
+        A[UI Component]
+    end
+    
+    subgraph "ビジネスロジック層"
+        B[Service Layer]
+    end
+    
+    subgraph "データアクセス層"
+        C[Repository]
+    end
+    
+    A --> B
+    B --> C
+```
+
+<!-- コンポーネント図を更新してください -->
+
+## 技術スタック
+
+### フロントエンド
+
+<!-- フロントエンド技術スタックを記述してください -->
+
+### バックエンド
+
+<!-- バックエンド技術スタックを記述してください -->
+
+### データベース
+
+<!-- データベース技術スタックを記述してください -->
+
+### インフラストラクチャ
+
+<!-- インフラストラクチャを記述してください -->
+
+## データモデル
+
+<!-- データモデルを記述してください -->
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        string id
+        string name
+        string email
+    }
+    ORDER {
+        string id
+        string userId
+        date createdAt
+    }
+```
+
+## セキュリティアーキテクチャ
+
+<!-- セキュリティアーキテクチャを記述してください -->
+
+## スケーラビリティ設計
+
+<!-- スケーラビリティ設計を記述してください -->
+
+## サービス横断アーキテクチャ
+
+<!-- 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: 表示
+```
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

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

@@ -0,0 +1,110 @@
+# {{PROJECT_NAME}} - 要件定義書
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## 概要
+
+このドキュメントは、{{PROJECT_NAME}}プロジェクトの要件定義書です。
+
+## ビジネス価値
+
+<!-- プロジェクトのビジネス価値を記述してください -->
+
+### 対象ユーザー
+
+<!-- 対象ユーザーを記述してください -->
+- プロジェクトリーダー
+- アーキテクト
+- 開発者
+- QAエンジニア
+
+### 主要機能
+
+<!-- 主要機能を記述してください -->
+
+## 受入基準（EARS形式）
+
+### 必須要件
+
+<!-- EARS形式（Event-Action-Response-System）で受入基準を記述してください -->
+<!-- 例: -->
+<!-- - WHEN ユーザーがプロジェクトを初期化する際、IF プロジェクト名が有効である場合、THEN システムはプロジェクトディレクトリを作成し、成功メッセージを表示する。 -->
+
+### 任意要件
+
+<!-- 任意要件を記述してください -->
+
+## 技術的制約
+
+<!-- 技術的制約を記述してください -->
+
+## 非機能要件
+
+### パフォーマンス要件
+
+<!-- パフォーマンス要件を記述してください -->
+
+### セキュリティ要件
+
+<!-- セキュリティ要件を記述してください -->
+
+### 保守性要件
+
+<!-- 保守性要件を記述してください -->
+
+## リスクと制限事項
+
+<!-- リスクと制限事項を記述してください -->
+
+## サービス構成
+
+### 登録リポジトリ一覧
+
+<!-- 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 }
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

package/dist/templates/multi-repo/overview/sequence.md

@@ -0,0 +1,79 @@
+# {{PROJECT_NAME}} - シーケンス図
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## 主要フローのシーケンス図
+
+### ユーザー登録フロー
+
+```mermaid
+sequenceDiagram
+    participant U as ユーザー
+    participant F as フロントエンド
+    participant B as バックエンド
+    participant DB as データベース
+    
+    U->>F: 登録情報を入力
+    F->>B: POST /api/users
+    B->>DB: ユーザー情報を保存
+    DB-->>B: 保存成功
+    B-->>F: ユーザーID返却
+    F-->>U: 登録完了メッセージ表示
+```
+
+<!-- ユーザー登録フローを更新してください -->
+
+### データ取得フロー
+
+```mermaid
+sequenceDiagram
+    participant U as ユーザー
+    participant F as フロントエンド
+    participant B as バックエンド
+    participant DB as データベース
+    participant C as キャッシュ
+    
+    U->>F: データリクエスト
+    F->>B: GET /api/data
+    B->>C: キャッシュ確認
+    alt キャッシュヒット
+        C-->>B: キャッシュデータ返却
+    else キャッシュミス
+        B->>DB: データクエリ
+        DB-->>B: データ返却
+        B->>C: キャッシュ保存
+    end
+    B-->>F: データ返却
+    F-->>U: データ表示
+```
+
+<!-- データ取得フローを更新してください -->
+
+### エラーハンドリングフロー
+
+```mermaid
+sequenceDiagram
+    participant U as ユーザー
+    participant F as フロントエンド
+    participant B as バックエンド
+    participant L as ログサービス
+    
+    U->>F: リクエスト送信
+    F->>B: API呼び出し
+    B-->>F: エラーレスポンス(500)
+    F->>L: エラーログ記録
+    F-->>U: エラーメッセージ表示
+```
+
+<!-- エラーハンドリングフローを更新してください -->
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

package/dist/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
+}