DevPlan MCP Server

Transform ideas into executable development plans — an MCP server that brings the ClaudeCode-DevPlanBuilder methodology to Claude Code.

The Problem: AI coding assistants often lose context, skip steps, or produce inconsistent code across sessions.

The Solution: DevPlan creates detailed, agent-executable development plans with built-in validation, lessons learned, and inline git workflows.

Key Features

| Feature | Description | |---------|-------------| | Agent-Executable Plans | Plans so detailed that any LLM coding agent can execute them mechanically | | Built-in Validation | Validates plans are complete before execution begins | | Real-Time Progress Tracking | Integrates with Claude Code's Task tools for live visibility | | Lessons Learned | Captures issues from verification and injects them into future plans | | Issue Remediation | Converts GitHub issues directly into remediation tasks | | Executor & Verifier Agents | Auto-generates specialized agents with task tracking built-in |

Install

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

Or add to ~/.claude.json under the mcpServers key:

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

Update Existing Installation

If you already have DevPlan installed, remove from both scopes and re-add:

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

Quick Start

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

That's it. DevPlan will guide Claude through the entire process.

The DevPlan Workflow

DevPlan uses a scaffold → enhance → validate workflow that ensures every plan is agent-executable before implementation begins.

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

How It Works

1. Interview → DevPlan asks questions to understand your project
2. Brief → Creates a structured PROJECT_BRIEF.md with requirements
3. Generate Scaffold → devplan_generate_plan creates foundation phases + a feature list
4. Enhance with Code → Your AI agent structures feature phases and fills in complete, copy-pasteable code
5. Validate → devplan_validate_plan checks the plan is agent-executable
6. Execute → Executor agent implements each subtask with inline git commands
7. Verify → Verifier agent tries to break the implementation
8. Learn → Issues become lessons for future projects

Validation Ensures Quality

The validation step checks that plans are truly executable:

• ✅ Complete code blocks (not pseudocode or placeholders)
• ✅ All imports included in code blocks
• ✅ No "add to existing" instructions
• ✅ No cross-subtask refere

... View full README on GitHub