@sk8metal/michi-cli 0.0.9 → 0.2.0

package/docs/{guides → user-guide/guides}/phase-automation.md

@@ -9,17 +9,19 @@ AI-DLC（AI Development Life Cycle）の各フェーズで、Confluence/JIRA作
 ## 問題: AIだけでは抜け漏れが発生する
 
 **従来の問題**:
+
 - AIが要件定義書（requirements.md）を作成
 - しかし、Confluenceページ作成を忘れる ❌
 - PMや部長がレビューできない状態で設計フェーズへ進んでしまう
 
 **解決策**:
+
 - **スクリプトによる自動化**で、Confluence/JIRA作成を確実に実行
 - **バリデーション**で、必須項目の抜け漏れをチェック
 
 ## 使い方
 
-### Phase 1: 要件定義
+### Phase 0.1: 要件定義
 
 ```bash
 # Step 1: AIで requirements.md を作成
@@ -31,10 +33,10 @@ AI-DLC（AI Development Life Cycle）の各フェーズで、Confluence/JIRA作
 
 # Step 2: スクリプトでConfluence作成＋バリデーション（必須）
 # 凡例
-npm run phase:run <feature> requirements
+michi phase:run <feature> requirements
 
 # 具体例
-npm run phase:run user-auth requirements
+michi phase:run user-auth requirements
 
 # 実行内容:
 #  ✅ requirements.md 存在確認
@@ -47,7 +49,7 @@ npm run phase:run user-auth requirements
 #  📢 PMや部長にConfluenceでレビューを依頼してください
 ```
 
-### Phase 2: 設計
+### Phase 0.2: 設計
 
 ```bash
 # Step 1: AIで design.md を作成
@@ -59,10 +61,10 @@ npm run phase:run user-auth requirements
 
 # Step 2: スクリプトでConfluence作成＋バリデーション（必須）
 # 凡例
-npm run phase:run <feature> design
+michi phase:run <feature> design
 
 # 具体例
-npm run phase:run user-auth design
+michi phase:run user-auth design
 
 # 実行内容:
 #  ✅ design.md 存在確認
@@ -76,7 +78,7 @@ npm run phase:run user-auth design
 #  📢 PMや部長にConfluenceでレビューを依頼してください
 ```
 
-### Phase 3: タスク分割
+### Phase 0.5-0.6: タスク分割とJIRA同期
 
 ```bash
 # Step 1: AIで tasks.md を作成（営業日ベース）
@@ -88,10 +90,10 @@ npm run phase:run user-auth design
 
 # Step 2: スクリプトでJIRA作成＋バリデーション（必須）
 # 凡例
-npm run phase:run <feature> tasks
+michi phase:run <feature> tasks
 
 # 具体例
-npm run phase:run user-auth tasks
+michi phase:run user-auth tasks
 
 # 実行内容:
 #  ✅ tasks.md 存在確認（営業日表記チェック）
@@ -113,12 +115,12 @@ npm run phase:run user-auth tasks
 
 ```bash
 # 凡例
-npm run validate:phase <feature> <phase>
+michi validate:phase <feature> <phase>
 
 # 具体例
-npm run validate:phase user-auth requirements  # 要件定義のバリデーション
-npm run validate:phase user-auth design         # 設計のバリデーション
-npm run validate:phase user-auth tasks          # タスク分割のバリデーション
+michi validate:phase user-auth requirements  # 要件定義のバリデーション
+michi validate:phase user-auth design         # 設計のバリデーション
+michi validate:phase user-auth tasks          # タスク分割のバリデーション
 ```
 
 ### バリデーション項目
@@ -160,11 +162,13 @@ npm run validate:phase user-auth tasks          # タスク分割のバリデー
 ```
 
 **対処法1**: Confluenceでスペースを作成
+
 1. [Confluenceスペース一覧](https://0kuri0n.atlassian.net/wiki/spaces) にアクセス
 2. 「スペースを作成」をクリック
 3. スペースキーを「PRD」または「Michi」で作成
 
 **対処法2**: .envを修正
+
 ```bash
 vim .env
 # 既存のスペースキーに変更
@@ -175,13 +179,14 @@ CONFLUENCE_PRD_SPACE=Michi  # ← 実際に存在するスペース
 
 ```text
 ❌ Confluenceページ（要件定義）が作成されていません
-   → 実行: npm run confluence:sync <feature> requirements
+   → 実行: michi confluence:sync <feature> requirements
 ```
 
 **対処**:
+
 ```bash
 # 個別に実行
-npm run confluence:sync calculator-app requirements
+michi confluence:sync calculator-app requirements
 ```
 
 ### JIRAプロジェクト不在エラー
@@ -195,6 +200,7 @@ npm run confluence:sync calculator-app requirements
 ```
 
 **対処法1**: JIRAでプロジェクトを作成
+
 1. [JIRAプロジェクト作成](https://0kuri0n.atlassian.net/jira/projects/create) にアクセス
 2. プロジェクト名とキーを入力
    - 名前: michi-practice1
@@ -202,6 +208,7 @@ npm run confluence:sync calculator-app requirements
 3. プロジェクトタイプ: ソフトウェア開発
 
 **対処法2**: project.jsonを修正
+
 ```bash
 vim .kiro/project.json
 # 既存のプロジェクトキーに変更
@@ -214,13 +221,14 @@ vim .kiro/project.json
 
 ```text
 ❌ JIRA Epicが作成されていません
-   → 実行: npm run jira:sync <feature>
+   → 実行: michi jira:sync <feature>
 ```
 
 **対処**:
+
 ```bash
 # 個別に実行
-npm run jira:sync calculator-app
+michi jira:sync calculator-app
 ```
 
 ### 認証エラー
@@ -230,6 +238,7 @@ Authentication failed: {"code":401,"message":"Unauthorized"}
 ```
 
 **対処**:
+
 1. Cursorを再起動（Cmd+Q → 再起動）
 2. Atlassian MCP認証トークンがリフレッシュされる
 3. 再度スクリプトを実行
@@ -237,27 +246,73 @@ Authentication failed: {"code":401,"message":"Unauthorized"}
 ## 推奨ワークフロー（確実な方法）
 
 ```bash
-# 1. 要件定義
+# Phase 0.0: 初期化
+/kiro:spec-init calculator-app  # AI実行
+
+# Phase 0.1: 要件定義
 /kiro:spec-requirements calculator-app  # AI実行
-npm run phase:run calculator-app requirements  # スクリプト実行（必須）
+michi phase:run calculator-app requirements  # スクリプト実行（必須）
 
-# 2. 設計
+# Phase 0.2: 設計
 /kiro:spec-design calculator-app  # AI実行
-npm run phase:run calculator-app design  # スクリプト実行（必須）
+michi phase:run calculator-app design  # スクリプト実行（必須）
+
+# Phase 0.3-0.4: テスト計画（必要に応じて）
+# テストタイプの選択とテスト仕様書作成
+# 詳細: docs/user-guide/testing/test-planning-flow.md
 
-# 3. タスク分割
+# Phase 0.5: タスク分割
 /kiro:spec-tasks calculator-app  # AI実行
-npm run phase:run calculator-app tasks  # スクリプト実行（必須）
 
-# 4. バリデーション（全フェーズ）
-npm run validate:phase calculator-app requirements
-npm run validate:phase calculator-app design
-npm run validate:phase calculator-app tasks
+# Phase 0.6: JIRA同期
+michi phase:run calculator-app tasks  # スクリプト実行（必須）
+
+# バリデーション（全フェーズ）
+michi validate:phase calculator-app requirements
+michi validate:phase calculator-app design
+michi validate:phase calculator-app tasks
+
+# Phase 1: 環境構築（必要に応じて）
+# テスト環境のセットアップ
 
-# 5. 実装開始
+# Phase 2: 実装開始（TDD）
 /kiro:spec-impl calculator-app
 ```
 
+### Phase 2: TDD実装の自動化（JIRA連携）
+
+JIRA連携はAIコマンドが自動で行います：
+
+```bash
+# 実装（JIRA連携は自動）
+/kiro:spec-impl user-auth
+```
+
+#### 自動実行される処理
+
+```bash
+# AIコマンド実行時に以下が自動実行されます:
+# ✅ spec.json から JIRA 情報（Epic + Story）を自動取得
+# ✅ Epic と最初の Story を「進行中」に移動
+# ✅ TDD サイクルで実装
+# ✅ GitHub PR作成（feature/user-auth → main）
+# ✅ Epic と最初の Story を「レビュー待ち」に移動
+# ✅ JIRA に PR リンクをコメント
+```
+
+**注意**: JIRA キーの手動指定は不要です。`jira:sync` 実行時に spec.json に保存された情報が自動で使用されます。
+
+#### 個別のJIRA操作（必要な場合のみ）
+
+```bash
+# ステータス変更のみ
+michi jira:transition MICHI-123 "In Progress"
+michi jira:transition MICHI-123 "Ready for Review"
+
+# コメント追加のみ
+michi jira:comment MICHI-123 "PRを作成しました: https://github.com/..."
+```
+
 ## メリット
 
 ### 1. 抜け漏れ防止
@@ -278,10 +333,12 @@ npm run validate:phase calculator-app tasks
 ### 4. 再実行安全（冪等性）
 
 **Confluence**:
+
 - 既存ページがあれば更新（バージョン番号が上がる）
 - 何度実行しても重複ページは作成されない
 
 **JIRA**:
+
 - spec.jsonに記録されたEpic/Storyキーをチェック
 - 既存のEpic/Storyがあればスキップ
 - 新しいStoryのみ作成
@@ -292,11 +349,11 @@ npm run validate:phase calculator-app tasks
 
 ```bash
 # 1回目
-npm run phase:run calculator-app requirements
+michi phase:run calculator-app requirements
   → Confluenceページ新規作成（version 1）
 
 # 2回目（誤って再実行）
-npm run phase:run calculator-app requirements
+michi phase:run calculator-app requirements
   → 既存ページを検索
   → 既存ページ更新（version 1 → 2）
   → ✅ 重複なし
@@ -308,7 +365,7 @@ npm run phase:run calculator-app requirements
 
 ```bash
 # 1回目
-npm run phase:run calculator-app tasks
+michi phase:run calculator-app tasks
   → spec.jsonをチェック（Epic未記録）
   → JQL検索（既存Epicなし）
   → Epic作成: MP-1
@@ -316,7 +373,7 @@ npm run phase:run calculator-app tasks
   → spec.jsonに記録
 
 # 2回目（誤って再実行）
-npm run phase:run calculator-app tasks
+michi phase:run calculator-app tasks
   → spec.jsonをチェック（Epic: MP-1記録済み）
   → 既存Epic検出: MP-1
   → Epic作成スキップ ✅
@@ -335,7 +392,7 @@ npm run phase:run calculator-app tasks
 # Story 8.1: 新機能を追加
 
 # 再実行
-npm run phase:run calculator-app tasks
+michi phase:run calculator-app tasks
   → 既存Epic: MP-1（スキップ）
   → 既存Story: MP-2〜MP-14（スキップ）
   → 新しいStory: MP-15（作成） ← 新規のみ作成
@@ -349,13 +406,14 @@ npm run phase:run calculator-app tasks
 **AI + スクリプト**: 確実に実行 ✅
 
 **冪等性**: 何度実行しても安全 ✅
+
 - Confluence: 既存ページを更新
 - JIRA: 既存Epic/Storyをスキップ
 
 **今後の開発フロー**:
+
 1. AIでMarkdownファイル作成
 2. **スクリプトでConfluence/JIRA作成（必須）**
 3. バリデーションで確認
 4. レビュー依頼
 5. 次のフェーズへ
-