@sk8metal/michi-cli 0.8.4 → 0.8.6

package/dist/templates/multi-repo/steering/multi-repo.md

@@ -0,0 +1,74 @@
+# {{PROJECT_NAME}} - Multi-Repo プロジェクトステアリング
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## Multi-Repo 開発ガイドライン
+
+### リポジトリ管理方針
+
+<!-- リポジトリ管理方針を記述してください -->
+
+#### ブランチ戦略
+
+- **main/master**: 本番環境相当（常にデプロイ可能な状態）
+- **develop**: 開発環境（次回リリース予定の機能を統合）
+- **feature/**: 機能開発用
+- **bugfix/**: バグ修正用
+- **hotfix/**: 緊急修正用
+
+#### コミットメッセージ規約
+
+- `feat:` 新機能
+- `fix:` バグ修正
+- `docs:` ドキュメント
+- `style:` フォーマット
+- `refactor:` リファクタリング
+- `test:` テスト
+- `chore:` その他
+
+### CI/CD パイプライン
+
+#### Phase A: PR作成前の自動テスト
+
+- 単体テスト実行
+- Lint実行
+- ビルド実行
+
+#### Phase B: リリース準備テスト
+
+- 統合テスト実行
+- E2Eテスト実行
+- パフォーマンステスト実行
+- セキュリティテスト実行
+
+### コードレビュー基準
+
+<!-- コードレビュー基準を記述してください -->
+
+### テスト戦略
+
+<!-- テスト戦略を記述してください -->
+
+### セキュリティポリシー
+
+<!-- セキュリティポリシーを記述してください -->
+
+### パフォーマンス要件
+
+<!-- パフォーマンス要件を記述してください -->
+
+## リポジトリ一覧
+
+<!-- このプロジェクトに属するリポジトリを記述してください -->
+<!-- multi-repo:add-repo コマンドでリポジトリを追加できます -->
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

package/dist/templates/multi-repo/tests/strategy.md

@@ -0,0 +1,89 @@
+# {{PROJECT_NAME}} - テスト戦略
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}
+
+## テスト戦略概要
+
+このドキュメントは、{{PROJECT_NAME}}プロジェクトのテスト戦略を定義します。
+
+## テストタイプ
+
+### 単体テスト (Unit Test)
+
+- **実行タイミング**: PR作成前（Phase A）
+- **カバレッジ目標**: 95%以上
+- **実行コマンド**: `npm test`
+- **テストフレームワーク**: <!-- テストフレームワークを記述 -->
+
+### 統合テスト (Integration Test)
+
+- **実行タイミング**: リリース準備時（Phase B）
+- **カバレッジ目標**: 主要フローのカバー
+- **実行コマンド**: `npm run test:integration`
+- **テスト対象**: <!-- テスト対象を記述 -->
+
+### E2Eテスト (End-to-End Test)
+
+- **実行タイミング**: リリース準備時（Phase B）
+- **カバレッジ目標**: クリティカルユーザーフロー
+- **実行コマンド**: `npm run test:e2e`
+- **テストツール**: <!-- テストツールを記述 -->
+
+### パフォーマンステスト (Performance Test)
+
+- **実行タイミング**: リリース準備時（Phase B）
+- **目標**: <!-- パフォーマンス目標を記述 -->
+- **実行コマンド**: `npm run test:performance`
+- **測定項目**: レスポンスタイム、スループット、リソース使用量
+
+### セキュリティテスト (Security Test)
+
+- **実行タイミング**: リリース準備時（Phase B）
+- **テスト項目**:
+  - パストラバーサル攻撃
+  - 制御文字インジェクション
+  - コマンドインジェクション
+  - SQLインジェクション
+  - XSS攻撃
+- **実行コマンド**: `npm run test:security`
+
+## Phase A: PR前自動テスト
+
+PR作成前に自動実行されるテスト:
+
+- [ ] 単体テスト
+- [ ] Lint
+- [ ] 型チェック
+- [ ] ビルド
+
+## Phase B: リリース準備テスト
+
+リリース前に手動実行するテスト:
+
+- [ ] 統合テスト
+- [ ] E2Eテスト
+- [ ] パフォーマンステスト
+- [ ] セキュリティテスト
+
+## テストデータ管理
+
+<!-- テストデータ管理方針を記述してください -->
+
+## テスト環境
+
+<!-- テスト環境を記述してください -->
+
+## 継続的改善
+
+<!-- 継続的改善方針を記述してください -->
+
+## 変更履歴
+
+| 日付 | バージョン | 変更内容 | 担当者 |
+|------|-----------|---------|--------|
+| {{CREATED_AT}} | 1.0.0 | 初版作成 | - |

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.6",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",

package/scripts/copy-static-assets.js

@@ -1,10 +1,10 @@
 /**
- * ビルド時に静的アセット（JSON等）をdistディレクトリにコピー
- * tscはTypeScriptのトランスパイルのみで、JSONファイルは自動コピーされないため
+ * ビルド時に静的アセット（JSON等、テンプレート）をdistディレクトリにコピー
+ * tscはTypeScriptのトランスパイルのみで、JSONやテンプレートファイルは自動コピーされないため
  */
 
-import { copyFileSync, mkdirSync, existsSync } from 'fs';
-import { dirname, resolve } from 'path';
+import { copyFileSync, mkdirSync, existsSync, readdirSync, statSync } from 'fs';
+import { dirname, resolve, join } from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -37,6 +37,51 @@ function copyFile(src, dest) {
   }
 }
 
+/**
+ * ディレクトリを再帰的にコピー
+ */
+function copyDirectory(srcDir, destDir) {
+  const srcPath = resolve(projectRoot, srcDir);
+  const destPath = resolve(projectRoot, destDir);
+
+  if (!existsSync(srcPath)) {
+    console.error(`❌ Source directory not found: ${srcPath}`);
+    process.exit(1);
+  }
+
+  if (!statSync(srcPath).isDirectory()) {
+    console.error(`❌ Source is not a directory: ${srcPath}`);
+    process.exit(1);
+  }
+
+  // コピー先のディレクトリを作成
+  if (!existsSync(destPath)) {
+    mkdirSync(destPath, { recursive: true });
+  }
+
+  try {
+    const entries = readdirSync(srcPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcEntryPath = join(srcPath, entry.name);
+      const destEntryPath = join(destPath, entry.name);
+
+      if (entry.isDirectory()) {
+        // ディレクトリの場合は再帰的にコピー
+        copyDirectory(srcEntryPath, destEntryPath);
+      } else {
+        // ファイルの場合はコピー
+        copyFileSync(srcEntryPath, destEntryPath);
+        console.log(`✅ Copied: ${entry.name}`);
+      }
+    }
+    console.log(`📁 Directory copied: ${srcDir} → ${destDir}`);
+  } catch (error) {
+    console.error(`❌ Failed to copy directory ${srcDir}:`, error.message);
+    process.exit(1);
+  }
+}
+
 // コピー対象のファイル一覧
 const filesToCopy = [
   {
@@ -45,6 +90,18 @@ const filesToCopy = [
   }
 ];
 
+// コピー対象のディレクトリ一覧
+const directoriesToCopy = [
+  {
+    src: 'templates/multi-repo',
+    dest: 'dist/templates/multi-repo'
+  }
+];
+
 console.log('📦 Copying static assets...');
 filesToCopy.forEach(({ src, dest }) => copyFile(src, dest));
+
+console.log('📁 Copying template directories...');
+directoriesToCopy.forEach(({ src, dest }) => copyDirectory(src, dest));
+
 console.log('✅ All static assets copied successfully.');

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