キャッチコピー: Governance × Modularity =「強固な運用 × 柔軟な実行」
親 PBI: #22 /
docs/working/TASK-0021/pbi-input.md
PlanGate v7 は、v5/v6 の「統制」と、Workflow / Skill / Agent 3 層モデルの「実行」を組み合わせた ハイブリッドアーキテクチャ。
両者は補完関係にあり、ハイブリッド化により 統制の強さを保ったまま、実行の再利用性・拡張性をスケールできる。
| Version | 位置付け | ドキュメント |
|---|---|---|
| v5 | 現行（ゲート型開発ワークフロー）。全 PBI で A→B→C-1〜D→L-0→V-1〜V-4→PR→C-4 を実行 | docs/plangate.md |
| v6 | ロードマップ（context-engineering 統合、決定論的フック、推論サンドイッチ 等） | docs/plangate-v6-roadmap.md |
| v7 | ハイブリッドアーキテクチャ（本書）。v5/v6 のガバナンスを維持しつつ、実行層を Workflow/Skill/Agent 3 層で再構築 | 本書 |
| 観点 | v5 | v6 | v7 |
|---|---|---|---|
| ゲート | A/B/C-1〜C-4 / L-0 / V-1〜V-4 | v5 踏襲 | v5 踏襲（統制層で維持） |
| 実行単位 | 各フェーズで特定 agent が動作 | 同左 + 決定論的フック | Workflow 5 phase + Skill 10 + Agent 5 責務 |
| 再利用 | 観点が plan.md に埋め込まれやすい | v5 の改善計画中 | Skill 層で再利用単位を分離 |
| 設計 artifact | plan.md のみ | v5 踏襲 | design.md（WF-03） を独立化 |
| 完了後資産 | status.md で進行管理 | v5 踏襲 | handoff.md（WF-05） を全 PBI 必須化 |
v5/v6 を置換せず、内側で拡張する設計。既存プロジェクトは v5/v6 運用を継続しつつ、段階的に v7 要素を opt-in できる。
PlanGate v5/v6 の責務を 4 軸で整理:
| 軸 | 責務 | v7 ハイブリッドでの実装 |
|---|---|---|
| GATE | 計画を止める | C-3 ゲート（三値）/ C-4 ゲート（GitHub PR）/ Workflow phase 完了条件 |
| STATUS | 状態を保存する | status.md + current-state.md + handoff.md |
| APPROVAL | 承認管理 | C-3 APPROVE / CONDITIONAL / REJECT / C-4 APPROVE / REQUEST CHANGES |
| ARTIFACT | 成果物正本化 | plan.md + design.md + handoff.md + review-self.md + review-external.md |
太字は v7 で追加・強化された要素。
| Phase | 目的 | 主担当 Agent |
|---|---|---|
| WF-01 Context Bootstrap | 前提・制約・品質基準を読み込む | orchestrator, requirements-analyst |
| WF-02 Requirement Expansion | 要件の抜け漏れ洗い出し | requirements-analyst, qa-reviewer |
| WF-03 Solution Design | 仕様を実装可能な構造へ落とす | solution-architect |
| WF-04 Build & Refine | 設計に従った最小単位実装 | implementation-agent |
| WF-05 Verify & Handoff | 品質確認 + handoff 発行 | qa-reviewer, orchestrator |
詳細: docs/workflows/
| カテゴリ | Skill |
|---|---|
| Scan | context-load / requirement-gap-scan |
| Check | nonfunctional-check / edgecase-enumeration / risk-assessment |
| Design | acceptance-criteria-build / architecture-sketch |
| Build | feature-implement |
| Review | acceptance-review / known-issues-log |
詳細: .claude/skills/, docs/workflows/skill-mapping.md
| Agent | 責務 |
|---|---|
orchestrator |
ワークフロー遷移管理 / 完了条件判定 |
requirements-analyst |
要求 → 仕様変換 |
solution-architect |
仕様 → 実装構造設計 |
implementation-agent |
設計 → 実装 + 自己レビュー |
qa-reviewer |
要件適合確認 + handoff 準備 |
詳細: .claude/agents/, docs/workflows/execution-sequence.md
| Rule | 内容 |
|---|---|
| Rule 1 | Workflow は順序と完了条件だけを持つ。実装ノウハウは書かない |
| Rule 2 | Skill は再利用単位に限定する。案件固有の話を入れない |
| Rule 3 | Agent は責務だけを持つ。ツール固有手順や案件固有仕様は持たせない |
| Rule 4 | 案件固有情報は CLAUDE.md に寄せる。Agent や Skill に埋め込まない |
| Rule 5 | 最終成果物は毎回 handoff に集約する。仕様 / 既知課題 / V2 候補 / 確認結果を残す |
正本ルール: .claude/rules/hybrid-architecture.md
Rule 4 を補完する 強制力の軸 での境界定義:
| 対象 | 役割 | 置き場所 | 強制力 |
|---|---|---|---|
| CLAUDE.md | 案件固有情報、常時必要な文脈 | プロジェクトルート | ソフト（LLM が参照） |
| Skill | 再利用可能な手順・観点（必要時だけ読み込む） | .claude/skills/ or .claude/commands/ |
ソフト（LLM が呼び出し） |
| Hook | 強制力が必要な決定論的制御（100% 強制） | .claude/settings.json の hooks |
ハード（harness が実行） |
| 用途 | 推奨配置 |
|---|---|
| プロジェクトのルール・制約 | CLAUDE.md |
| 再利用可能な観点・チェックリスト | Skill |
| 「絶対に通さない」制御（例: plan 未作成なら block） | Hook |
| 統制層（PlanGate） | 実行層（Workflow / Skill / Agent） |
|---|---|
| GATE（計画を止める） | Workflow phase 完了条件で制御 |
| STATUS（状態を保存） | status.md + current-state.md + handoff.md |
| APPROVAL（承認管理） | C-3 ゲート / C-4 ゲート |
| ARTIFACT（成果物正本化） | plan.md / design.md / handoff.md |
| PlanGate フェーズ | 対応する Workflow phase |
|---|---|
| A（PBI INPUT PACKAGE） | WF-01 Context Bootstrap |
| A / B（plan 前段） | WF-02 Requirement Expansion |
| B の一部 + C-1〜C-3 | WF-03 Solution Design |
| D（exec）+ C-1 + L-0 | WF-04 Build & Refine |
| V-1〜V-4 + handoff（新設） | WF-05 Verify & Handoff |
PlanGate 既存フェーズへの Workflow 挿入位置図: docs/workflows/plangate-insertion-map.md
orchestrator (WF-01)
→ requirements-analyst (WF-02: requirement-gap-scan)
→ qa-reviewer (WF-02: edgecase + AC 確定)
→ solution-architect (WF-03: architecture-sketch)
→ implementation-agent (WF-04: feature-implement + self-review)
→ qa-reviewer (WF-05: acceptance-review + known-issues-log)
→ orchestrator (handoff 発行)
詳細: docs/workflows/execution-sequence.md
.claude/rules/ で強制）注: 完全移行は必須ではありません。デュアル運用のままでも問題ありません。
Epic #53 で実装した Phase 1〜3 により、PlanGate は AI コーディングの開発統制 OS として機能する。
User Request
↓
PlanGate（エントリーポイント: /pg コマンド群）
↓
Intent Classifier（feature / bug / refactor / research / review / docs / ops）
↓
Risk / Mode Classifier（ultra-light / light / standard / high-risk / critical）
↓
Skill Policy Router（requiredSkills / requiresEvidence / requiresFailingTestFirst / requiresWorktree）
↓
Context Packager（Allowed Context: 対象ファイル / 仕様 / テスト / 制約 / コマンド / 禁止スコープ）
↓
Execution Gate（Design Gate → TDD Gate → Review Gate）
↓
Evidence Ledger（command / exitCode / outputExcerpt / type: test|review|diff|manual）
↓
Completion Gate（5 条件チェック: Design / TDD / Review / EvidenceLedger / 人間承認）
↓
PR Decision（APPROVE / BLOCK / CONDITIONAL）
| Phase | 内容 | 実装場所 | 状態 |
|---|---|---|---|
| Phase 1 | Intent Classifier / Mode Classifier / Skill Policy Router / /pg コマンド群 / Evidence Ledger |
plugin/plangate/skills/intent-classifier/ skills/skill-policy-router/ rules/evidence-ledger.md commands/pg-*.md |
✅ 完了（#54/#55/#56） |
| Phase 2 | Design Gate / TDD Gate / Review Gate / Completion Gate | plugin/plangate/rules/design-gate.md rules/review-gate.md rules/completion-gate.md commands/pg-tdd.md |
✅ 完了（#57） |
| Phase 3 | Context Packager / Subagent Roles / Subagent Dispatch / Worktree Policy / PR Decision | plugin/plangate/skills/context-packager/ rules/subagent-roles.md skills/subagent-dispatch/ rules/worktree-policy.md skills/pr-decision/ |
✅ 完了（#58） |
正本: plugin/plangate/skills/skill-policy-router/SKILL.md の Mode 別ポリシー表。本表は同 Skill が返す GatePolicy を要約したもの。
| Mode | 発火する Gate | 必須 Skill | 任意 Skill |
|---|---|---|---|
| ultra-light | Completion Gate（簡易） | verify |
check |
| light | Completion Gate | check, verify |
think, hunt |
| standard | Design + Completion Gate | think, check, verify |
hunt, tdd |
| high-risk | Design + TDD + Review + Completion Gate | think, approval, worktree, tdd, check, review, verify |
— |
| critical | 全 Gate（人間承認 + Rollback Plan 必須） | think, approval, worktree, tdd, review, verify |
— |
Skill 識別子の凡例: think（plan 立案）/ hunt（コード調査）/ check（self-review）/ tdd（failing test first）/ verify（test-cases 突合）/ worktree（独立ブランチ作業）/ review（外部レビュー）/ approval（人間承認）。
critical の追加要件:
なお、Control OS 系 Skill（intent-classifier / skill-policy-router / context-packager / subagent-dispatch / pr-decision / evidence-ledger / design-gate / review-gate）は Mode に関わらず PlanGate のエントリーフローで実行されるため、上記表の「必須 Skill」とは別カテゴリとして扱う（plugin/plangate/README.md 参照）。