ヒューマンインタラクションポイント
パイプラインは以下のポイントでユーザーに制御を返します。ブロッキングと記載されたポイントはパイプラインの続行前に応答が必要です。情報提供のみと記載されたポイントは追加入力不要です。
入力バリデーション
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 1 | mcp__forge-state__validate_input がエラーを返す(空、短すぎる、不正なURL) | エラーメッセージ、パイプライン停止 | はい — 中止 |
| 2 | LLMが入力を無意味またはソフトウェア開発と無関係と判断 | 具体的な理由と有効な入力例を含む拒否メッセージ、パイプライン停止 | はい — 中止 |
| 3 | Jira URLが指定されたが mcp__atlassian__getJiraIssue ツールが利用不可 | プラグインインストール手順付きのエラー、パイプライン停止 | はい — 中止 |
ワークスペースセットアップ
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 4 | 現在のgitブランチが main/master でない | ブランチ名表示、現在のブランチを使用するか新規作成するかの選択 | はい — 選択待ち |
| 5 | 工数レベル選択(毎回必須) | 工数レベル(S / M / L)の選択と、その選択で実行されるフェーズの表示 | はい — 選択待ち |
| 6 | full テンプレートと --auto フラグの同時使用 | full では手動チェックポイントが必須である警告、auto-approve なしで続行するかキャンセルするかの選択 | はい — 選択待ち |
チェックポイント A — 設計レビュー
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 7 | 自動承認条件を満たす(--auto + AI判定が APPROVE または APPROVE_WITH_NOTES、CRITICAL なし) | 「チェックポイント A を自動承認(AI判定: …)」の1行通知 | いいえ — 情報提供のみ |
| 8 | 人間の承認が必要(AI が REVISE を返した、--auto なし、または full テンプレート) | 設計サマリー(アプローチ、主な変更点、リスクレベル、AI判定、MINOR 指摘、ワークスペースパス)、承認またはフィードバック要求、サウンド通知。修正サイクル後、更新された設計が再提示される | はい — 停止して待機 |
チェックポイント B — タスクレビュー
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 9 | 自動承認条件を満たす | 「チェックポイント B を自動承認(AI判定: …)」の1行通知 | いいえ — 情報提供のみ |
| 10 | 人間の承認が必要 | タスク概要(タスク数、リスクレベル、AI判定、MINOR 指摘、ワークスペースパス)、承認またはフィードバック要求、サウンド通知 | はい — 停止して待機 |
実装(Phase 5–6 ループ)
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 11 | タスクの impl-reviewer が FAIL を返し、タスクごとのリトライ上限(2回)に達した | そのタスクの失敗レポート、対応方法の確認 | はい — 指示待ち |
| 12 | サブエージェントが空または支離滅裂な出力を返し、単一リトライも失敗 | 失敗報告、phase-fail が state に記録 | はい — ユーザー介入まで停滞 |
| 13 | 実装完了後にテストスイートが失敗 | 失敗出力、phase-fail が state に記録 | はい — 停滞 |
最終検証
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 14 | 検証者が修正不可能な失敗を発見 | 失敗レポートをユーザーに提示 | はい — 停滞 |
パイプライン終了
| # | トリガー | ユーザーに表示される内容 | ブロッキング |
|---|---|---|---|
| 15 | summary.md の書き込み成功 | summary.md の全内容表示(リクエスト、ブランチ、PR、タスク一覧、改善レポート、実行統計)、サウンド通知 | いいえ — 情報提供のみ |
スキップされるチェックポイント: チェックポイント B は工数 S および M ではスキップされます(工数 L のみ実行)。フェーズ 4b(タスクレビュー)も工数 S および M ではスキップされます。
--autoフラグでチェックポイント A の AI 判定による自動承認が可能です(fullテンプレートでは利用不可)。