最終更新: 2026-04-27 対象バージョン: plugin 0.5.0
PlanGate は当初、.claude/ ディレクトリを含むリポジトリ配布前提の構成でした。この構成は単一リポジトリ内では十分機能しますが、他プロジェクトへの横展開に課題があります:
.claude/ 設定を個別配布する手間これらを解決するため、PlanGate の Claude Code 側機能を plugin 形式で配布可能にしました（plugin/plangate/）。本ドキュメントは、既存利用者と新規利用者双方に向けた移行・導入ガイドです。
本 plugin は、既存の .claude/ 構成と 併存可能に設計されています:
.claude/ 側は削除せず温存plangate:<skill/agent> prefix を使用このため、既存利用者は急いで移行する必要はありません。plugin の安定性を確認してから段階的に移行できます。
| 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 判定 |
| Command | 役割 |
|---|---|
/working-context |
チケット単位の作業コンテキスト管理 |
/ai-dev-workflow |
PlanGate ワークフロー起動（plan → exec 等） |
/pg-check |
GatePolicy チェック・Completion Gate 確認 |
/pg-hunt |
問題調査・根本原因分析 |
/pg-tdd |
Red→Green→Refactor TDD cycle + Evidence Ledger 連携 |
/pg-think |
設計・実装前の構造化思考 |
/pg-verify |
成果物検証・受入基準突合 |
| 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 コード最適化 |
| Rule | 内容 |
|---|---|
working-context.md |
docs/working/ 配下の作業コンテキスト管理ルール |
review-principles.md |
CI/ローカル共通のレビュー判定フレーム |
mode-classification.md |
5 段階モード分類基準（ultra-light/light/standard/high-risk/critical） |
evidence-ledger.md |
Completion Gate ブロック条件の正本 |
design-gate.md |
high-risk 以上での Design Artifact 必須定義 |
review-gate.md |
6 観点レビュー・critical finding ブロック条件 |
completion-gate.md |
全 Gate 通過を一元管理する 5 条件チェックポイント |
subagent-roles.md |
6 ロール定義（planner/implementer/reviewer 等） |
worktree-policy.md |
high-risk: 必須（推奨）、critical: 必須（強制） |
以下は特定プロジェクトのインフラ/フレームワーク前提を持つため、汎用配布には不適合です:
| 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/
以下は opt-in 想定のため、本 plugin には含めません。必要時に手動追加、または将来的に別 plugin として提供予定:
security-auditor, penetration-tester, performance-optimizer運用熟成後に追加検討:
migration-agent, research-analyst, explorer-agent, project-planner, retrospective-analyst, scrum-master, agile-coach, documentation-writer, debugger, prompt-engineer, orchestrator, claude-code-reviewer, skill-designer, test-engineer, release-manager※ test-engineer と release-manager は現時点で .claude/agents/ に存在しません（implementer が兼務、release-manager は critical モード時のみ必要）。
本 plugin は Claude Code 専用です。Codex CLI 向け設定（.codex/）は別 plugin（例: openai-codex/codex）として扱ってください。将来的に統合を検討する可能性はありますが、現時点では対象外です。
plugin 内 agents から rules を参照する場合、plugin ルート相対パスを使用:
> 判定基準の正本: `plugin/plangate/rules/mode-classification.md`
従来の .claude/rules/ 参照は legacy 側で有効、plugin 側では書き換え済み。
# 基盤系（5）
plangate:brainstorming
plangate:self-review
plangate:subagent-driven-development
plangate:systematic-debugging
plangate:codex-multi-agent
# Control OS / 統制系（9, plugin 0.5.0 で追加）
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
Task(subagent_type="plangate:workflow-conductor", ...)
Task(subagent_type="plangate:spec-writer", ...)
# ...他も同様
Commands は /command-name 形式でそのまま呼び出し可能。解決順（plugin vs legacy）は Claude Code 内部仕様に従う。
# 1. plugin/plangate/ の存在を確認
ls plugin/plangate/
# 2. 既存の .claude/ と並行稼働させ、違和感なく使えるかテスト
# plugin 経由と legacy 経由の両方を使ってみる
特定プロジェクトで plugin 側に切り替えたい場合、Claude Code の plugin 有効化設定を変更:
.claude/settings.json で plugin を有効化.claude/agents/ に残すplugin の安定性を十分確認後、以下を段階的に実施:
.claude/{skills,commands,agents,rules}/ のうち、plugin で代替可能なものを削除.claude/ に残す.claude/ は project-specific override として使い分け注意: 完全移行は必須ではありません。デュアル運用のままでも問題ありません。
examples/ に追加）README.md 日本語化、英語版を README_en.md として分離）tests/run-tests.sh）と CI workflowbin/plangate validate --mode から参照（v8.0.0 / v8.1.0）bin/plangate review) / OpenCode exec (bin/plangate exec)（v8.1.0）※ 上記は現時点の構想であり、確約ではありません。
.claude/ は動かなくなりますか？A. いいえ。デュアル運用により、既存の .claude/ はそのまま動作します。
.claude/ 版で挙動に違いはありますか？A. 同梱されている skills / commands / agents / rules の 内容は原本と完全一致（rules 参照パスのみ plugin 内パスに書き換え）です。挙動の差はありません。
A. 本 plugin 自体の改変は推奨しません。代わりに、利用先プロジェクトの .claude/agents/ に配置してください。Claude Code は plugin 側と project 側を統合して認識します。
A. 現時点で計画なし。Codex CLI のエコシステムは別途（openai-codex/codex plugin 等）で整備されているため、本 plugin との統合は慎重に検討します。
ai-dev-workflow command がどう動くか分からないA. plugin 導入前: .claude/commands/ai-dev-workflow.md が呼ばれる。plugin 導入後: Claude Code の解決順に依存（plugin 優先 or 同名の後勝ち）。明示的に plugin 側を呼ぶ場合は plangate:ai-dev-workflow 形式を試してください（runtime 検証推奨）。