PlanGate

PlanGate Claude Code Plugin 移行ガイド

最終更新: 2026-06-04 対象バージョン: plugin 8.11.0 対象ツール: Claude Code / Codex（両対応）

背景・目的

PlanGate は当初、.claude/ ディレクトリを含むリポジトリ配布前提の構成でした。この構成は単一リポジトリ内では十分機能しますが、他プロジェクトへの横展開に課題があります:

これらを解決するため、PlanGate の Claude Code 側機能を plugin 形式で配布可能にしました（plugin/plangate/）。本ドキュメントは、既存利用者と新規利用者双方に向けた移行・導入ガイドです。

デュアル運用の前提

本 plugin は、既存の .claude/ 構成と 併存可能に設計されています:

このため、既存利用者は急いで移行する必要はありません。plugin の安定性を確認してから段階的に移行できます。

インストール方法

Marketplace から 1 コマンド（推奨）

# Claude Code セッション内
/plugin marketplace add s977043/PlanGate
/plugin install plangate

# CLI から
claude plugin marketplace add s977043/PlanGate && claude plugin install plangate
codex plugin marketplace add s977043/PlanGate   # スキル展開は clone 後に sh install.sh --codex

install.sh を使う

git clone https://github.com/s977043/plangate.git ~/plangate
cd path/to/your-project
sh ~/plangate/install.sh   # .claude/ と .codex/ を自動検出

同梱範囲（plugin 8.11.0）

Skills (37)

Skill 役割
brainstorming アイデア → 設計書（PBI INPUT PACKAGE）への昇華
self-review 変更内容の17項目体系的セルフレビュー
subagent-driven-development サブエージェント駆動の2段階レビュー開発
systematic-debugging エビデンスベースの体系的デバッグ
codex-multi-agent Codex マルチエージェント連携
setup-team タスク規模・モードに応じたマルチエージェントチーム設計
intent-classifier User Request を 7 分類（feature/bug/refactor 等）
skill-policy-router Intent + Mode → GatePolicy（requiredSkills 等）決定
evidence-ledger 証拠記録・Completion Gate 連携
design-gate high-risk 以上での設計 Artifact 8 項目必須チェック
review-gate 6 観点レビュー・critical finding → Completion Gate ブロック
context-packager Allowed Context 6 要素の構造化出力
subagent-dispatch 依存関係グラフ生成・並列実行可能タスク特定・dispatch
pr-decision Evidence Ledger + Review Gate から APPROVE/BLOCK/CONDITIONAL 判定

Commands (4)

Command 役割
/working-context チケット単位の作業コンテキスト管理
/ai-dev-workflow PlanGate ワークフロー起動（plan → exec 等）
/codex-mvp-split Codex 向け MVP / バックログ分割
/plangate-setup PlanGate セットアップ（setup-coordinator へ委譲）

Agents (23)

責務別エージェント 23 件を同梱（全一覧は plugin/plangate/README.md の ### Agents (23) を参照）。主要なもの:

Agent 役割
workflow-conductor PlanGate 全フェーズの制御
spec-writer PBI → plan/todo/test-cases 生成
implementer TDD 実装
linter-fixer L-0 リンター自動修正
acceptance-tester V-1 受入検査
code-optimizer V-2 コード最適化
orchestrator 親 PBI 分解・統合の最終統括
qa-reviewer handoff 中核作成・要件適合確認

他に agile-coach / scrum-master / requirements-analyst / solution-architect / research-analyst / retrospective-analyst / project-planner / setup-coordinator / skill-designer / prompt-engineer / migration-agent / implementation-agent / explorer-agent / documentation-writer / claude-code-reviewer を含む。

Rules (6)

Rule 内容
hybrid-architecture.md v7 ハイブリッドアーキテクチャ Rule 1〜5（配置責務）
mode-classification.md 5 段階モード分類基準（ultra-light/light/standard/high-risk/critical）
orchestrator-mode.md Orchestrator Mode の Gate 条件・AI 自己完結禁止条項
responsibility-classes.md 責務 4 分類（AI/Human/CI/Workflow-owned）
review-principles.md CI/ローカル共通のレビュー判定フレーム
working-context.md docs/working/ 配下の作業コンテキスト管理ルール

注: design-gate / review-gate / evidence-ledger 等は rules ではなく skills として plugin/plangate/skills/ に同梱されています。

対象外の理由

プロジェクト固有 agents (plugin 未同梱)

以下は特定プロジェクトのインフラ/フレームワーク前提を持つため、汎用配布には不適合です:

Agent 固有前提
backend-specialist Laravel 11、クリーンアーキテクチャ
frontend-specialist TypeScript、特定フレームワーク
database-architect PostgreSQL 16、Eloquent ORM
devops-engineer AWS ECS + CodeBuild + CodeDeploy + Terraform

入手方法: 必要に応じ、plangate リポジトリから個別にコピー:

git clone https://github.com/s977043/plangate.git
cp plangate/.claude/agents/backend-specialist.md your-project/.claude/agents/

専門用途 agents (plugin 未同梱)

以下は opt-in 想定のため、本 plugin には含めません。必要時に手動追加、または将来的に別 plugin として提供予定:

補助 agents (plugin 未同梱)

運用熟成後に追加検討:

※ test-engineer と release-manager は現時点で .claude/agents/ に存在しません（implementer が兼務、release-manager は critical モード時のみ必要）。

Codex CLI 対応

本 plugin は Claude Code と Codex の両方に対応しています。

詳細は plugin/plangate/README.md の Codex インストール手順 を参照してください。

Plugin 内 Rules 参照規則

plugin 内 agents から rules を参照する場合、plugin ルート相対パスを使用:

> 判定基準の正本: `plugin/plangate/rules/mode-classification.md`

従来の .claude/rules/ 参照は legacy 側で有効、plugin 側では書き換え済み。

Plugin 内 Agent/Skill 呼び出し規則

Skills

# 基盤系（5）
plangate:brainstorming
plangate:self-review
plangate:subagent-driven-development
plangate:systematic-debugging
plangate:codex-multi-agent

# Control OS / 統制系（plugin 同梱の統制スキル群）
plangate:setup-team
plangate:intent-classifier
plangate:skill-policy-router
plangate:evidence-ledger
plangate:design-gate
plangate:review-gate
plangate:context-packager
plangate:subagent-dispatch
plangate:pr-decision

Agents

Task(subagent_type="plangate:workflow-conductor", ...)
Task(subagent_type="plangate:spec-writer", ...)
# ...他も同様

Commands

Commands は /command-name 形式でそのまま呼び出し可能。解決順（plugin vs legacy）は Claude Code 内部仕様に従う。

手動コピー版からの移行（#224）

.claude/commands/ 等を手動コピー / 派生して運用している消費側 （ai-agent-template / growth-lab 等）向けの 手動コピー起点の移行手順・ Plugin 安定性宣言・バージョン同期メカニズム（release archive 方式）・ カスタマイズ API（overlay precedence） の正本は docs/ai/plugin-stability-and-sync.md。 本ドキュメント（段階移行・FAQ）と併用する。

既存利用者向け段階的移行手順

Phase 1: 評価（推奨: 1 週間程度）

# 1. plugin/plangate/ の存在を確認
ls plugin/plangate/

# 2. 既存の .claude/ と並行稼働させ、違和感なく使えるかテスト
# plugin 経由と legacy 経由の両方を使ってみる

Phase 2: 部分移行

特定プロジェクトで plugin 側に切り替えたい場合、Claude Code の plugin 有効化設定を変更:

Phase 3: 完全移行（将来、オプション）

plugin の安定性を十分確認後、以下を段階的に実施:

注意: 完全移行は必須ではありません。デュアル運用のままでも問題ありません。

将来計画

完了済み（〜2026-04）

短期（〜3 ヶ月）

長期（6 ヶ月〜）

※ 上記は現時点の構想であり、確約ではありません。

FAQ

Q. plugin を入れると既存の .claude/ は動かなくなりますか？

A. いいえ。デュアル運用により、既存の .claude/ はそのまま動作します。

Q. plugin 版と .claude/ 版で挙動に違いはありますか？

A. 同梱されている skills / commands / agents / rules の 内容は原本と完全一致（rules 参照パスのみ plugin 内パスに書き換え）です。挙動の差はありません。

Q. 自分のプロジェクト固有 agents を plugin に追加したい

A. 本 plugin 自体の改変は推奨しません。代わりに、利用先プロジェクトの .claude/agents/ に配置してください。Claude Code は plugin 側と project 側を統合して認識します。

Q. Codex CLI でも使える？

A. はい。codex plugin marketplace add s977043/PlanGate または sh install.sh --codex でインストールできます。Claude Code と Codex 両対応の .claude-plugin/marketplace.json が含まれています。

Q. 既存の ai-dev-workflow command がどう動くか分からない

A. plugin 導入前: .claude/commands/ai-dev-workflow.md が呼ばれる。plugin 導入後: Claude Code の解決順に依存（plugin 優先 or 同名の後勝ち）。明示的に plugin 側を呼ぶ場合は plangate:ai-dev-workflow 形式を試してください（runtime 検証推奨）。

参考リンク

This site is open source. Improve this page.