Skip to content

ヒューマンインタラクションポイント

パイプラインは以下のポイントでユーザーに制御を返します。ブロッキングと記載されたポイントはパイプラインの続行前に応答が必要です。情報提供のみと記載されたポイントは追加入力不要です。

入力バリデーション

#トリガーユーザーに表示される内容ブロッキング
1mcp__forge-state__validate_input がエラーを返す(空、短すぎる、不正なURL)エラーメッセージ、パイプライン停止はい — 中止
2LLMが入力を無意味またはソフトウェア開発と無関係と判断具体的な理由と有効な入力例を含む拒否メッセージ、パイプライン停止はい — 中止
3Jira URLが指定されたが mcp__atlassian__getJiraIssue ツールが利用不可プラグインインストール手順付きのエラー、パイプライン停止はい — 中止

ワークスペースセットアップ

#トリガーユーザーに表示される内容ブロッキング
4現在のgitブランチが main/master でないブランチ名表示、現在のブランチを使用するか新規作成するかの選択はい — 選択待ち
5工数レベル選択(毎回必須)工数レベル(S / M / L)の選択と、その選択で実行されるフェーズの表示はい — 選択待ち
6full テンプレートと --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検証者が修正不可能な失敗を発見失敗レポートをユーザーに提示はい — 停滞

パイプライン終了

#トリガーユーザーに表示される内容ブロッキング
15summary.md の書き込み成功summary.md の全内容表示(リクエスト、ブランチ、PR、タスク一覧、改善レポート、実行統計)、サウンド通知いいえ — 情報提供のみ

スキップされるチェックポイント: チェックポイント B は工数 S および M ではスキップされます(工数 L のみ実行)。フェーズ 4b(タスクレビュー)も工数 S および M ではスキップされます。--auto フラグでチェックポイント A の AI 判定による自動承認が可能です(full テンプレートでは利用不可)。

Released under the MIT License.