DevPlan MCP Server

DevPlan MCP Server

アイデアを実行可能な開発計画に変換 — ClaudeCode-DevPlanBuilder の手法を Claude Code に導入する MCP サーバーです。

問題：AI コーディングアシスタントは、セッションをまたいでコンテキストを失ったり、手順を省略したり、一貫性のないコードを生成したりすることがよくあります。

解決策：DevPlan は、組み込みの検証機能、学習した教訓、インラインの git ワークフローを備えた、詳細でエージェントが実行できる開発計画を作成します。

---

新機能 — スキルとしてインストール（MCP サーバー不要）

DevPlan がスタンドアロンの Claude Code スキルとして利用できるようになりました。MCP サーバー、ネットワーク依存、SSE タイムアウトは不要です。DevPlan の手法全体を、ファーストクラスのプラグインとしてローカルで実行できます。

インストール

ステップ 1 — このリポジトリをプラグインマーケットプレイスとして追加します：

/plugin marketplace add mmorris35/devplan-mcp-server

ステップ 2 — ユーザースコープでプラグインをインストールします（すべてのプロジェクトで利用可能です）：

/plugin install devplan@mmorris35 --scope user

ステップ 3 — プラグインを再読み込みして有効にします：

/reload-plugins

使用方法

スキルを直接呼び出します：

/devplan

または、特定のサブコマンドを使用します：

/devplan brief          — Create or parse a PROJECT_BRIEF.md
/devplan plan           — Generate a Haiku-executable DEVELOPMENT_PLAN.md
/devplan agents         — Generate executor (Haiku) and verifier (Sonnet) agents
/devplan claude-md      — Generate a project CLAUDE.md
/devplan validate       — Check plan structure and Haiku-executability
/devplan progress       — Show completion status
/devplan export mermaid — Generate a Mermaid flowchart of the plan
/devplan issue <number> — Convert a GitHub issue to a remediation task
/devplan implement      — Kickoff the build with executor + verifier agents

または、必要なことを説明するだけで、Claude がスキルを自動的に呼び出します：

"Help me plan a CLI tool for managing dotfiles"
"Create a development plan for this project"
"Validate my development plan"

含まれる内容

skills/devplan/
├── SKILL.md                 — Core methodology, interview flow, dispatch
├── references/
│   ├── templates.md         — Brief/plan/CLAUDE.md templates (CLI, web app, API, library)
│   ├── validation.md        — Structure + Haiku-executability rules + battle-tested lessons
│   ├── agents.md            — Executor and verifier agent generation patterns
│   └── workflows.md         — Mermaid/ReactFlow export + progress tracking
├── scripts/
│   ├── validate-plan.sh     — Structural validation (standalone)
│   └── check-haiku.sh       — Haiku-executability checker (standalone)
└── examples/
    └── hello-cli-plan.md    — Gold standard reference plan

スキルと MCP サーバーの比較

	スキル（新機能）	MCP サーバー
ネットワーク	不要	Cloudflare への SSE 接続
信頼性	常に動作	SSE タイムアウトの影響を受ける
学習した教訓のシステム	Nellie または独自のものを使用	組み込みの KV ストア
インストール	/plugin install	claude mcp add
検証スクリプト	スタンドアロンの bash	サーバー側

どちらの方法も完全にサポートされています。信頼性を重視する場合はスキルがおすすめです。MCP サーバーには、学習した教訓のシステムと利用状況の分析機能が追加されています。

---

主な機能

機能	説明
エージェントが実行できる計画	あらゆる LLM コーディングエージェントが機械的に実行できるほど詳細な計画
組み込みの検証機能	実行開始前に計画が完全であることを検証
リアルタイムの進捗追跡	Claude Code の Task ツールと連携し、進捗をリアルタイムで確認
学習した教訓	検証で見つかった問題を記録し、今後の計画に反映
課題の修正	GitHub の課題を修正タスクに直接変換
実行エージェントと検証エージェント	タスク追跡機能を組み込んだ専用エージェントを自動生成

インストール

claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user

または、~/.claude.json の mcpServers キーの下に追加します：

{
  "mcpServers": {
    "devplan": {
      "type": "sse",
      "url": "https://mcp.devplanmcp.store/sse"
    }
  }
}

既存のインストールの更新

すでに DevPlan をインストールしている場合は、両方のスコープから削除して再追加します：

claude mcp remove devplan --scope project; claude mcp remove devplan --scope user; claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user

クイックスタート

You: "Use devplan_start to help me build a CLI tool for managing dotfiles"

これで完了です。DevPlan が全プロセスを通じて Claude をガイドします。

DevPlan のワークフロー

DevPlan は、実装を始める前にすべての計画がエージェントによって実行可能であることを保証する、足場の作成 → 強化 → 検証のワークフローを使用します。

flowchart LR
    subgraph Planning["📋 Planning"]
        A[Interview] --> B[Brief]
        B --> C[Generate Scaffold]
    end

    subgraph Enhancement["✨ Enhancement"]
        C --> D[Enhance with Code]
        D --> E{Validate}
        E -->|Fail| D
        E -->|Pass| F[Ready]
    end

    subgraph Execution["⚡ Execution"]
        F --> G[Agent Executes]
        G --> H[Agent Verifies]
    end

    subgraph Learning["🧠 Learning"]
        H -->|issues| I[Capture Lessons]
        I -->|improve| C
    end

    style E fill:#fff3e0,stroke:#f57c00
    style F fill:#c8e6c9,stroke:#2e7d32
    style I fill:#e3f2fd,stroke:#1565c0

仕組み

1. ヒアリング → DevPlan がプロジェクトを理解するための質問をします
2. 概要 → 要件をまとめた構造化された PROJECT_BRIEF.md を作成します
3. 足場の生成 → devplan_generate_plan が基盤となるフェーズと機能リストを作成します
4. コードによる強化 → AI エージェントが機能フェーズを構成し、完全でコピー＆ペースト可能なコードを入力します
5. 検証 → devplan_validate_plan が計画をエージェントが実行できるか確認します
6. 実行 → 実行エージェントがインラインの git コマンドを使って各サブタスクを実装します
7. 検証 → 検証エージェントが実装を壊そうと試みます
8. 学習 → 問題を今後のプロジェクトに役立つ教訓に変換します

検証で品質を確保

検証ステップでは、計画が実際に実行可能かどうかを確認します。

• ✅ 完全なコードブロック（疑似コードやプレースホルダーではない）
• ✅ すべてのインポートがコードブロックに含まれている
• ✅ 「既存のものに追加する」という指示がない
• ✅ サブタスク間の相互参照がない
• ✅ 期待される出力を含む検証コマンド

# Example validation output
{
  "valid": true,
  "errors": [],
  "warnings": [],
  "stats": {
    "subtasks": 5,
    "codeBlocksChecked": 8,
    "issuesFound": 0
  }
}

タスクツールによるリアルタイムの進捗表示

生成された実行エージェントと検証エージェントは、Claude Code のタスクツールと連携し、進捗をリアルタイムで確認できます。

• 実行エージェントは各サブタスクのタスクを作成し、作業の進捗に合わせてリアルタイムのスピナーを表示します
• 検証エージェントは検証フェーズごとにタスクを作成します（スモークテスト、機能検証、エッジケースなど）
• スクロールせずに進捗を確認できるため、Claude が何に取り組んでいるかを常に把握できます

# Example: Executor tracks subtasks
TaskCreate({ subject: "1.2.3: Implement auth middleware", activeForm: "Implementing auth middleware" })
TaskUpdate({ taskId: "...", status: "in_progress" })
# ... work happens ...
TaskUpdate({ taskId: "...", status: "completed" })

タスクツール（リアルタイムの表示）と DEVELOPMENT_PLAN.md（永続的な記録）の両方が更新されるため、両方のメリットを活用できます。

使用例

新しいプロジェクト

"Use devplan_start to help me build [your idea]"

GitHub の Issue を修正

# Get issue JSON
gh issue view 123 --json number,title,body,labels,comments,url > issue.json

# Then tell Claude:
"Use devplan_issue_to_task with this issue to create a remediation plan"

進捗を確認

"Use devplan_progress_summary to show me where we are"

複数モデルのサポート

DevPlan は、複数の AI コーディングツールやモデル向けに、計画とエージェントファイルを生成します。target パラメーターを指定すると、使用するツールに合わせて出力を生成できます。

サポート対象

Target	Tool	Agent File	Best For
claude	Claude Code	CLAUDE.md	Claude Code IDE（デフォルト）
cursor	Cursor IDE	.cursorrules	Cursor AI エディター
aider	Aider CLI	.aider.conf.yml	ターミナルベースの AI ペアプログラミング
cline	VS Code Cline	.cline/instructions.md	VS Code 拡張機能
windsurf	Windsurf IDE	.windsurf/rules.md	Codium の AI IDE
generic	任意のモデル	AGENTS.md + files	モデルに依存しない Markdown 形式

ターゲットの使用

計画やエージェントファイルを生成する際は、対象のツールを指定します。

Cursor 向けの計画を生成：

"Use devplan_generate_plan to create a plan, then I'll customize it for Cursor. Set target to 'cursor' for .cursorrules format"

Aider 向けの実行エージェントを生成：

"Use devplan_generate_executor with target='aider' to create an Aider-compatible executor agent"

汎用エージェントファイルを生成：

"Use devplan_generate_claude_md with target='generic' to create model-agnostic AGENTS.md files"

ターゲットの仕組み

各ターゲットには、DevPlan の手法を適切な形式に変換する専用のアダプターがあります。

• Claude - .claude/agents/ に実行エージェント／検証エージェントを含む CLAUDE.md を生成します
• Cursor - すべてのガイダンスを1つのファイルにまとめた .cursorrules を生成します（Cursor は個別のエージェントに対応していません）
• Aider - アーキテクトモードの指示を含む .aider.conf.yml を生成します
• Cline - 実行エージェントと検証エージェントを分けた .cline/instructions.md を生成します
• Windsurf - カスケードに最適化された形式の .windsurf/rules.md を生成します
• Generic - あらゆるツールで使える AGENTS.md、EXECUTOR.md、VERIFIER.md を生成します

例

Cursor 向けに新しいプロジェクトを開始：

"Use devplan_start to help me build a CLI tool, then generate the plan with target='cursor' for Cursor IDE"

特定のターゲット向けに実行エージェントを追加：

"I have a development plan. Use devplan_generate_executor with target='aider' to create the executor agent for Aider"

アダプターの機能を比較： 各ターゲットの機能と制限について詳しくは、docs/ADAPTERS.md をご覧ください。

ツール

計画

Tool	Purpose
devplan_start	主なエントリーポイント。Claude を手法に沿って案内します
devplan_interview_questions	プロジェクト要件の収集に使う質問を取得します
devplan_create_brief	PROJECT_BRIEF.md を生成します
devplan_parse_brief	既存のブリーフを構造化データに解析します
devplan_list_templates	プロジェクトテンプレート（cli、web_app、api、library）を一覧表示します

生成

Tool	Purpose
devplan_generate_plan	検証手順を含む DEVELOPMENT_PLAN.md のひな形を生成します
devplan_generate_claude_md	CLAUDE.md のひな形を生成します
devplan_generate_executor	タスクツールと連携する実行エージェントを生成します
devplan_generate_verifier	タスクツールと連携する検証エージェントを生成します

検証と実行

ツール	目的
devplan_validate_plan	計画の構造とエージェントによる実行可能性を検証します
devplan_get_subtask	IDを指定してサブタスクの詳細を取得します
devplan_update_progress	メモを添えてサブタスクを完了としてマークします
devplan_progress_summary	完了状況の統計と次のアクションを取得します

学んだ教訓

検証で見つかった問題を記録し、今後の計画に反映するフィードバックループです。

ツール	目的
devplan_add_lesson	検証担当エージェントの指摘から教訓を記録します
devplan_list_lessons	重大度別に蓄積された教訓を一覧表示します
devplan_archive_lesson	古い教訓を削除せずにアーカイブします
devplan_delete_lesson	古くなった、または誤った教訓を削除します
devplan_extract_lessons_from_report	検証レポートから教訓を自動抽出します

課題の修正

GitHub の課題を構造化された修正タスクに変換します。バグ修正やリリース後のメンテナンスに最適です。

ツール	目的
devplan_parse_issue	GitHub の課題を分析して要件を抽出します
devplan_issue_to_task	課題からサブタスク付きの修正タスクを生成します

分析

ツール	目的
devplan_usage_stats	ユーザーごとの利用状況の分布を確認します

DevPlan を選ぶ理由

DevPlan を使わない場合	DevPlan を使う場合
セッション間でコンテキストが失われます	計画によってコンテキスト全体が保持されます
コード品質に一貫性がありません	実行エージェントが正確な仕様に従います
同じ間違いが繰り返されます	学んだ教訓のシステムによって再発を防ぎます
検証のステップがありません	検証エージェントがコードの問題を積極的に探します
本番環境でバグが見つかります	リリース前に問題を検出します
計画の解釈が必要です	検証済みの計画はコピー＆ペーストですぐに使えます

ダッシュボードと分析

DevPlan には、利用統計の集計を確認できる公開ダッシュボードが含まれています。

ダッシュボード URL：devplanmcp.store/dashboard

ダッシュボードには、次の情報が表示されます。

• 概要カード：セッション総数、ツール呼び出し総数、利用のあった国
• 折れ線グラフ：過去 30 日間のセッション数とツール呼び出し数
• 国別テーブル：セッション数が多い上位 10 か国

プライバシー

すべての分析データはプライバシーに配慮して処理されます。

• IP アドレスの保存なし：Cloudflare から取得した国／地域コードのみを使用します
• ユーザーの特定なし：セッションは匿名です
• 自動期限切れ：KV TTL により、日次統計は 90 日後に期限切れになります

開発

npm install
npm run dev      # Local development
npm run deploy   # Deploy to Cloudflare Workers

コントリビューション

コントリビューションを歓迎します！手法の詳細は、ClaudeCode-DevPlanBuilder リポジトリをご覧ください。

ライセンス

MIT

---

Claude Code 向けに構築
Model Context Protocol • Cloudflare Workers • DevPlanBuilder の手法