Status: Specification（v1, 仕様策定のみ。実装は後続 PBI） 関連 Issue: #109 / 親 Epic: #72 関連 PBI: TASK-0038 設計原則: AI に任せる範囲を広げる。ただし、Gate を消さない。
PlanGate Orchestrator Mode は、PlanGate を 単一 PBI 制御から 親 PBI 配下の複数子 PBI を管理するオーケストレーションシステム へ拡張するための仕様である。
| 種別 | 役割 | 直接実装 |
|---|---|---|
| 親 PBI | 目的 / 背景 / 受入基準 / 制約 / 除外範囲 / 統合方針 / 完了条件を管理する 制御単位 | ❌ 原則しない |
| 子 PBI | 実装 / PR / レビュー / テストの 作業単位 | ✅ する |
親 PBI は子 PBI の集合に対する 契約 を提供し、各子 PBI は親 PBI の制約下で独立した PR を生む。
| 種別 | 形式 | 例 |
|---|---|---|
| 親 PBI | PBI-XXX |
PBI-123 |
| 子 PBI | PBI-XXX-NN |
PBI-123-01, PBI-123-02 |
既存 TASK-XXXX 番号体系と区別する。実装 PBI で最終確定する。
parent:draft
↓ 親 PBI 起票・初期計画
parent:analyzed
↓ 影響範囲 / リスク / 子 PBI 候補の分析完了
parent:decomposed
↓ 子 PBI 群とその依存関係グラフが生成済み
parent:decomposition_approved
↓ 👤 人間承認（親計画ゲート）
↓
├─ child:planned → 子 PBI ごとに plan / todo / test-cases 生成
├─ child:approved → 子 PBI 単位の C-3 ゲート通過
└─ child:executing → 子 PBI exec 中（並行可能なものは並列）
↓ 全 required child が child:done
parent:integration_review
↓ 統合チェック + 親 PBI 受入基準カバレッジ確認
parent:done
各状態の詳細は docs/workflows/orchestrator-decomposition.md を参照。
docs/working/PBI-XXX/ # 親 PBI のディレクトリ
parent-plan.md # 親計画（テンプレート: docs/working/templates/parent-plan.md）
dependency-graph.md # 子 PBI 間の依存関係グラフ（mermaid）
parallelization-plan.md # 並行実行計画
integration-plan.md # 統合チェック / 親完了条件
risk-report.md # 親 PBI レベルの集約リスク
approvals/
parent-c3.json # 親計画の C-3 ゲート承認記録
parent-integration.json # 統合ゲート承認記録
children/
PBI-XXX-01.yaml # 子 PBI 仕様（schema: docs/schemas/child-pbi.yaml）
PBI-XXX-02.yaml
...
handoff.md # 親 PBI 完了時の引き継ぎパッケージ
子 PBI の作業コンテキストは既存の docs/working/TASK-XXXX/ 構造を再利用してもよいし、docs/working/PBI-XXX/children/PBI-XXX-NN/ 配下に独立して持ってもよい（実装 PBI で確定）。
| Agent | 責務 | 既存 v7 hybrid Agent との関係 |
|---|---|---|
| Parent Supervisor Agent | 親 PBI 分析 / 子 PBI 分割 / 依存関係管理 / 並行可否判定 / 親完了カバレッジ確認 | 既存 orchestrator を親 PBI 層に拡張 |
| Child Planner Agent | 子 PBI ごとの plan / todo / test-cases 作成 | 既存 solution-architect を子 PBI 単位に適用 |
| Child Implementer Agent | 子 PBI の実装 / PR 作成 | 既存 implementation-agent をそのまま再利用 |
| Review Agent | 差分レビュー / スコープ逸脱検出 / テスト不足検出 | 既存 qa-reviewer を子 PBI レビューに適用 |
| Integration Agent | 子 PBI 群の統合確認 / 親 PBI 受入基準カバレッジ確認 | 新規責務（既存 orchestrator の handoff 発行を拡張） |
| 既存 Agent | 単一 PBI 時の責務 | Orchestrator Mode 時の責務 |
|---|---|---|
orchestrator |
Workflow 遷移管理 / 完了条件判定 / handoff 発行 | 親 PBI 層の Supervisor を兼任 |
requirements-analyst |
要求 → 仕様変換 | 親 PBI 仕様 → 子 PBI 候補抽出を兼任 |
solution-architect |
仕様 → 実装構造設計 | 子 PBI 単位で Planner として動作 |
implementation-agent |
設計 → 実装 + 自己レビュー | 変更なし（子 PBI 単位で動作） |
qa-reviewer |
要件適合確認 + handoff 準備 | 子 PBI 単位 + 親統合の二層で動作 |
重要: 新規 Agent を機械的に追加するのではなく、既存 5 Agent の責務を 親 PBI 層 / 子 PBI 層 で再評価する。Integration Agent のみ新規責務として orchestrator を拡張する。詳細実装は別 PBI で確定する。
「Gate を消さない」原則の形式化。すべての条件は .claude/rules/orchestrator-mode.md で正本管理する。
ChildExecAllowed =
ChildPlanApproved
AND ParentPlanApproved
AND ScopeBoundaryDefined
AND DependencyResolved
AND RiskGatePassed
| 項目 | 意味 | 検証方法 |
|---|---|---|
ChildPlanApproved |
子 PBI の C-3 ゲート通過 | approvals/c3.json 存在 + decision=APPROVED |
ParentPlanApproved |
親 PBI の親計画ゲート通過 | approvals/parent-c3.json 存在 + decision=APPROVED |
ScopeBoundaryDefined |
子 PBI YAML に allowed_files / forbidden_files が定義済み |
schema validation |
DependencyResolved |
dependencies に列挙された全子 PBI が child:done |
状態追跡 |
RiskGatePassed |
子 PBI が高リスク領域なら追加承認取得済み | 高リスク領域定義表との突合 |
ParentDone =
AllRequiredChildrenAccepted
AND ParentAcceptanceCriteriaCovered
AND IntegrationChecksPassed
AND NoOpenBlockingGap
AND HumanOrPolicyFinalApprovalPassed
| 項目 | 意味 |
|---|---|
AllRequiredChildrenAccepted |
required な全子 PBI が child:done |
ParentAcceptanceCriteriaCovered |
親 PBI の受入基準すべてが少なくとも 1 つの子 PBI 受入基準でカバー |
IntegrationChecksPassed |
integration-plan.md の全チェック PASS |
NoOpenBlockingGap |
未解決の gap_detected イベントがない |
HumanOrPolicyFinalApprovalPassed |
統合ゲート（人間 or 自動 policy）APPROVE |
NewChildPBIAllowed =
GapDetected
AND (
WithinParentScope
OR HumanApprovedScopeChange
)
| 項目 | 意味 |
|---|---|
GapDetected |
exec 中に親完了条件カバレッジ未達が検出された |
WithinParentScope |
提案される子 PBI が親 PBI の in_scope 内 |
HumanApprovedScopeChange |
親スコープ外の場合は人間承認による親計画更新を要する |
新規子 PBI 作成は 親計画の更新 として扱い、reapproval_required 状態を経由する。
PlanGate Orchestrator Mode において、AI は以下のアクションを 完全自動で実施してはならない:
これらは Gate を通過するまで pending 状態にとどまる。AI は提案・分析・実装は行うが、最終決定権は人間または事前定義された policy に委ねる。
allowed_files の積集合が空）詳細な判定手順は docs/working/templates/parallelization-plan.md のテンプレートを参照。
| 軸 | 値 |
|---|---|
| 親 PBI モード | 通常 high-risk または critical（横断的影響のため） |
| 子 PBI モード | 親から制約を継承しつつ、個別に判定（light 〜 critical） |
| Workflow DSL | 既存 workflows/<mode>.yaml は子 PBI 単位で適用。親 PBI 用 DSL は実装 PBI で検討 |
5 mode（ultra-light / light / standard / high-risk / critical）の判定基準は .claude/rules/mode-classification.md を参照。
| カテゴリ | パス | 内容 |
|---|---|---|
| Schema | docs/schemas/child-pbi.yaml |
子 PBI YAML スキーマ |
| Workflow | docs/workflows/orchestrator-decomposition.md |
分解フロー定義 |
| Workflow | docs/workflows/orchestrator-integration.md |
統合フロー定義 |
| Template | docs/working/templates/parent-plan.md |
親計画テンプレート |
| Template | docs/working/templates/dependency-graph.md |
依存関係グラフテンプレート |
| Template | docs/working/templates/parallelization-plan.md |
並行実行計画テンプレート |
| Template | docs/working/templates/integration-plan.md |
統合計画テンプレート |
| Rule | .claude/rules/orchestrator-mode.md |
Gate 条件正本 |
| RFC | docs/rfc/plangate-decompose.md |
plangate decompose CLI RFC |
| 既存 | 関係 |
|---|---|
docs/plangate.md |
v5 ガバナンス正本。本書は単一 PBI 前提を拡張する |
docs/plangate-v7-hybrid.md |
v7 ハイブリッドアーキテクチャ。本書は同アーキテクチャを親 PBI 層へ拡張 |
.claude/rules/hybrid-architecture.md |
Rule 1〜5 + 境界ルール。本書はそれらを満たす設計 |
.claude/rules/working-context.md |
handoff 必須化。Orchestrator Mode では親 / 子両方で handoff を発行 |
plangate decompose CLI RFC（Status: Draft）plangate decompose CLI 実装