@sk8metal/michi-cli 0.8.4 → 0.8.6

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
+}