{"id":44407984,"url":"https://github.com/mmorris35/devplan-mcp-server","last_synced_at":"2026-02-12T06:48:30.858Z","repository":{"id":328077034,"uuid":"1113261221","full_name":"mmorris35/devplan-mcp-server","owner":"mmorris35","description":"MCP server for generating development plans, project roadmaps, and task breakdowns for Claude Code. Turn project ideas into paint-by-numbers implementation plans.","archived":false,"fork":false,"pushed_at":"2026-02-01T07:15:17.000Z","size":870,"stargazers_count":1,"open_issues_count":10,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-01T12:43:14.815Z","etag":null,"topics":["ai-coding","claude","claude-code","development-plan","mcp","mcp-server","prd","project-planning","roadmap","task-management"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mmorris35.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-09T18:31:23.000Z","updated_at":"2026-02-01T05:44:17.000Z","dependencies_parsed_at":"2026-02-01T03:09:51.817Z","dependency_job_id":null,"html_url":"https://github.com/mmorris35/devplan-mcp-server","commit_stats":null,"previous_names":["mmorris35/devplan-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mmorris35/devplan-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmorris35%2Fdevplan-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmorris35%2Fdevplan-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmorris35%2Fdevplan-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmorris35%2Fdevplan-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmorris35","download_url":"https://codeload.github.com/mmorris35/devplan-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmorris35%2Fdevplan-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29360644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T01:03:07.613Z","status":"online","status_checked_at":"2026-02-12T02:00:06.911Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","claude","claude-code","development-plan","mcp","mcp-server","prd","project-planning","roadmap","task-management"],"created_at":"2026-02-12T06:48:30.358Z","updated_at":"2026-02-12T06:48:30.850Z","avatar_url":"https://github.com/mmorris35.png","language":"TypeScript","funding_links":[],"categories":["Project Management Mcp Servers","📦 Other"],"sub_categories":[],"readme":"# DevPlan MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-purple.svg)](https://modelcontextprotocol.io)\n[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-orange.svg)](https://workers.cloudflare.com/)\n[![21 Tools](https://img.shields.io/badge/Tools-21-blue.svg)](#tools)\n\n**Transform ideas into executable development plans** — an MCP server that brings the [ClaudeCode-DevPlanBuilder](https://github.com/mmorris35/ClaudeCode-DevPlanBuilder) methodology to Claude Code.\n\n\u003e **The Problem**: AI coding assistants often lose context, skip steps, or produce inconsistent code across sessions.\n\u003e\n\u003e **The Solution**: DevPlan creates detailed, Haiku-executable development plans with built-in validation, lessons learned, and issue remediation workflows.\n\n## Key Features\n\n| Feature | Description |\n|---------|-------------|\n| **Haiku-Executable Plans** | Plans so detailed that Claude Haiku can execute them mechanically |\n| **Built-in Validation** | Validates plans are complete before execution begins |\n| **Real-Time Progress Tracking** | Integrates with Claude Code's Task tools for live visibility |\n| **Lessons Learned** | Captures issues from verification and injects them into future plans |\n| **Issue Remediation** | Converts GitHub issues directly into remediation tasks |\n| **Executor \u0026 Verifier Agents** | Auto-generates specialized agents with task tracking built-in |\n\n## Install\n\n```bash\nclaude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user\n```\n\nOr add to `~/.claude.json` under the `mcpServers` key:\n\n```json\n{\n  \"mcpServers\": {\n    \"devplan\": {\n      \"type\": \"sse\",\n      \"url\": \"https://mcp.devplanmcp.store/sse\"\n    }\n  }\n}\n```\n\n### Update Existing Installation\n\nIf you already have DevPlan installed, remove from both scopes and re-add:\n\n```bash\nclaude mcp remove devplan --scope project; claude mcp remove devplan --scope user; claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user\n```\n\n## Quick Start\n\n```\nYou: \"Use devplan_start to help me build a CLI tool for managing dotfiles\"\n```\n\nThat's it. DevPlan will guide Claude through the entire process.\n\n## The DevPlan Workflow\n\nDevPlan uses a **scaffold → enhance → validate** workflow that ensures every plan is Haiku-executable before implementation begins.\n\n```mermaid\nflowchart LR\n    subgraph Planning[\"📋 Planning\"]\n        A[Interview] --\u003e B[Brief]\n        B --\u003e C[Generate Scaffold]\n    end\n\n    subgraph Enhancement[\"✨ Enhancement\"]\n        C --\u003e D[Enhance with Code]\n        D --\u003e E{Validate}\n        E --\u003e|Fail| D\n        E --\u003e|Pass| F[Ready]\n    end\n\n    subgraph Execution[\"⚡ Execution\"]\n        F --\u003e G[Haiku Executes]\n        G --\u003e H[Sonnet Verifies]\n    end\n\n    subgraph Learning[\"🧠 Learning\"]\n        H --\u003e|issues| I[Capture Lessons]\n        I --\u003e|improve| C\n    end\n\n    style E fill:#fff3e0,stroke:#f57c00\n    style F fill:#c8e6c9,stroke:#2e7d32\n    style I fill:#e3f2fd,stroke:#1565c0\n```\n\n### How It Works\n\n1. **Interview** → DevPlan asks questions to understand your project\n2. **Brief** → Creates a structured PROJECT_BRIEF.md with requirements\n3. **Generate Scaffold** → `devplan_generate_plan` creates a starting template\n4. **Enhance with Code** → Claude (Opus/Sonnet) fills in complete, copy-pasteable code\n5. **Validate** → `devplan_validate_plan` checks the plan is Haiku-executable\n6. **Execute** → Haiku implements each subtask mechanically\n7. **Verify** → Sonnet tries to break the implementation\n8. **Learn** → Issues become lessons for future projects\n\n### Validation Ensures Quality\n\nThe validation step checks that plans are truly Haiku-executable:\n\n- ✅ Complete code blocks (not pseudocode or placeholders)\n- ✅ All imports included in code blocks\n- ✅ No \"add to existing\" instructions\n- ✅ No cross-subtask references\n- ✅ Verification commands with expected outputs\n\n```\n# Example validation output\n{\n  \"valid\": true,\n  \"errors\": [],\n  \"warnings\": [],\n  \"stats\": {\n    \"subtasks\": 5,\n    \"codeBlocksChecked\": 8,\n    \"issuesFound\": 0\n  }\n}\n```\n\n### Real-Time Progress with Task Tools\n\nGenerated executor and verifier agents integrate with Claude Code's Task tools for live progress visibility:\n\n- **Executor agents** create tasks for each subtask, showing real-time spinners as work progresses\n- **Verifier agents** create tasks for each verification phase (Smoke Tests, Feature Verification, Edge Cases, etc.)\n- Progress is visible without scrolling — you always know what Claude is working on\n\n```\n# Example: Executor tracks subtasks\nTaskCreate({ subject: \"1.2.3: Implement auth middleware\", activeForm: \"Implementing auth middleware\" })\nTaskUpdate({ taskId: \"...\", status: \"in_progress\" })\n# ... work happens ...\nTaskUpdate({ taskId: \"...\", status: \"completed\" })\n```\n\nBoth Task tools (real-time visibility) and DEVELOPMENT_PLAN.md (durable record) are updated — giving you the best of both worlds.\n\n## Usage Examples\n\n### New Project\n```\n\"Use devplan_start to help me build [your idea]\"\n```\n\n### Fix a GitHub Issue\n```bash\n# Get issue JSON\ngh issue view 123 --json number,title,body,labels,comments,url \u003e issue.json\n\n# Then tell Claude:\n\"Use devplan_issue_to_task with this issue to create a remediation plan\"\n```\n\n### Check Progress\n```\n\"Use devplan_progress_summary to show me where we are\"\n```\n\n## Multi-Model Support\n\nDevPlan generates plans and agent files for multiple AI coding tools and models. Use the `target` parameter to generate outputs for your preferred tool.\n\n### Supported Targets\n\n| Target | Tool | Agent File | Best For |\n|--------|------|-----------|----------|\n| `claude` | Claude Code | `CLAUDE.md` | Claude Code IDE (default) |\n| `cursor` | Cursor IDE | `.cursorrules` | Cursor AI editor |\n| `aider` | Aider CLI | `.aider.conf.yml` | Terminal-based AI pair programming |\n| `cline` | VS Code Cline | `.cline/instructions.md` | VS Code extension |\n| `windsurf` | Windsurf IDE | `.windsurf/rules.md` | Codium's AI IDE |\n| `generic` | Any Model | `AGENTS.md` + files | Model-agnostic markdown format |\n\n### Using Targets\n\nWhen generating plans or agent files, specify the target tool:\n\n**Generate plan for Cursor:**\n```\n\"Use devplan_generate_plan to create a plan, then I'll customize it for Cursor. Set target to 'cursor' for .cursorrules format\"\n```\n\n**Generate executor for Aider:**\n```\n\"Use devplan_generate_executor with target='aider' to create an Aider-compatible executor agent\"\n```\n\n**Generate generic agent files:**\n```\n\"Use devplan_generate_claude_md with target='generic' to create model-agnostic AGENTS.md files\"\n```\n\n### How Targets Work\n\nEach target has a dedicated **adapter** that transforms the DevPlan methodology into the appropriate format:\n\n- **Claude** - Generates `CLAUDE.md` with executor/verifier agents in `.claude/agents/`\n- **Cursor** - Generates `.cursorrules` with all guidance in one file (Cursor doesn't support separate agents)\n- **Aider** - Generates `.aider.conf.yml` with architect mode instructions\n- **Cline** - Generates `.cline/instructions.md` with executor/verifier split\n- **Windsurf** - Generates `.windsurf/rules.md` with cascade-optimized format\n- **Generic** - Generates `AGENTS.md`, `EXECUTOR.md`, and `VERIFIER.md` for any tool\n\n### Examples\n\n**Start a new project for Cursor:**\n```\n\"Use devplan_start to help me build a CLI tool, then generate the plan with target='cursor' for Cursor IDE\"\n```\n\n**Add executor for specific target:**\n```\n\"I have a development plan. Use devplan_generate_executor with target='aider' to create the executor agent for Aider\"\n```\n\n**Compare adapter capabilities:**\nSee [docs/ADAPTERS.md](/docs/ADAPTERS.md) for a detailed comparison of each target's capabilities and limitations.\n\n## Tools\n\n### Planning\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_start` | Main entry point - guides Claude through the methodology |\n| `devplan_interview_questions` | Get questions to gather project requirements |\n| `devplan_create_brief` | Generate PROJECT_BRIEF.md |\n| `devplan_parse_brief` | Parse existing brief into structured data |\n| `devplan_list_templates` | List project templates (cli, web_app, api, library) |\n\n### Generation\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_generate_plan` | Generate DEVELOPMENT_PLAN.md scaffold with validation instructions |\n| `devplan_generate_claude_md` | Generate CLAUDE.md scaffold |\n| `devplan_generate_executor` | Generate Haiku-powered executor agent with Task tool integration |\n| `devplan_generate_verifier` | Generate Sonnet-powered verifier agent with Task tool integration |\n\n### Validation \u0026 Execution\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_validate_plan` | Validate plan structure and Haiku-executability |\n| `devplan_get_subtask` | Get specific subtask details by ID |\n| `devplan_update_progress` | Mark subtasks complete with notes |\n| `devplan_progress_summary` | Get completion stats and next actions |\n\n### Lessons Learned\n\nFeedback loop that captures issues from verification and incorporates them into future plans.\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_add_lesson` | Capture a lesson from verifier findings |\n| `devplan_list_lessons` | List accumulated lessons by severity |\n| `devplan_archive_lesson` | Archive old lessons without deleting them |\n| `devplan_delete_lesson` | Remove outdated or incorrect lessons |\n| `devplan_extract_lessons_from_report` | Auto-extract lessons from verification reports |\n\n### Issue Remediation\n\nConvert GitHub issues into structured remediation tasks — perfect for bug fixes and post-release maintenance.\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_parse_issue` | Analyze a GitHub issue to extract requirements |\n| `devplan_issue_to_task` | Generate remediation task with subtasks from an issue |\n\n### Analytics\n\n| Tool | Purpose |\n|------|---------|\n| `devplan_usage_stats` | View usage distribution across users |\n\n## Why DevPlan?\n\n| Without DevPlan | With DevPlan |\n|-----------------|--------------|\n| Context lost between sessions | Plans preserve full context |\n| Inconsistent code quality | Haiku follows exact specifications |\n| Same mistakes repeated | Lessons learned system prevents recurrence |\n| No verification step | Sonnet actively tries to break the code |\n| Bugs found in production | Issues caught before release |\n| Plans need interpretation | Validated plans are copy-paste ready |\n\n## Dashboard \u0026 Analytics\n\nDevPlan includes a public dashboard for viewing aggregate usage statistics:\n\n**Dashboard URL**: [devplanmcp.store/dashboard](https://devplanmcp.store/dashboard)\n\nThe dashboard shows:\n- **Summary cards**: Total sessions, total tool calls, countries reached\n- **Line chart**: Sessions and tool calls over the last 30 days\n- **Country table**: Top 10 countries by session count\n\n### Privacy\n\nAll analytics are privacy-preserving:\n- **No IP storage**: Only Cloudflare-derived country/region codes\n- **No user identification**: Sessions are anonymous\n- **Auto-expiration**: Daily stats expire after 90 days via KV TTL\n\n## Development\n\n```bash\nnpm install\nnpm run dev      # Local development\nnpm run deploy   # Deploy to Cloudflare Workers\n```\n\n## Contributing\n\nContributions welcome! Please see the [ClaudeCode-DevPlanBuilder](https://github.com/mmorris35/ClaudeCode-DevPlanBuilder) repo for methodology details.\n\n## License\n\nMIT\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eBuilt for Claude Code\u003c/b\u003e\u003cbr\u003e\n  \u003ca href=\"https://modelcontextprotocol.io\"\u003eModel Context Protocol\u003c/a\u003e •\n  \u003ca href=\"https://workers.cloudflare.com/\"\u003eCloudflare Workers\u003c/a\u003e •\n  \u003ca href=\"https://github.com/mmorris35/ClaudeCode-DevPlanBuilder\"\u003eDevPlanBuilder Methodology\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmorris35%2Fdevplan-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmorris35%2Fdevplan-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmorris35%2Fdevplan-mcp-server/lists"}