PlanGate をチーム / プロジェクトへ段階的に導入するための正本ロードマップ。 初回導入の心理的ハードルを「Day 1 で体験できる」レベルに下げる。 関連: #226 / TASK-0088 /
plangate.md/.claude/rules/mode-classification.md/ai/hook-enforcement.md/ai/versioning-stability-policy.md
PlanGate は 5 モード × 10 hook × 23 agent × 多数 skill の組み合わせを持つが、 全部入りは前提ではない。導入は「使うものだけを段階的に増やす」。各 フェーズには 使わなくてよいもの(最小セットの否定形) を明示する。
| フェーズ | いつ | モード | ゲート | 主目的 |
|---|---|---|---|---|
| Phase 0 | Day 1 | ultra-light | なし | 体験する |
| Phase 1 | Week 1 | light | C-1 簡易 | 計画を書く |
| Phase 2 | Week 2-3 | standard | C-1 + C-3 | ゲートで止める |
| Phase 3 | Month 1+ | standard + strict | C-1〜C-4 + V-3 | フル運用 |
モード判定の正本は
mode-classification.md。 本ガイドは「人が運用習熟度に応じて選ぶ初期値」を示す(タスク規模での 自動判定とは別軸。習熟が進めば規模判定に従う)。
ゴール: ultra-light モードで 1 タスクを最後まで完了し、3 コマンドの 流れを体感する。
bin/plangate init <TASK> → 手動実装 → bin/plangate doctor.claude/settings.json の hooks 未配線でも可)plan.md / C-1〜C-4 / V-1〜V-4 / 全エージェント / 全フック / metrics。
ゴール: pbi-input.md → plan.md の生成を体験し、「計画してから書く」 習慣をつくる。
project-planner(plan 生成)+ implementer(実装)EH-1(plan.md なし production code 編集ブロック /
check-plan-exists.sh)のみを warning で配線C-2 外部レビュー / C-3 ゲート / V-2〜V-4 / EH-2〜EH-9 / 残り 21 エージェント / metrics 収集。
ゴール: C-1 セルフレビューと C-3 計画承認ゲートを有効化し、「承認なしに exec しない」運用を確立する。
qa-reviewer(C-1/受け入れ)+
workflow-conductor(フェーズ制御)EH-1 + EH-2(C-3 承認なし exec ブロック /
check-c3-approval.sh)+ EH-3(plan_hash 改竄検知)を warningC-2 外部レビュー / V-4 / EHS-1〜3 / strict 配線 / 残りエージェント / Orchestrator Mode(親子 PBI)。
ゴール: ゲートを strict 化し、外部レビューとメトリクスを回す。
orchestrator +
専門 reviewer 群)EH-1〜EH-7 を strict(block)配線 + EH-9(委譲
commit/push 境界)。critical は EHS-1(V-3 必須)/ EHS-2(handoff 6
要素)/ EHS-3(fix loop 上限 escalation)bin/plangate metrics <TASK> --collect(metrics.md)プロジェクトに不要なら Orchestrator Mode は任意(単一 PBI のみなら不要)。
| 順序 | フック | 段階 | モード |
|---|---|---|---|
| 1 | EH-1(plan 存在) | Phase 1 | warning |
| 2 | EH-2(C-3 承認) / EH-3(plan_hash) | Phase 2 | warning |
| 3 | EH-4(test-cases)/ EH-5(検証ログ)/ EH-6(scope 外) | Phase 3 | block へ昇格 |
| 4 | EH-7(2 段階レビュー)/ EH-9(委譲境界) | Phase 3 | block |
| 5 | EHS-1〜3(strict 追加条件) | Phase 3 (critical) | block |
warning → block の昇格は破壊的変更(versioning-stability-policy.md §2.2 で major)。チーム合意の上でフェーズ境界に合わせて昇格する。
| 段階 | 必須エージェント | 体数 |
|---|---|---|
| Phase 0 | (なし) | 0 |
| Phase 1 | project-planner, implementer | 2 |
| Phase 2 | + qa-reviewer, workflow-conductor | 4 |
| Phase 3 | + orchestrator, reviewer 群(規模に応じ) | 〜23 |
残り 19 エージェントは Phase 3 まで明示的に不要。必要になった時点で
.claude/agents/ から個別に参照する(全部入り前提にしない)。
plangate.md — 全体像 / 3 コマンドフロー.claude/rules/mode-classification.md — 5 モード正本(規模自動判定)ai/hook-enforcement.md — フック正本(EH-1〜EHS-3)ai/versioning-stability-policy.md — warning→block 昇格の互換性扱い