Transform ideas into executable development plans — an MCP server that brings the ClaudeCode-DevPlanBuilder methodology to Claude Code. Or add to ~/.claude.json under the mcpServers key: If you already have DevPlan installed, remove from both scopes and re-add: That's it. DevPlan will guide Claude through the entire process. DevPlan uses a scaffold → enhance → validate workflow that ensures every
Add this skill
npx mdskills install mmorris35/devplan-mcp-serverComprehensive MCP server with 21 tools for structured AI development workflows and multi-model support
1# DevPlan MCP Server23[](https://opensource.org/licenses/MIT)4[](https://modelcontextprotocol.io)5[](https://workers.cloudflare.com/)6[](#tools)78**Transform ideas into executable development plans** — an MCP server that brings the [ClaudeCode-DevPlanBuilder](https://github.com/mmorris35/ClaudeCode-DevPlanBuilder) methodology to Claude Code.910> **The Problem**: AI coding assistants often lose context, skip steps, or produce inconsistent code across sessions.11>12> **The Solution**: DevPlan creates detailed, Haiku-executable development plans with built-in validation, lessons learned, and issue remediation workflows.1314## Key Features1516| Feature | Description |17|---------|-------------|18| **Haiku-Executable Plans** | Plans so detailed that Claude Haiku can execute them mechanically |19| **Built-in Validation** | Validates plans are complete before execution begins |20| **Real-Time Progress Tracking** | Integrates with Claude Code's Task tools for live visibility |21| **Lessons Learned** | Captures issues from verification and injects them into future plans |22| **Issue Remediation** | Converts GitHub issues directly into remediation tasks |23| **Executor & Verifier Agents** | Auto-generates specialized agents with task tracking built-in |2425## Install2627```bash28claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user29```3031Or add to `~/.claude.json` under the `mcpServers` key:3233```json34{35 "mcpServers": {36 "devplan": {37 "type": "sse",38 "url": "https://mcp.devplanmcp.store/sse"39 }40 }41}42```4344### Update Existing Installation4546If you already have DevPlan installed, remove from both scopes and re-add:4748```bash49claude mcp remove devplan --scope project; claude mcp remove devplan --scope user; claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user50```5152## Quick Start5354```55You: "Use devplan_start to help me build a CLI tool for managing dotfiles"56```5758That's it. DevPlan will guide Claude through the entire process.5960## The DevPlan Workflow6162DevPlan uses a **scaffold → enhance → validate** workflow that ensures every plan is Haiku-executable before implementation begins.6364```mermaid65flowchart LR66 subgraph Planning["📋 Planning"]67 A[Interview] --> B[Brief]68 B --> C[Generate Scaffold]69 end7071 subgraph Enhancement["✨ Enhancement"]72 C --> D[Enhance with Code]73 D --> E{Validate}74 E -->|Fail| D75 E -->|Pass| F[Ready]76 end7778 subgraph Execution["⚡ Execution"]79 F --> G[Haiku Executes]80 G --> H[Sonnet Verifies]81 end8283 subgraph Learning["🧠 Learning"]84 H -->|issues| I[Capture Lessons]85 I -->|improve| C86 end8788 style E fill:#fff3e0,stroke:#f57c0089 style F fill:#c8e6c9,stroke:#2e7d3290 style I fill:#e3f2fd,stroke:#1565c091```9293### How It Works94951. **Interview** → DevPlan asks questions to understand your project962. **Brief** → Creates a structured PROJECT_BRIEF.md with requirements973. **Generate Scaffold** → `devplan_generate_plan` creates a starting template984. **Enhance with Code** → Claude (Opus/Sonnet) fills in complete, copy-pasteable code995. **Validate** → `devplan_validate_plan` checks the plan is Haiku-executable1006. **Execute** → Haiku implements each subtask mechanically1017. **Verify** → Sonnet tries to break the implementation1028. **Learn** → Issues become lessons for future projects103104### Validation Ensures Quality105106The validation step checks that plans are truly Haiku-executable:107108- ✅ Complete code blocks (not pseudocode or placeholders)109- ✅ All imports included in code blocks110- ✅ No "add to existing" instructions111- ✅ No cross-subtask references112- ✅ Verification commands with expected outputs113114```115# Example validation output116{117 "valid": true,118 "errors": [],119 "warnings": [],120 "stats": {121 "subtasks": 5,122 "codeBlocksChecked": 8,123 "issuesFound": 0124 }125}126```127128### Real-Time Progress with Task Tools129130Generated executor and verifier agents integrate with Claude Code's Task tools for live progress visibility:131132- **Executor agents** create tasks for each subtask, showing real-time spinners as work progresses133- **Verifier agents** create tasks for each verification phase (Smoke Tests, Feature Verification, Edge Cases, etc.)134- Progress is visible without scrolling — you always know what Claude is working on135136```137# Example: Executor tracks subtasks138TaskCreate({ subject: "1.2.3: Implement auth middleware", activeForm: "Implementing auth middleware" })139TaskUpdate({ taskId: "...", status: "in_progress" })140# ... work happens ...141TaskUpdate({ taskId: "...", status: "completed" })142```143144Both Task tools (real-time visibility) and DEVELOPMENT_PLAN.md (durable record) are updated — giving you the best of both worlds.145146## Usage Examples147148### New Project149```150"Use devplan_start to help me build [your idea]"151```152153### Fix a GitHub Issue154```bash155# Get issue JSON156gh issue view 123 --json number,title,body,labels,comments,url > issue.json157158# Then tell Claude:159"Use devplan_issue_to_task with this issue to create a remediation plan"160```161162### Check Progress163```164"Use devplan_progress_summary to show me where we are"165```166167## Multi-Model Support168169DevPlan generates plans and agent files for multiple AI coding tools and models. Use the `target` parameter to generate outputs for your preferred tool.170171### Supported Targets172173| Target | Tool | Agent File | Best For |174|--------|------|-----------|----------|175| `claude` | Claude Code | `CLAUDE.md` | Claude Code IDE (default) |176| `cursor` | Cursor IDE | `.cursorrules` | Cursor AI editor |177| `aider` | Aider CLI | `.aider.conf.yml` | Terminal-based AI pair programming |178| `cline` | VS Code Cline | `.cline/instructions.md` | VS Code extension |179| `windsurf` | Windsurf IDE | `.windsurf/rules.md` | Codium's AI IDE |180| `generic` | Any Model | `AGENTS.md` + files | Model-agnostic markdown format |181182### Using Targets183184When generating plans or agent files, specify the target tool:185186**Generate plan for Cursor:**187```188"Use devplan_generate_plan to create a plan, then I'll customize it for Cursor. Set target to 'cursor' for .cursorrules format"189```190191**Generate executor for Aider:**192```193"Use devplan_generate_executor with target='aider' to create an Aider-compatible executor agent"194```195196**Generate generic agent files:**197```198"Use devplan_generate_claude_md with target='generic' to create model-agnostic AGENTS.md files"199```200201### How Targets Work202203Each target has a dedicated **adapter** that transforms the DevPlan methodology into the appropriate format:204205- **Claude** - Generates `CLAUDE.md` with executor/verifier agents in `.claude/agents/`206- **Cursor** - Generates `.cursorrules` with all guidance in one file (Cursor doesn't support separate agents)207- **Aider** - Generates `.aider.conf.yml` with architect mode instructions208- **Cline** - Generates `.cline/instructions.md` with executor/verifier split209- **Windsurf** - Generates `.windsurf/rules.md` with cascade-optimized format210- **Generic** - Generates `AGENTS.md`, `EXECUTOR.md`, and `VERIFIER.md` for any tool211212### Examples213214**Start a new project for Cursor:**215```216"Use devplan_start to help me build a CLI tool, then generate the plan with target='cursor' for Cursor IDE"217```218219**Add executor for specific target:**220```221"I have a development plan. Use devplan_generate_executor with target='aider' to create the executor agent for Aider"222```223224**Compare adapter capabilities:**225See [docs/ADAPTERS.md](/docs/ADAPTERS.md) for a detailed comparison of each target's capabilities and limitations.226227## Tools228229### Planning230231| Tool | Purpose |232|------|---------|233| `devplan_start` | Main entry point - guides Claude through the methodology |234| `devplan_interview_questions` | Get questions to gather project requirements |235| `devplan_create_brief` | Generate PROJECT_BRIEF.md |236| `devplan_parse_brief` | Parse existing brief into structured data |237| `devplan_list_templates` | List project templates (cli, web_app, api, library) |238239### Generation240241| Tool | Purpose |242|------|---------|243| `devplan_generate_plan` | Generate DEVELOPMENT_PLAN.md scaffold with validation instructions |244| `devplan_generate_claude_md` | Generate CLAUDE.md scaffold |245| `devplan_generate_executor` | Generate Haiku-powered executor agent with Task tool integration |246| `devplan_generate_verifier` | Generate Sonnet-powered verifier agent with Task tool integration |247248### Validation & Execution249250| Tool | Purpose |251|------|---------|252| `devplan_validate_plan` | Validate plan structure and Haiku-executability |253| `devplan_get_subtask` | Get specific subtask details by ID |254| `devplan_update_progress` | Mark subtasks complete with notes |255| `devplan_progress_summary` | Get completion stats and next actions |256257### Lessons Learned258259Feedback loop that captures issues from verification and incorporates them into future plans.260261| Tool | Purpose |262|------|---------|263| `devplan_add_lesson` | Capture a lesson from verifier findings |264| `devplan_list_lessons` | List accumulated lessons by severity |265| `devplan_archive_lesson` | Archive old lessons without deleting them |266| `devplan_delete_lesson` | Remove outdated or incorrect lessons |267| `devplan_extract_lessons_from_report` | Auto-extract lessons from verification reports |268269### Issue Remediation270271Convert GitHub issues into structured remediation tasks — perfect for bug fixes and post-release maintenance.272273| Tool | Purpose |274|------|---------|275| `devplan_parse_issue` | Analyze a GitHub issue to extract requirements |276| `devplan_issue_to_task` | Generate remediation task with subtasks from an issue |277278### Analytics279280| Tool | Purpose |281|------|---------|282| `devplan_usage_stats` | View usage distribution across users |283284## Why DevPlan?285286| Without DevPlan | With DevPlan |287|-----------------|--------------|288| Context lost between sessions | Plans preserve full context |289| Inconsistent code quality | Haiku follows exact specifications |290| Same mistakes repeated | Lessons learned system prevents recurrence |291| No verification step | Sonnet actively tries to break the code |292| Bugs found in production | Issues caught before release |293| Plans need interpretation | Validated plans are copy-paste ready |294295## Dashboard & Analytics296297DevPlan includes a public dashboard for viewing aggregate usage statistics:298299**Dashboard URL**: [devplanmcp.store/dashboard](https://devplanmcp.store/dashboard)300301The dashboard shows:302- **Summary cards**: Total sessions, total tool calls, countries reached303- **Line chart**: Sessions and tool calls over the last 30 days304- **Country table**: Top 10 countries by session count305306### Privacy307308All analytics are privacy-preserving:309- **No IP storage**: Only Cloudflare-derived country/region codes310- **No user identification**: Sessions are anonymous311- **Auto-expiration**: Daily stats expire after 90 days via KV TTL312313## Development314315```bash316npm install317npm run dev # Local development318npm run deploy # Deploy to Cloudflare Workers319```320321## Contributing322323Contributions welcome! Please see the [ClaudeCode-DevPlanBuilder](https://github.com/mmorris35/ClaudeCode-DevPlanBuilder) repo for methodology details.324325## License326327MIT328329---330331<p align="center">332 <b>Built for Claude Code</b><br>333 <a href="https://modelcontextprotocol.io">Model Context Protocol</a> •334 <a href="https://workers.cloudflare.com/">Cloudflare Workers</a> •335 <a href="https://github.com/mmorris35/ClaudeCode-DevPlanBuilder">DevPlanBuilder Methodology</a>336</p>337
Full transparency — inspect the skill content before installing.