@sk8metal/michi-cli 0.0.8 → 0.1.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 を作成
@@ -47,7 +49,7 @@ npm run phase:run user-auth requirements
 #  📢 PMや部長にConfluenceでレビューを依頼してください
 ```
 
-### Phase 2: 設計
+### Phase 0.2: 設計
 
 ```bash
 # Step 1: AIで 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 を作成（営業日ベース）
@@ -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
 # 既存のスペースキーに変更
@@ -179,6 +183,7 @@ CONFLUENCE_PRD_SPACE=Michi  # ← 実際に存在するスペース
 ```
 
 **対処**:
+
 ```bash
 # 個別に実行
 npm run confluence:sync calculator-app requirements
@@ -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
 # 既存のプロジェクトキーに変更
@@ -218,6 +225,7 @@ vim .kiro/project.json
 ```
 
 **対処**:
+
 ```bash
 # 個別に実行
 npm run 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  # スクリプト実行（必須）
 
-# 2. 設計
+# Phase 0.2: 設計
 /kiro:spec-design calculator-app  # AI実行
 npm run phase:run calculator-app design  # スクリプト実行（必須）
 
-# 3. タスク分割
+# Phase 0.3-0.4: テスト計画（必要に応じて）
+# テストタイプの選択とテスト仕様書作成
+# 詳細: docs/user-guide/testing/test-planning-flow.md
+
+# Phase 0.5: タスク分割
 /kiro:spec-tasks calculator-app  # AI実行
+
+# Phase 0.6: JIRA同期
 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
 
-# 5. 実装開始
+# Phase 1: 環境構築（必要に応じて）
+# テスト環境のセットアップ
+
+# 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のみ作成
@@ -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. 次のフェーズへ
-