mmorris35/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.
---
NEW — Install as a Skill (No MCP Server Required)
DevPlan is now available as a **standalone Claude Code skill** — no MCP server, no network dependency, no SSE timeouts. The entire DevPlan methodology runs locally as a first-class plugin.
Install
**Step 1** — Add this repo as a plugin marketplace:
**Step 2** — Install the plugin at user scope (available across all projects):
**Step 3** — Reload plugins to activate:
Usage
Invoke the skill directly:
Or use specific sub-commands:
Or just describe what you need — Claude will invoke the skill automatically:
What's Included
Skill vs MCP Server
| | Skill (NEW) | MCP Server |
|---|---|---|
| **Network** | None required | SSE connection to Cloudflare |
| **Reliability** | Always works | Subject to SSE timeouts |
| **Lessons system** | Use Nellie or your own | Built-in KV store |
| **Install** | /plugin install | claude mcp add |
| **Validation scripts** | Standalone bash | Server-side |
Both options are fully supported. The skill is recommended for reliability; the MCP server adds the lessons learned system and usage analytics.
---
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
Or add to ~/.claude.json under the mcpServers key:
Update Existing Installation
If you already have DevPlan installed, remove from both scopes and re-add:
Quick Start
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.
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 references
- ✅ Verification commands with expected outputs
Real-Time Progress with Task Tools
Generated executor and verifier agents integrate with Claude Code's Task tools for live progress visibility:
- **Executor agents** create tasks for each subtask, showing real-time spinners as work progresses