@sk8metal/michi-cli 0.8.1 → 0.8.3

package/docs/michi-development/testing/manual-verification-flow.md

@@ -548,1274 +548,12 @@ Phase 0.1 (requirements)、Phase 0.2 (design)、Phase 0.5-0.6 (tasks) のCLIコ
 
 ---
 
-## 1.2 Claude Code
 
-### サポート状況
-
-- ✅ cc-sdd: 完全対応
-- ✅ Michi: 完全対応
-
-### Step 0: テストディレクトリの準備
-
-```bash
-# テストディレクトリを作成
-mkdir -p /tmp/michi-manual-test-claude-code
-cd /tmp/michi-manual-test-claude-code
-
-# Gitリポジトリとして初期化
-git init
-git config user.name "Test User"
-git config user.email "test@example.com"
-
-# 初期コミット
-touch README.md
-git add README.md
-git commit -m "Initial commit"
-```
-
-### Step 1: Phase 1 - cc-sddのインストール
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-
-# cc-sddをインストール（Claude Code用、日本語）
-npx cc-sdd@latest --claude --lang ja
-```
-
-#### 確認事項
-
-実行後、以下のファイルが生成されることを確認：
-
-```bash
-ls -la /tmp/michi-manual-test-claude-code/.claude/
-# 出力例:
-# .claude/
-#   CLAUDE.md
-#   commands/kiro
-#     kiro-spec-init.md
-#     kiro-spec-requirements.md
-#     ... (cc-sdd提供の10個のコマンド)
-```
-
-### Step 2: Phase 2 - Michiのセットアップ
-
-#### Pattern A: NPM Package（推奨）
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-
-# Michiパッケージをグローバルインストール（まだの場合）
-npm install -g @sk8metal/michi-cli
-
-# Michiセットアップ（Claude Code用）
-michi setup-existing --claude --lang ja
-```
-
-#### Pattern B: Development（開発環境）
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-
-# 開発環境のMichiを使用してセットアップ
-npx tsx ~/Work/git/michi/src/cli.ts setup-existing --claude --lang ja
-```
-
-#### 確認事項
-
-実行後、Michiのコマンドが追加されることを確認：
-
-```bash
-ls -la /tmp/michi-manual-test-claude-code/.claude/commands/kiro/michi
-# Michiのコマンドが追加されている:
-#   michi-confluence-sync.md
-#   michi-project-switch.md
-```
-
-### Step 3: フェーズ実行
-
-各フェーズごとに、スラッシュコマンド（該当する場合）とCLIコマンドを順番に実行します。
-
-#### 3.0 初期化
-
-Claude Codeを起動し、スラッシュコマンドを実行：
-
-```
-/kiro:spec-init Java電卓webアプリ
-```
-
-**期待される動作:**
-
-- `.kiro/specs/java-calculator-webapp/` ディレクトリが作成される
-- `spec.json` が初期化される
-
-#### 3.1 Phase 0.1: 要件定義（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-requirements java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `requirements.md` が生成される
-- AIが要件を整理して記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp requirements
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp requirements
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.2 Phase 0.2: 設計（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-design java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `design.md` が生成される
-- AIが設計内容を記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp design
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp design
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.3 Phase 0.3: テストタイプ選択（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp test-type-selection
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-type-selection
-```
-
-**期待される結果:**
-
-- テストタイプの選択が完了する
-- バリデーションが成功する
-
-#### 3.4 Phase 0.4: テスト仕様書作成（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp test-spec
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-spec
-```
-
-**期待される結果:**
-
-- テスト仕様書が作成される
-- バリデーションが成功する
-
-#### 3.5 Phase 0.5-0.6: タスク分割・JIRA同期（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-tasks java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `tasks.md` が生成される
-- ストーリー、タスク、工数が記載される
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp tasks
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp tasks
-```
-
-**期待される結果:**
-
-- JIRAチケットが作成される
-- バリデーションが成功する
-
-#### 3.6 Phase 1: 環境構築（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp environment-setup
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp environment-setup
-```
-
-**期待される結果:**
-
-- 環境構築プロセスが完了する
-- バリデーションが成功する
-
-#### 3.7 Phase 2: TDD実装（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-impl java-calculator-webapp
-```
-
-**期待される動作:**
-
-- TDD（RED-GREEN-REFACTOR）サイクルで実装
-- 各タスクの実装とテストが完了
-
-**注意:** 実際の実装は行わず、コマンドの動作確認のみ
-
-**JIRA連携について:**
-JIRA連携は `/kiro:spec-impl` コマンド実行時に自動で行われます：
-
-- spec.json から JIRA 情報（Epic + Story）を自動取得
-- Epic と最初の Story を「進行中」に移動
-- TDD 実装
-- PR 作成
-- Epic と最初の Story を「レビュー待ち」に移動
-- JIRA に PR リンクをコメント
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-# ステータス変更
-michi jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-michi jira:comment DEMO-103 "テストコメント"
-```
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-# ステータス変更
-npx tsx ~/Work/git/michi/src/cli.ts jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-npx tsx ~/Work/git/michi/src/cli.ts jira:comment DEMO-103 "テストコメント"
-```
-
-**期待される結果:**
-
-- JIRAステータスが変更される
-- JIRAにコメントが追加される
-
-#### 3.8 Phase A: PR前自動テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp phase-a
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-a
-```
-
-**期待される結果:**
-
-- PR前自動テストが実行される
-- バリデーションが成功する
-
-#### 3.9 Phase 3: 追加QA（任意）
-
-**注意:** 手動検証では実際のQAは行わず、フローの確認のみ
-
-#### 3.10 Phase B: リリース準備テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**前提条件:**
-
-- Phase 0.3 (test-type-selection) でテストタイプが選択済みであること
-- アプリケーションの実装が完了していること
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-michi phase:run java-calculator-webapp phase-b
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-code
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-b
-```
-
-**期待される結果:**
-
-- `test-type-selection.json`から選択されたテストタイプを読み込む
-- Phase Bに該当するテスト（performance, security, integration, e2e）の実行ファイルを生成
-- `.kiro/specs/<feature>/test-execution/` 配下にテスト実行ファイルが作成される
-
-**生成されるファイル例:**
-
-| テストタイプ | 生成ファイル                                                                          |
-| ------------ | ------------------------------------------------------------------------------------- |
-| performance  | `test-execution/performance/locustfile.py`, `load-test-plan.md`                       |
-| security     | `test-execution/security/zap-config.yaml`, `run-zap-scan.sh`, `security-test-plan.md` |
-| integration  | `test-execution/integration/integration-checklist.md`                                 |
-| e2e          | `test-execution/e2e/e2e-checklist.md`                                                 |
-
-**注意:** 生成されるファイルはテンプレートとガイドです。実際のテストツール（Locust, k6, OWASP ZAP等）の選定と設定は、プロジェクトの要件に応じて行ってください。
-
-#### 3.11 Phase 4: リリース準備（任意）
-
-**注意:** 手動検証では実際のリリース準備は行わず、フローの確認のみ
-
-#### 3.12 Phase 5: リリース（任意）
-
-**注意:** 手動検証では実際のリリースは行わず、フローの確認のみ
-
-### Step 4: 成功確認
-
-すべてのコマンドが正常に完了し、ファイル構造が作成されていることを確認：
-
-```
-/tmp/michi-manual-test-claude-code/
-├── .claude/
-│   ├── CLAUDE.md
-│   └── commands/
-│       ├── kiro-spec-init.md (cc-sdd)
-│       ├── kiro-spec-requirements.md (cc-sdd)
-│       ├── kiro-spec-design.md (cc-sdd)
-│       ├── kiro-spec-tasks.md (cc-sdd)
-│       ├── ... (cc-sdd提供の他のコマンド)
-│       ├── michi-confluence-sync.md (Michi)
-│       └── michi-project-switch.md (Michi)
-└── .kiro/
-    └── specs/
-        └── java-calculator-webapp/
-            ├── spec.json
-            ├── requirements.md (Step 3.2 AIで作成)
-            ├── design.md (Step 3.3 AIで作成)
-            ├── tasks.md (Step 3.4 AIで作成)
-            ├── test-type-selection.json (Step 3.6 CLIで作成)
-            ├── test-specs/ (Step 3.7 CLIで作成)
-            │   └── *.md
-            └── test-execution/ (Step 3.10 Phase Bで作成、任意)
-                ├── performance/
-                ├── security/
-                ├── integration/
-                └── e2e/
-```
-
-**重要な注意事項:**
-
-Phase 0.1 (requirements)、Phase 0.2 (design)、Phase 0.5-0.6 (tasks) のCLIコマンド実行により、以下が作成されます：
-
-- Confluenceページ（requirements、design用）
-- JIRAチケット（tasks用）
-
-これらはConfluence/JIRA上に作成されるため、ローカルファイルシステムには追加ファイルは生成されません。
-
----
-
-## 1.3 Claude Agent SDK
-
-### サポート状況
-
-- ⚠️ cc-sdd: 暫定対応（`--claude` フラグを使用）
-- ⚠️ Michi: 暫定対応（`--claude-agent` フラグを使用）
-
-### 注意事項
-
-Claude Agent SDKは正式なcc-sdd対応が未完了です。現在は以下の制限があります：
-
-1. cc-sddインストール時は `--claude` フラグを使用（`--claude-agent` フラグは存在しない）
-2. Michiセットアップ時は `--claude-agent` フラグを使用
-3. 一部機能が正常に動作しない可能性あり
-
-### Step 0: テストディレクトリの準備
-
-```bash
-# テストディレクトリを作成
-mkdir -p /tmp/michi-manual-test-claude-agent
-cd /tmp/michi-manual-test-claude-agent
-
-# Gitリポジトリとして初期化
-git init
-git config user.name "Test User"
-git config user.email "test@example.com"
-
-# 初期コミット
-touch README.md
-git add README.md
-git commit -m "Initial commit"
-```
-
-### Step 1: Phase 1 - cc-sddのインストール
-
-⚠️ **重要**: `--claude-agent` フラグは存在しないため、`--claude` を使用
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-
-# cc-sddをインストール（Claudeフラグを使用）
-npx cc-sdd@latest --claude --lang ja
-```
-
-#### 確認事項
-
-```bash
-ls -la /tmp/michi-manual-test-claude-agent/.claude/
-# .claude/CLAUDE.md と commands/ が生成される
-```
-
-### Step 2: Phase 2 - Michiのセットアップ
-
-#### Pattern A: NPM Package（推奨）
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-
-# Michiパッケージをグローバルインストール（まだの場合）
-npm install -g @sk8metal/michi-cli
-
-# Michiセットアップ（Claude Agent SDK用）
-michi setup-existing --claude-agent --lang ja
-```
-
-#### Pattern B: Development（開発環境）
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-
-# 開発環境のMichiを使用してセットアップ
-npx tsx ~/Work/git/michi/src/cli.ts setup-existing --claude-agent --lang ja
-```
-
-#### 確認事項
-
-Michiは `.claude/agents/` ディレクトリにサブエージェント定義を追加します：
-
-```bash
-ls -la /tmp/michi-manual-test-claude-agent/.claude/agents/
-# 出力例:
-# .claude/agents/
-#   manager-agent.md
-#   developer.md
-#   designer.md
-#   tester.md
-```
-
-### Step 3: フェーズ実行
-
-各フェーズごとに、スラッシュコマンド（該当する場合）とCLIコマンドを順番に実行します。
-
-#### 3.0 初期化
-
-Claude Agent SDKを起動し、スラッシュコマンドを実行：
-
-```
-/kiro:spec-init マニュアルテスト機能
-```
-
-**期待される動作:**
-
-- `.kiro/specs/java-calculator-webapp/` ディレクトリが作成される
-- `spec.json` が初期化される
-
-#### 3.1 Phase 0.1: 要件定義（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-requirements java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `requirements.md` が生成される
-- AIが要件を整理して記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp requirements
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp requirements
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.2 Phase 0.2: 設計（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-design java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `design.md` が生成される
-- AIが設計内容を記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp design
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp design
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.3 Phase 0.3: テストタイプ選択（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp test-type-selection
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-type-selection
-```
-
-**期待される結果:**
-
-- テストタイプの選択が完了する
-- バリデーションが成功する
-
-#### 3.4 Phase 0.4: テスト仕様書作成（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp test-spec
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-spec
-```
-
-**期待される結果:**
-
-- テスト仕様書が作成される
-- バリデーションが成功する
-
-#### 3.5 Phase 0.5-0.6: タスク分割・JIRA同期（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-tasks java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `tasks.md` が生成される
-- ストーリー、タスク、工数が記載される
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp tasks
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp tasks
-```
-
-**期待される結果:**
-
-- JIRAチケットが作成される
-- バリデーションが成功する
-
-#### 3.6 Phase 1: 環境構築（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp environment-setup
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp environment-setup
-```
-
-**期待される結果:**
-
-- 環境構築プロセスが完了する
-- バリデーションが成功する
-
-#### 3.7 Phase 2: TDD実装（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-impl java-calculator-webapp
-```
-
-**期待される動作:**
-
-- TDD（RED-GREEN-REFACTOR）サイクルで実装
-- 各タスクの実装とテストが完了
-
-**注意:** 実際の実装は行わず、コマンドの動作確認のみ
-
-**JIRA連携について:**
-JIRA連携は `/kiro:spec-impl` コマンド実行時に自動で行われます：
-
-- spec.json から JIRA 情報（Epic + Story）を自動取得
-- Epic と最初の Story を「進行中」に移動
-- TDD 実装
-- PR 作成
-- Epic と最初の Story を「レビュー待ち」に移動
-- JIRA に PR リンクをコメント
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-# ステータス変更
-michi jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-michi jira:comment DEMO-103 "テストコメント"
-```
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-# ステータス変更
-npx tsx ~/Work/git/michi/src/cli.ts jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-npx tsx ~/Work/git/michi/src/cli.ts jira:comment DEMO-103 "テストコメント"
-```
-
-**期待される結果:**
-
-- JIRAステータスが変更される
-- JIRAにコメントが追加される
-
-#### 3.8 Phase A: PR前自動テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp phase-a
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-a
-```
-
-**期待される結果:**
-
-- PR前自動テストが実行される
-- バリデーションが成功する
-
-#### 3.9 Phase 3: 追加QA（任意）
-
-**注意:** 手動検証では実際のQAは行わず、フローの確認のみ
-
-#### 3.10 Phase B: リリース準備テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**前提条件:**
-
-- Phase 0.3 (test-type-selection) でテストタイプが選択済みであること
-- アプリケーションの実装が完了していること
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-michi phase:run java-calculator-webapp phase-b
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-claude-agent
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-b
-```
-
-**期待される結果:**
-
-- `test-type-selection.json`から選択されたテストタイプを読み込む
-- Phase Bに該当するテスト（performance, security, integration, e2e）の実行ファイルを生成
-- `.kiro/specs/<feature>/test-execution/` 配下にテスト実行ファイルが作成される
-
-**生成されるファイル例:**
-
-| テストタイプ | 生成ファイル                                                                          |
-| ------------ | ------------------------------------------------------------------------------------- |
-| performance  | `test-execution/performance/locustfile.py`, `load-test-plan.md`                       |
-| security     | `test-execution/security/zap-config.yaml`, `run-zap-scan.sh`, `security-test-plan.md` |
-| integration  | `test-execution/integration/integration-checklist.md`                                 |
-| e2e          | `test-execution/e2e/e2e-checklist.md`                                                 |
-
-**注意:** 生成されるファイルはテンプレートとガイドです。実際のテストツール（Locust, k6, OWASP ZAP等）の選定と設定は、プロジェクトの要件に応じて行ってください。
-
-#### 3.11 Phase 4: リリース準備（任意）
-
-**注意:** 手動検証では実際のリリース準備は行わず、フローの確認のみ
-
-#### 3.12 Phase 5: リリース（任意）
-
-**注意:** 手動検証では実際のリリースは行わず、フローの確認のみ
-
-### Step 4: 成功確認
-
-⚠️ **検証が必要**: Claude Agent SDK環境でのcc-sddコマンドとMichi CLIコマンドの動作は未検証です。
-
----
-
-## 1.4 Cline
-
-### サポート状況
-
-- ❓ cc-sdd: 未確認（テンプレートは存在）
-- ✅ Michi: テンプレート対応
-
-### 注意事項
-
-Clineのcc-sdd対応は未確認です。以下の手順は理論上の実行手順であり、実際の動作検証が必要です。
-
-### Step 0: テストディレクトリの準備
-
-```bash
-# テストディレクトリを作成
-mkdir -p /tmp/michi-manual-test-cline
-cd /tmp/michi-manual-test-cline
-
-# Gitリポジトリとして初期化
-git init
-git config user.name "Test User"
-git config user.email "test@example.com"
-
-# 初期コミット
-touch README.md
-git add README.md
-git commit -m "Initial commit"
-```
-
-### Step 1: Phase 1 - cc-sddのインストール（未確認）
-
-❓ **未確認**: Cline用のcc-sddフラグが存在するか不明
-
-```bash
-cd /tmp/michi-manual-test-cline
-
-# cc-sddをインストール（Cline用フラグが存在すると仮定）
-npx cc-sdd@latest --cline --lang ja
-```
-
-⚠️ **エラーが発生する場合**: `--cline` フラグが存在しない可能性があります。その場合、Clineでのcc-sdd使用は現時点で非対応です。
-
-### Step 2: Phase 2 - Michiのセットアップ
-
-Michiは Cline のテンプレートを提供しています。
-
-#### Pattern A: NPM Package（推奨）
-
-```bash
-cd /tmp/michi-manual-test-cline
-
-# Michiパッケージをグローバルインストール（まだの場合）
-npm install -g @sk8metal/michi-cli
-
-# Michiセットアップ（Cline用）
-michi setup-existing --cline --lang ja
-```
-
-#### Pattern B: Development（開発環境）
-
-```bash
-cd /tmp/michi-manual-test-cline
-
-# 開発環境のMichiを使用してセットアップ
-npx tsx ~/Work/git/michi/src/cli.ts setup-existing --cline --lang ja
-```
-
-#### 確認事項
-
-Michiは `.clinerules` ファイルを作成します：
-
-```bash
-ls -la /tmp/michi-manual-test-cline/.clinerules
-```
-
-### Step 3: フェーズ実行（要検証）
-
-❓ **未確認**: Clineでのcc-sddコマンド実行は未検証です。以下は理論上の手順です。
-
-各フェーズごとに、スラッシュコマンド（該当する場合）とCLIコマンドを順番に実行します。
-
-#### 3.0 初期化
-
-Clineを起動し、スラッシュコマンドを実行：
-
-```
-/kiro:spec-init マニュアルテスト機能
-```
-
-**期待される動作:**
-
-- `.kiro/specs/java-calculator-webapp/` ディレクトリが作成される
-- `spec.json` が初期化される
-
-#### 3.1 Phase 0.1: 要件定義（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-requirements java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `requirements.md` が生成される
-- AIが要件を整理して記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp requirements
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp requirements
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.2 Phase 0.2: 設計（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-design java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `design.md` が生成される
-- AIが設計内容を記載
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp design
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp design
-```
-
-**期待される結果:**
-
-- Confluenceページが作成される
-- バリデーションが成功する
-
-#### 3.3 Phase 0.3: テストタイプ選択（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp test-type-selection
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-type-selection
-```
-
-**期待される結果:**
-
-- テストタイプの選択が完了する
-- バリデーションが成功する
-
-#### 3.4 Phase 0.4: テスト仕様書作成（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp test-spec
-```
+## その他のツール
 
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-spec
-```
-
-**期待される結果:**
-
-- テスト仕様書が作成される
-- バリデーションが成功する
-
-#### 3.5 Phase 0.5-0.6: タスク分割・JIRA同期（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-tasks java-calculator-webapp
-```
-
-**期待される動作:**
-
-- `tasks.md` が生成される
-- ストーリー、タスク、工数が記載される
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp tasks
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp tasks
-```
-
-**期待される結果:**
-
-- JIRAチケットが作成される
-- バリデーションが成功する
-
-#### 3.6 Phase 1: 環境構築（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp environment-setup
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp environment-setup
-```
-
-**期待される結果:**
-
-- 環境構築プロセスが完了する
-- バリデーションが成功する
-
-#### 3.7 Phase 2: TDD実装（必須）
-
-**スラッシュコマンド:**
-
-```
-/kiro:spec-impl java-calculator-webapp
-```
-
-**期待される動作:**
-
-- TDD（RED-GREEN-REFACTOR）サイクルで実装
-- 各タスクの実装とテストが完了
-
-**注意:** 実際の実装は行わず、コマンドの動作確認のみ
-
-**JIRA連携について:**
-JIRA連携は `/kiro:spec-impl` コマンド実行時に自動で行われます：
-
-- spec.json から JIRA 情報（Epic + Story）を自動取得
-- Epic と最初の Story を「進行中」に移動
-- TDD 実装
-- PR 作成
-- Epic と最初の Story を「レビュー待ち」に移動
-- JIRA に PR リンクをコメント
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-# ステータス変更
-michi jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-michi jira:comment DEMO-103 "テストコメント"
-```
-
-**CLIコマンド - 個別JIRA操作（任意）- Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-# ステータス変更
-npx tsx ~/Work/git/michi/src/cli.ts jira:transition DEMO-103 "In Progress"
-
-# コメント追加
-npx tsx ~/Work/git/michi/src/cli.ts jira:comment DEMO-103 "テストコメント"
-```
-
-**期待される結果:**
-
-- JIRAステータスが変更される
-- JIRAにコメントが追加される
-
-#### 3.8 Phase A: PR前自動テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp phase-a
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-a
-```
-
-**期待される結果:**
-
-- PR前自動テストが実行される
-- バリデーションが成功する
+Claude Code、Claude Agent SDK、Cline、Gemini、Codexでの手動検証フローについては、以下のドキュメントを参照してください:
 
-#### 3.9 Phase 3: 追加QA（任意）
-
-**注意:** 手動検証では実際のQAは行わず、フローの確認のみ
-
-#### 3.10 Phase B: リリース準備テスト（任意）
-
-**スラッシュコマンド:** なし（このフェーズにはスラッシュコマンドは不要）
-
-**前提条件:**
-
-- Phase 0.3 (test-type-selection) でテストタイプが選択済みであること
-- アプリケーションの実装が完了していること
-
-**CLIコマンド - Pattern A (NPM Package):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-michi phase:run java-calculator-webapp phase-b
-```
-
-**CLIコマンド - Pattern B (Development):**
-
-```bash
-cd /tmp/michi-manual-test-cline
-npx tsx ~/Work/git/michi/src/cli.ts phase:run java-calculator-webapp phase-b
-```
-
-**期待される結果:**
-
-- `test-type-selection.json`から選択されたテストタイプを読み込む
-- Phase Bに該当するテスト（performance, security, integration, e2e）の実行ファイルを生成
-- `.kiro/specs/<feature>/test-execution/` 配下にテスト実行ファイルが作成される
-
-**生成されるファイル例:**
-
-| テストタイプ | 生成ファイル                                                                          |
-| ------------ | ------------------------------------------------------------------------------------- |
-| performance  | `test-execution/performance/locustfile.py`, `load-test-plan.md`                       |
-| security     | `test-execution/security/zap-config.yaml`, `run-zap-scan.sh`, `security-test-plan.md` |
-| integration  | `test-execution/integration/integration-checklist.md`                                 |
-| e2e          | `test-execution/e2e/e2e-checklist.md`                                                 |
-
-**注意:** 生成されるファイルはテンプレートとガイドです。実際のテストツール（Locust, k6, OWASP ZAP等）の選定と設定は、プロジェクトの要件に応じて行ってください。
-
-#### 3.11 Phase 4: リリース準備（任意）
-
-**注意:** 手動検証では実際のリリース準備は行わず、フローの確認のみ
-
-#### 3.12 Phase 5: リリース（任意）
-
-**注意:** 手動検証では実際のリリースは行わず、フローの確認のみ
-
-### Step 4: 成功確認（要検証）
-
-❓ **未確認**: ClineでのMichi CLIコマンドの動作は未検証です。
-
----
-
-## 1.5 Gemini
-
-### サポート状況
-
-- 🚧 cc-sdd: 準備中
-- 🚧 Michi: 準備中
-
-### 現状
-
-Gemini用のテンプレートは現在開発中です。対応予定時期は未定です。
-
-### 今後の対応予定
-
-1. cc-sddにGemini用フラグの追加
-2. MichiにGemini用テンプレートの追加
-3. 動作検証
-
----
-
-## 1.6 Codex
-
-### サポート状況
-
-- 🚧 cc-sdd: 準備中
-- 🚧 Michi: 準備中
-
-### 現状
-
-Codex用のテンプレートは現在開発中です。対応予定時期は未定です。
-
-### 今後の対応予定
-
-1. cc-sddにCodex用フラグの追加
-2. MichiにCodex用テンプレートの追加
-3. 動作検証
-
----
+- [その他のツールでの検証フロー](./manual-verification-other-tools.md)
 
 ## Part 2: 自動テストワークフロー
 
@@ -1882,121 +620,12 @@ bash scripts/test-npm-package.sh /tmp/my-custom-test-dir
 
 ---
 
-## トラブルシューティング
-
-### 問題1: cc-sddのインストールが失敗する
-
-**症状:**
-
-```
-Error: Unknown option: --cline
-```
-
-**原因:**
-指定したAI開発ツール用のフラグがcc-sddに存在しない
-
-**解決方法:**
-
-1. cc-sddの最新版を確認: `npm info cc-sdd`
-2. サポートされているフラグを確認: `npx cc-sdd@latest --help`
-3. 対応していない場合は、他のツール（Cursor または Claude Code）を使用
-
-### 問題2: Michiセットアップが既存ファイルと競合する
-
-**症状:**
-
-```
-Warning: File already exists: .cursor/commands/michi-confluence-sync.md
-```
-
-**原因:**
-既にMichiがセットアップされている、または手動で同名ファイルが作成されている
-
-**解決方法:**
-
-```bash
-# 既存のMichiファイルを削除してから再セットアップ
-rm -rf .cursor/commands/michi-*.md
-michi setup-existing --cursor --lang ja
-```
-
-### 問題3: phase:run コマンドが feature を見つけられない
-
-**症状:**
-
-```
-Error: Feature 'java-calculator-webapp' not found
-```
-
-**原因:**
-`.kiro/specs/java-calculator-webapp/` ディレクトリまたは `spec.json` が存在しない
 
-**解決方法:**
-
-1. AIコマンドで初期化されているか確認
-   ```bash
-   ls -la .kiro/specs/java-calculator-webapp/spec.json
-   ```
-2. 存在しない場合は、AIコマンド `/kiro:spec-init` を再実行
-
-### 問題4: validate:phase が失敗する
-
-**症状:**
-
-```
-Error: Validation failed for phase test-type-selection
-```
-
-**原因:**
-必要なファイルが生成されていない、またはフォーマットが不正
-
-**解決方法:**
-
-1. 該当フェーズの出力ファイルを確認
-   ```bash
-   cat .kiro/specs/java-calculator-webapp/test-types.md
-   ```
-2. ファイルが空または不正な場合は、フェーズを再実行
-   ```bash
-   michi phase:run java-calculator-webapp test-type-selection
-   ```
-
-### 問題5: 絶対パスコマンドが動作しない（Pattern B）
-
-**症状:**
-
-```
-Error: Cannot find module '~/Work/git/michi/src/cli.ts'
-```
-
-**原因:**
-シェルがチルダ `~` を展開していない
-
-**解決方法:**
-
-```bash
-# チルダの代わりに $HOME を使用
-npx tsx $HOME/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-type-selection
-
-# または完全な絶対パスを使用
-npx tsx /Users/yourusername/Work/git/michi/src/cli.ts phase:run java-calculator-webapp test-type-selection
-```
-
-### 問題6: 自動テストスクリプトが途中で失敗する
-
-**症状:**
-自動テストスクリプト（pre-publish または test:package）が途中でエラーで終了する
-
-**原因:**
-スクリプトは `set -e` を使用しており、最初のエラーで即座に終了する
-
-**解決方法:**
+## トラブルシューティング
 
-1. エラーメッセージを確認
-2. 該当するコマンドを手動で実行して詳細を確認
-3. 問題を修正してから再実行
+手動検証フローでの問題が発生した場合は、以下のドキュメントを参照してください:
 
----
+- [トラブルシューティングガイド](./manual-verification-troubleshooting.md)
 
 ## まとめ