@sk8metal/michi-cli 0.8.7 → 0.11.0

package/templates/claude/commands/michi-multi-repo/impl-all.md

@@ -0,0 +1,293 @@
+---
+description: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
+allowed-tools: Task, Bash, Read, Write, Glob, Grep
+argument-hint: <project-name> [--tasks <task-numbers>]
+---
+
+# Multi-Repo Implementation (All Repositories)
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
+- **Success Criteria**:
+  - 全リポジトリでTDD実装サイクルが完了
+  - テストカバレッジ95%以上
+  - 品質自動化（Lint/Type-check）パス
+  - PR作成可能な状態
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の全リポジトリで `/michi:spec-impl` を並行実行します。
+
+## 引数解析
+
+引数の形式:
+```
+/michi-multi-repo:impl-all <project-name> [--tasks <task-numbers>]
+```
+
+パラメータ:
+- **$1**: プロジェクト名（必須）
+- **--tasks**: 実行するタスク番号（オプション）
+  - 例: `--tasks 1,2,3` → タスク1-3のみ実行
+  - 省略時: 全タスクを実行
+
+## Execution Steps
+
+### Step 1: 前提条件確認
+
+1. `docs/michi/$1/reviews/` に最新のレビューレポートが存在するか確認
+
+2. 最新レビューの品質ゲート判定を確認
+   ```bash
+   grep "品質ゲート判定" docs/michi/$1/reviews/cross-repo-review-*.md | tail -1
+   ```
+
+3. **判定が「不合格」の場合**:
+   ```
+   ❌ エラー: 品質ゲート不合格
+
+   BLOCK問題が未解決です。実装を開始できません。
+
+   次のアクション:
+   1. BLOCK問題を修正
+   2. `/michi-multi-repo:spec-review $1` を再実行
+   3. 合格後に再度このコマンドを実行
+   ```
+
+4. **判定が「条件付き合格」の場合**:
+   ```
+   ⚠️ 警告: 品質ゲート条件付き合格
+
+   WARN問題が検出されています。このまま実装を開始しますか？ (y/n)
+
+   推奨: WARN問題を修正してから実装開始
+   ```
+
+### Step 2: コンテキスト読み込み
+
+1. `.michi/config.json` からプロジェクト情報取得
+
+2. 登録リポジトリの一覧を取得
+
+3. 各リポジトリの `localPath` を取得
+
+4. 各リポジトリのタスクファイル確認
+   - `{localPath}/.kiro/specs/{feature}/tasks.md`
+
+### Step 2.5: localPath 検証
+
+各リポジトリについて以下を確認:
+
+- ✅ localPathが設定されているか
+- ✅ ディレクトリが存在するか
+- ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
+- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
+- ⚠️ 設定されたブランチと現在のブランチが一致するか
+- ⚠️ 未コミット変更がないか
+
+**検証失敗時の対応**:
+- localPath未設定: 警告を出力し、該当リポジトリをスキップ
+- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
+- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
+- ブランチ不一致: 警告を出力（続行可能）
+- 未コミット変更: 警告を出力（続行可能）
+
+### Step 3: チェックポイント確認
+
+`docs/michi/$1/.checkpoint-impl.json` の存在を確認
+
+存在する場合:
+```
+⚠️ チェックポイントファイルが見つかりました
+
+前回の実装が中断された可能性があります。
+
+次のアクション:
+A) チェックポイントから再開（未完了リポジトリのみ処理）
+B) 最初から実行（チェックポイント削除）
+C) キャンセル
+
+選択 (A/B/C): _
+```
+
+### Step 4: サブエージェント並行起動
+
+**並行実行数**: 最大3並列
+
+repo-spec-executorサブエージェントを使用して、以下のリポジトリで実装を並行実行してください：
+
+**Repository 1**: {repo1.name}
+- LOCAL_PATH: {repo1.localPath}
+- PARENT_PROJECT: $1
+- FEATURE_NAME: {feature}
+- OPERATION: impl
+- TASKS: {指定されたtask-numbers または "all"}
+
+**Repository 2**: {repo2.name}
+- LOCAL_PATH: {repo2.localPath}
+- PARENT_PROJECT: $1
+- FEATURE_NAME: {feature}
+- OPERATION: impl
+- TASKS: {指定されたtask-numbers または "all"}
+
+（以下、登録されている全リポジトリ）
+
+**重要**: 各サブエージェントの完了を待ち、結果を集約してください。
+
+### Step 5: 結果集約とレポート
+
+各リポジトリの実行結果を集約:
+
+| リポジトリ | タスク進捗 | カバレッジ | Lint | Build | ステータス |
+|-----------|----------|-----------|------|-------|----------|
+| frontend  | 5/5      | 96%       | ✅   | ✅    | ✅ 完了  |
+| backend   | 8/8      | 98%       | ✅   | ✅    | ✅ 完了  |
+| shared    | 3/3      | 95%       | ✅   | ✅    | ✅ 完了  |
+
+**成功件数**: 3/3
+**全体カバレッジ**: 96.3%
+
+### Step 6: チェックポイント保存（失敗時）
+
+失敗したリポジトリがある場合、チェックポイントを保存:
+
+```json
+{
+  "projectName": "$1",
+  "operation": "impl",
+  "repositories": {
+    "frontend": {
+      "status": "completed",
+      "tasksCompleted": 5,
+      "tasksTotal": 5,
+      "coverage": 96,
+      "completedAt": "2025-12-23T11:00:00Z"
+    },
+    "backend": {
+      "status": "failed",
+      "tasksCompleted": 3,
+      "tasksTotal": 8,
+      "error": "Test failed: auth.test.ts",
+      "failedAt": "2025-12-23T11:10:00Z"
+    }
+  },
+  "savedAt": "2025-12-23T11:11:00Z"
+}
+```
+
+保存先: `docs/michi/$1/.checkpoint-impl.json`
+
+### Step 7: 次のアクション案内
+
+**全成功時**:
+```markdown
+🎉 全リポジトリで実装が完了しました
+
+### 実装サマリー
+
+| 指標 | 結果 |
+|------|------|
+| 完了リポジトリ | 3/3 |
+| 全体カバレッジ | 96.3% |
+| Lint/Build | ✅ All Pass |
+
+### 次のステップ
+
+1. 各リポジトリでPR作成:
+   各リポジトリで `/pr` コマンドを実行
+
+2. CI結果を監視:
+   `michi multi-repo:ci-status $1`
+
+3. PRマージ後、リリース準備:
+   - Confluenceリリース手順書作成
+   - JIRAリリースチケット起票
+```
+
+**一部失敗時**:
+```markdown
+⚠️ 一部のリポジトリで失敗しました
+
+### 失敗したリポジトリ
+- backend: Test failed: auth.test.ts (タスク3/8完了)
+
+### 対処方法
+
+1. 失敗箇所を確認:
+   ```bash
+   cd {backend.localPath}
+   npm test auth.test.ts
+   ```
+
+2. 修正後、チェックポイントから再開:
+   `/michi-multi-repo:impl-all $1`
+   （失敗したリポジトリのみ処理されます）
+```
+
+## Important Constraints
+- spec-review合格が前提（BLOCK問題がないこと）
+- 並行実行は最大3リポジトリ
+- TDDサイクル（RED-GREEN-REFACTOR）を遵守
+- テストカバレッジ95%以上を維持
+- 各リポジトリは独立して処理（依存関係なし）
+
+</instructions>
+
+## Tool Guidance
+- **Task**: repo-spec-executorサブエージェント起動に使用
+- **Read**: config.json、レビューレポート、タスクファイル読み込み
+- **Write**: チェックポイント保存
+- **Bash**: Git操作、カバレッジ確認
+
+## Output Description
+
+日本語で以下の情報を出力してください:
+
+1. **処理対象リポジトリ一覧**: 各リポジトリのタスク進捗
+2. **実行結果サマリー**: 成功/失敗件数、全体カバレッジ
+3. **各リポジトリの詳細結果**: カバレッジ、Lint/Build結果、エラー内容
+4. **次のアクション**: 成功時/失敗時の推奨ステップ
+
+## Safety & Fallback
+
+### Error Scenarios
+
+- **品質ゲート不合格**:
+  ```
+  エラー: 品質ゲート不合格のため、実装を開始できません。
+
+  `/michi-multi-repo:spec-review $1` を実行し、BLOCK問題を解決してください。
+  ```
+
+- **タスクファイル不存在**:
+  ```
+  エラー: リポジトリ '{name}' にタスクファイルがありません: .kiro/specs/{feature}/tasks.md
+
+  タスクを生成してください:
+  cd {localPath}
+  /michi:spec-tasks {feature}
+  ```
+
+- **localPath未設定**:
+  ```
+  警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
+  ```
+
+- **Michi未セットアップ**:
+  ```
+  ⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
+
+  セットアップコマンド:
+  cd {localPath} && npx @sk8metal/michi-cli@latest init
+
+  セットアップ完了後、このコマンドを再実行してください。
+  ```
+
+### Fallback Strategy
+- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
+- テスト失敗: 自動修正を試行（最大3回）、失敗時はチェックポイント保存
+
+think hard

package/templates/claude/commands/michi-multi-repo/propagate-specs.md

@@ -0,0 +1,284 @@
+---
+description: Multi-Repoプロジェクトから各リポジトリへ仕様を展開（並行実行）
+allowed-tools: Task, Bash, Read, Write, Glob, Grep, AskUserQuestion
+argument-hint: <project-name> [--operation init|requirements|design|all]
+---
+
+# Multi-Repo Spec Propagation
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの仕様を各リポジトリに展開
+- **Success Criteria**:
+  - 全リポジトリで指定されたOPERATIONが完了
+  - 各リポジトリの仕様が親プロジェクトと整合性を保つ
+  - エラーハンドリングとチェックポイント保存
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の全リポジトリに対して、仕様コマンドを並行実行します。
+
+## 引数解析
+
+引数の形式:
+```
+/michi-multi-repo:propagate-specs <project-name> [--operation <operation>]
+```
+
+パラメータ:
+- **$1**: プロジェクト名（必須）
+- **--operation**: 実行する操作（オプション、デフォルト: all）
+  - `init`: /michi:spec-init
+  - `requirements`: /kiro:spec-requirements
+  - `design`: /michi:spec-design
+  - `all`: /michi:spec-init → /kiro:spec-requirements → /michi:spec-design を順次実行
+
+## Execution Steps
+
+### Step 1: コンテキスト読み込み
+
+1. `.michi/config.json` からプロジェクト情報取得
+   ```bash
+   cat .michi/config.json | grep -A 20 '"name": "$1"'
+   ```
+
+2. 登録リポジトリの一覧を取得
+
+3. 各リポジトリの `localPath` を取得
+
+4. 親プロジェクトの仕様ファイルを確認
+   - `docs/michi/$1/overview/requirements.md` (OPERATION=design以降で必要)
+   - `docs/michi/$1/overview/architecture.md` (OPERATION=design以降で必要)
+
+### Step 2: localPath 検証
+
+各リポジトリについて以下を確認:
+
+- ✅ localPathが設定されているか
+- ✅ ディレクトリが存在するか
+- ✅ Gitリポジトリか (`.git/`ディレクトリ確認)
+- ✅ Michiがセットアップ済みか (`.kiro/project.json`確認)
+- ⚠️ 設定されたブランチと現在のブランチが一致するか
+- ⚠️ 未コミット変更がないか
+
+**検証失敗時の対応**:
+- localPath未設定: 警告を出力し、該当リポジトリをスキップ
+- ディレクトリ不存在: エラーを出力し、該当リポジトリをスキップ
+- Michi未セットアップ: 警告を出力し、該当リポジトリをスキップ
+- ブランチ不一致: 警告を出力（続行可能）
+- 未コミット変更: 警告を出力（続行可能）
+
+### Step 3: チェックポイント確認
+
+`docs/michi/$1/.checkpoint.json` の存在を確認
+
+存在する場合:
+```text
+⚠️ チェックポイントファイルが見つかりました: docs/michi/$1/.checkpoint.json
+
+前回の実行が中断された可能性があります。
+
+次のアクション:
+A) チェックポイントから再開（未完了リポジトリのみ処理）
+B) 最初から実行（チェックポイント削除）
+C) キャンセル
+
+選択 (A/B/C): _
+```
+
+### Step 3.5: 実行確認
+
+以下のリポジトリで仕様生成を自動実行します:
+
+| リポジトリ | localPath | 実行コマンド |
+|-----------|----------|-------------|
+{各リポジトリの情報を表示}
+
+**AskUserQuestionツールで確認:**
+```
+この内容で仕様生成を自動実行しますか？
+
+実行されるコマンド:
+- /michi:spec-init "{project description}"
+- /kiro:spec-requirements {feature}
+- /michi:spec-design {feature}
+```
+
+選択肢:
+- はい、実行する（推奨）
+- いいえ、キャンセル
+
+### Step 4: 並行実行
+
+**並行実行数**: 最大3並列
+
+**重要**: general-purposeエージェントを使用して、以下のリポジトリで仕様コマンドを並行実行してください：
+
+各リポジトリに対してTaskツール（subagent_type: general-purpose）を起動:
+
+**Repository**: {repo.name}
+- 作業ディレクトリ: {repo.localPath}
+- 親プロジェクト参照:
+  - requirements.md: {親プロジェクトパス}/docs/michi/$1/overview/requirements.md
+  - architecture.md: {親プロジェクトパス}/docs/michi/$1/overview/architecture.md
+
+実行コマンド（順次）:
+1. `/michi:spec-init "{project description}"`
+2. `/kiro:spec-requirements {feature}`
+3. `/michi:spec-design {feature}`
+
+親プロジェクトの設計との整合性を維持し、このリポジトリの責務範囲のみを設計してください。
+
+**重要**: 全リポジトリのエージェント完了を待ち、結果を集約してください。
+
+### Step 5: 結果集約とレポート
+
+各リポジトリの実行結果を集約:
+
+| リポジトリ | OPERATION | ステータス | 詳細 |
+|-----------|----------|----------|------|
+| frontend  | design   | ✅ 成功  | design.md生成完了 |
+| backend   | design   | ✅ 成功  | design.md生成完了 |
+| shared    | design   | ❌ 失敗  | localPath未設定 |
+
+**成功件数**: 2/3
+**失敗件数**: 1/3
+
+### Step 6: チェックポイント保存（失敗時）
+
+失敗したリポジトリがある場合、チェックポイントを保存:
+
+```json
+{
+  "projectName": "$1",
+  "operation": "{operation}",
+  "repositories": {
+    "frontend": {
+      "status": "completed",
+      "completedAt": "2025-12-23T10:30:00Z"
+    },
+    "backend": {
+      "status": "completed",
+      "completedAt": "2025-12-23T10:31:00Z"
+    },
+    "shared": {
+      "status": "failed",
+      "error": "localPath未設定"
+    }
+  },
+  "savedAt": "2025-12-23T10:32:00Z"
+}
+```
+
+保存先: `docs/michi/$1/.checkpoint.json`
+
+### Step 7: 次のアクション案内
+
+**全成功時**:
+```markdown
+🎉 全リポジトリで仕様展開が完了しました
+
+### 次のステップ
+
+1. クロスリポジトリレビューを実行:
+   `/michi-multi-repo:spec-review $1`
+
+2. 合格後、各リポジトリでタスク生成:
+   各リポジトリで `/michi:spec-tasks {feature}` を実行
+
+3. 実装を開始:
+   `/michi-multi-repo:impl-all $1`
+```
+
+**一部失敗時**:
+```markdown
+⚠️ 一部のリポジトリで失敗しました
+
+### 失敗したリポジトリ
+- shared: localPath未設定
+
+### 対処方法
+1. localPathを設定:
+   `michi multi-repo:add-repo $1 --name shared --localPath /path/to/repo`
+
+2. チェックポイントから再開:
+   `/michi-multi-repo:propagate-specs $1 --operation {operation}`
+   （失敗したリポジトリのみ処理されます）
+```
+
+## Important Constraints
+- 並行実行は最大3リポジトリ
+- 各リポジトリは独立して処理（依存関係なし）
+- localPath未設定のリポジトリはスキップ
+- エラー発生時もチェックポイントを保存し、再開可能にする
+
+</instructions>
+
+## Tool Guidance
+- **Task**: repo-spec-executorサブエージェント起動に使用
+- **Read**: config.json、親プロジェクト仕様の読み込み
+- **Write**: チェックポイント保存
+- **Bash**: localPath検証、Git操作
+
+## Output Description
+
+日本語で以下の情報を出力してください:
+
+1. **処理対象リポジトリ一覧**: 各リポジトリのlocalPathと検証結果
+2. **実行結果サマリー**: 成功/失敗件数
+3. **各リポジトリの詳細結果**: 生成されたファイル、エラー内容
+4. **次のアクション**: 成功時/失敗時の推奨ステップ
+
+## Safety & Fallback
+
+### Error Scenarios
+
+- **プロジェクト未登録**:
+  ```
+  エラー: プロジェクト '$1' が見つかりません。
+
+  次のコマンドでプロジェクトを初期化してください：
+  michi multi-repo:init $1 --jira {JIRA_KEY} --confluence-space {SPACE}
+  ```
+
+- **リポジトリ未登録**:
+  ```
+  警告: プロジェクト '$1' にリポジトリが登録されていません。
+
+  次のコマンドでリポジトリを登録してください：
+  michi multi-repo:add-repo $1 --name {name} --url {url} --localPath {path}
+  ```
+
+- **localPath未設定**:
+  ```
+  警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
+
+  localPathを設定するには:
+  michi multi-repo:add-repo $1 --name {name} --localPath /path/to/repo
+  ```
+
+- **Michi未セットアップ**:
+  ```
+  ⚠️ リポジトリ '{name}' にMichiがセットアップされていません。スキップします。
+
+  セットアップコマンド:
+  cd {localPath} && npx @sk8metal/michi-cli@latest init
+
+  セットアップ完了後、このコマンドを再実行してください。
+  ```
+
+- **親プロジェクト仕様未作成（OPERATION=design以降）**:
+  ```
+  エラー: 親プロジェクトの設計書が見つかりません: docs/michi/$1/overview/architecture.md
+
+  先に親プロジェクトの設計を作成してください:
+  /michi-multi-repo:spec-design $1
+  ```
+
+### Fallback Strategy
+- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- Michi未セットアップ: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
+- 全リポジトリ失敗: エラーレポート出力し、ユーザーに対処方法を案内
+
+think hard

package/templates/claude/commands/michi-multi-repo/spec-design.md

@@ -94,6 +94,49 @@ Multi-Repoプロジェクト **$1** の技術設計書を生成します。
 - 出力先: `docs/michi/$1/overview/architecture.md`
 - 既存ファイルがある場合は、上書き確認（`-y` フラグで自動承認）
 
+### Step 4.5: 品質検証（PROACTIVE）
+
+**architecture.md生成後、以下の検証を自動実行**:
+
+#### 4.5.1 Mermaid図の構文検証
+
+`mermaid-validator` エージェントを使用してMermaid図を検証:
+
+```
+IMPORTANT: architecture.mdにMermaid図が含まれる場合、mermaid-validatorエージェントを自動実行してください。
+- 検出: Mermaid図を含むかどうかを確認
+- 検証: 構文エラーを検出
+- 修正: 自動修正可能なエラーを修正
+- 報告: 修正内容をユーザーに通知
+```
+
+**実行タイミング**: architecture.md保存直後
+
+**エージェント呼び出し**:
+```
+Task(subagent_type='mermaid-validator', prompt='docs/michi/$1/overview/architecture.md のMermaid図を検証し、構文エラーを自動修正してください')
+```
+
+#### 4.5.2 技術スタックバージョン監査
+
+`stable-version-auditor` エージェントを使用して技術スタックを監査:
+
+```
+IMPORTANT: architecture.mdに技術スタック（Node.js、Java、Python、PHP等）が記載されている場合、
+stable-version-auditorエージェントを自動実行してください。
+- 検出: バージョン指定を抽出
+- 監査: EOLリスクを評価
+- 推奨: 最新LTS/安定版を提案
+- 報告: アップグレード推奨をユーザーに通知
+```
+
+**実行タイミング**: architecture.md保存直後
+
+**エージェント呼び出し**:
+```
+Task(subagent_type='stable-version-auditor', prompt='docs/michi/$1/overview/architecture.md に記載された技術スタックのバージョンを監査し、EOLリスクを評価してください')
+```
+
 ### Step 5: メタデータ更新（spec.json）
 - `docs/michi/$1/spec.json` を読み込み
 - phase を `"design-generated"` に更新
@@ -208,7 +251,10 @@ sequenceDiagram
 
 1. **生成された設計書のパス**: `docs/michi/{project}/overview/architecture.md`
 2. **分析したリポジトリの一覧**: サービス名と技術スタックの要約
-3. **次のステップ**:
+3. **品質検証結果**:
+   - Mermaid図の検証結果
+   - 技術スタックバージョン監査結果
+4. **次のステップ**:
    - 設計書の確認
    - Confluence同期
    - 各リポジトリでの個別実装
@@ -230,10 +276,27 @@ sequenceDiagram
 - **データベース**: PostgreSQL（サービスごとにDB分離）
 - **デプロイ**: Kubernetes（Pod自動スケーリング）
 
+### 品質検証結果
+
+#### Mermaid図検証
+✅ 検証完了 - 構文エラーなし
+または
+⚠️ 2件の構文エラーを自動修正しました:
+- L15: C4モデルのタイトル記法エラー → 修正済み
+- L45: シーケンス図の矢印記法エラー → 修正済み
+
+#### 技術スタックバージョン監査
+✅ すべて最新LTS/安定版を使用
+または
+⚠️ バージョン更新を推奨:
+- Node.js 16.x → 20.x (LTS) - EOL: 2023-09-11（EOL済み）
+- Python 3.9 → 3.11 - EOL 6ヶ月以内
+
 ### 次のステップ
 1. 設計書を確認: `docs/michi/{project}/overview/architecture.md`
-2. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type architecture`
-3. 各リポジトリで実装を開始:
+2. 技術スタック更新（必要に応じて）
+3. Confluenceに同期: `michi multi-repo:confluence-sync {project} --doc-type architecture`
+4. 各リポジトリで実装を開始:
    - `/kiro:spec-init` で個別仕様を作成
    - または直接実装を開始
 ```