{"id":"e4e8f41c-1bc3-42f7-a0b5-fe48561979c5","slug":"plan-cascade","kind":"mcp","name":"plan-cascade","summary":"AI-powered cascading development framework. Decompose complex projects into parallel executable tasks with auto-generated PRDs, design docs, and multi-agent collaboration (Claude Code, Codex, Aider).","owner":"Taoidle","repoUrl":"https://github.com/Taoidle/plan-cascade","license":"MIT","licenseTier":"permissive","trust":"community","stars":133,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-01-23T07:30:20.000Z","addedAt":"2026-10-14T03:44:09.075Z","logoUrl":"https://avatars.githubusercontent.com/u/17265053?u=5e51bee484a072630b2888c4fd3e5e079fcb8b95&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","productivity","cloud-infra"],"tags":["claude-code","claude-code-plugin","developer-tools","llm-agents","multi-agent","task-orchestration","workflow-automation"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T04:12:23.767Z","sample":false,"url":"https://conduits.dev/tools/plan-cascade","language":"Rust","transports":["stdio"],"install":{"pypi":"plan-cascade"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<div align=\"center\">\n\n# Plan Cascade\n\n**AI-Powered Cascading Development Framework**\n\n*Transform complex projects into parallel executable tasks with intelligent decomposition and multi-provider execution*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n| Component | Version | Status | Description |\n|-----------|---------|--------|-------------|\n| **Plugin** | [![4.4.0](https://img.shields.io/badge/version-4.4.0-brightgreen)](https://github.com/Taoidle/plan-cascade) | ![Stable](https://img.shields.io/badge/status-stable-brightgreen) | Claude Code integration |\n| **Desktop** | [![0.1.0](https://img.shields.io/badge/version-0.1.0-blue)](./desktop) | ![Alpha](https://img.shields.io/badge/status-alpha-orange) | Local-first AI workstation |\n| **CLI** | ![Dev](https://img.shields.io/badge/status-dev-yellow) | ![Dev](https://img.shields.io/badge/status-dev-yellow) | Command-line interface |\n| **MCP Server** | ![Stable](https://img.shields.io/badge/status-stable-brightgreen) | ![Stable](https://img.shields.io/badge/status-stable-brightgreen) | Model Context Protocol |\n\n[Why Plan Cascade?](#why-plan-cascade) • [Product Editions](#product-editions) • [Quick Start](#quick-start) • [Architecture](#architecture)\n\n</div>\n\n---\n\n## Why Plan Cascade?\n\nTraditional AI coding assistants hit a wall with large, complex projects:\n\n| Challenge | Conventional AI | Plan Cascade |\n|-----------|-----------------|--------------|\n| **Complexity** | Gets lost in large codebases | Decomposes into manageable units |\n| **Parallelism** | Sequential, one-at-a-time | Independent tasks run in parallel |\n| **Context** | Lost during long sessions | Design docs + durable context survive compaction |\n| **Quality** | Manual verification needed | Automated testing & linting at each step |\n| **Control** | Black box execution | Transparent, inspectable workflow |\n\n### The Solution: Cascading Decomposition\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                        Your Project Goal                            │\n│            \"Build a REST API with authentication\"                   │\n└─────────────────────────────────────────────────────────────────────┘\n                                  │\n                                  ▼\n┌─────────────────────────────────────────────────────────────────────┐\n│  Level 1: Mega Plan                                                 │\n│  ─────────────────────                                              │\n│  Project-level orchestration → Manages multiple features in batches │\n│  Output: mega-plan.json + design_doc.json                          │\n└─────────────────────────────────────────────────────────────────────┘\n                                  │\n              ┌───────────────────┼───────────────────┐\n              ▼                   ▼                   ▼\n┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐\n│ Feature: Auth       │ │ Feature: API        │ │ Feature: Database   │\n│ ───────────────     │ │ ───────────────     │ │ ───────────────     │\n│ PRD + Design Doc    │ │ PRD + Design Doc    │ │ PRD + Design Doc    │\n└─────────────────────┘ └─────────────────────┘ └─────────────────────┘\n              │                   │                   │\n              ▼                   ▼                   ▼\n┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐\n│ Stories (Parallel)  │ │ Stories (Parallel)  │ │ Stories (Parallel)  │\n│ ─────────────────   │ │ ─────────────────   │ │ ─────────────────   │\n│ □ JWT Implementation│ │ □ CRUD Endpoints    │ │ □ Schema Design     │\n│ □ Password Hashing  │ │ □ Rate Limiting     │ │ □ Migrations        │\n│ □ Session Management│ │ □ Input Validation  │ │ □ Connection Pool   │\n└─────────────────────┘ └─────────────────────┘ └─────────────────────┘\n                                  │\n                                  ▼\n                        ┌─────────────────┐\n                        │ Quality Gates   │\n                        │ ─────────────   │\n                        │ ✓ DoR / DoD     │\n                        │ ✓ Test Coverage │\n                        │ ✓ Lint / Format │\n                        └─────────────────┘\n```\n\n---\n\n## Product Editions\n\nPlan Cascade is available in three editions to suit different workflows:\n\n| Feature | Plugin | Desktop | CLI |\n|---------|--------|---------|-----|\n| **Target User** | Claude Code users | Multi-model teams | Automation/CI |\n| **LLM Backend** | Claude Code only | 7+ providers (Claude, OpenAI, DeepSeek, Ollama...) | 7+ providers |\n| **Offline Use** | ❌ | ✅ (Ollama) | ✅ (Ollama) |\n| **Installation** | `claude plugins install` | Desktop app / `pip install` | `pip install` |\n| **UI** | Slash commands | Full GUI with 4 workflow modes | Command-line |\n| **Quality Gates** | ✅ Standard | ✅ Enterprise-grade with auto-retry | ✅ |\n| **Security Model** | Basic | 5-layer (Guardrail → Gate → Policy → Sandbox → Audit) | Basic |\n| **Worktree Integration** | ✅ | ✅ Visual diff viewer | ✅ |\n| **Visual Workflow** | ❌ | ✅ Real-time timeline + checkpoints | ❌ |\n| **MCP Stack** | Client only | Full stack (Manager + Client + Server) | Client only |\n| **Knowledge System** | ❌ | ✅ Skills + Memory + RAG | ❌ |\n| **Remote Control** | ❌ | ✅ A2A protocol + Telegram bot | ❌ |\n| **Maturity** | Stable | Alpha | Development |\n\n### Which Edition Should I Choose?\n\n- **Choose Plugin** if you're a Claude Code power user who wants seamless integration\n- **Choose Desktop** if you need multi-model support, visual workflows, or offline capability\n- **Choose CLI** if you're building automation pipelines or CI/CD integration\n\n---\n\n## Core Capabilities\n\n### Unified Workflow Kernel\n\nAll modes share a common foundation:\n\n- **Unified lifecycle** — Consistent state management across modes\n- **Event streaming** — Real-time progress updates via typed events\n- **Mode handoff** — Seamless switching between Chat → Plan → Task\n- **Checkpointing** — Recovery from interruptions\n\n### Quality Gates Pipeline\n\nEvery Story passes through validation:\n\n```\n┌─────────┐   ┌─────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────┐\n│   DoR   │ → │  Code   │ → │     DoD     │ → │ AI Verify   │ → │ Review  │\n│ (Ready) │   │ (Write) │   │   (Done)    │   │ (No Stubs)  │   │ (Score) │\n└─────────┘   └─────────┘   └─────────────┘   └─────────────┘   └─────────┘\n     │             │               │                 │               │\n     ▼             ▼               ▼                 ▼               ▼\n  Validate      Implement      Verify all        Detect stub     Code quality\n  requirements   solution       criteria          code & TODOs      scoring\n```\n\n### Design Document Hierarchy\n\nTwo-level architecture ensures consistency:\n\n- **Project-level** — Global patterns, shared decisions (ADR-001, ADR-002...)\n- **Feature-level** — Component-specific decisions (ADR-F001, ADR-F002...)\n\n### External Framework Skills\n\nAuto-injected best practices from Git submodules:\n\n- React/Next.js — detected via `package.json`\n- Vue/Nuxt — detected via `package.json`\n- Rust — detected via `Cargo.toml`\n\n---\n\n## Architecture\n\n```\n┌────────────────────────────────────────────────────────────────────────────┐\n│                            Plan Cascade Core                               │\n├────────────────────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐      │\n│  │  Strategy   │  │    PRD      │  │  Parallel   │  │   Quality   │      │\n│  │  Selector   │  │  Generator  │  │  Executor   │  │    Gates    │      │\n│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘      │\n├────────────────────────────────────────────────────────────────────────────┤\n│                         Agent Backend Layer                                 │\n│  ┌────────────────────────────┐  ┌────────────────────────────┐           │\n│  │   ClaudeCodeBackend        │  │     BuiltinBackend         │           │\n│  │   (subprocess, no API)     │  │   (direct API, ReAct loop) │           │\n│  └────────────────────────────┘  └────────────────────────────┘           │\n├────────────────────────────────────────────────────────────────────────────┤\n│                           LLM Provider Layer                                │\n│    Anthropic │ OpenAI │ DeepSeek │ Ollama │ GLM │ Qwen │ MiniMax          │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Quick Start\n\n### Plugin (Stable)\n\n```bash\n# Install in Claude Code\nclaude plugins install plan-cascade\n\n# Use slash commands\n/plan-cascade:auto \"Implement user authentication\"\n```\n\n### CLI (Development)\n\n```bash\n# Requires Python 3.10+ and uv\ngit clone https://github.com/Taoidle/plan-cascade.git\ncd plan-cascade\nuv run pytest tests/  # Run tests\n\n# CLI entry point\nuv run plan-cascade --help\n```\n\n### Desktop (Alpha)\n\nSee [desktop/README.md](./desktop/README.md) for the full-featured desktop application.\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Plugin Guide](./docs/Plugin-Guide.md) | Claude Code plugin usage |\n| [CLI Guide](./docs/CLI-Guide.md) | Command-line interface |\n| [Mega Plan Guide](./docs/Mega-Plan-Guide.md) | Multi-feature orchestration |\n| [Desktop README](./desktop/README.md) | Desktop application |\n| [PRD Template](./docs/prd-template.json) | PRD file format |\n\n---\n\n## Project Structure\n\n```\nplan-cascade/\n├── src/plan_cascade/          # Core Python library\n│   ├── core/                  # Orchestration engines\n│   ├── backends/              # Agent abstraction layer\n│   ├── state/                 # Thread-safe state management\n│   ├── llm/                   # LLM provider abstraction\n│   └── tools/                 # ReAct tool implementations\n├── desktop/                   # Tauri desktop application\n│   ├── src/                   # React frontend\n│   └── src-tauri/             # Rust backend\n├── skills/                    # Plugin skills\n│   ├── hybrid-ralph/          # PRD-driven execution\n│   ├── mega-plan/             # Multi-feature orchestration\n│   └── planning-with-files/   # File-based planning\n├── commands/                  # Slash command definitions\n└── mcp_server/               # FastMCP server\n```\n\n---\n\n## Roadmap\n\n| Component | Current | Next Milestone |\n|-----------|---------|----------------|\n| **Plugin** | 4.4.0 Stable | 5.0.0 - Enhanced CLI integration |\n| **Desktop** | 0.1.0 Alpha | 0.2.0 - Beta with full workflow |\n| **CLI** | Development | 1.0.0 - Stable release |\n| **MCP Server** | Stable | Enhanced tool support |\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see our contributing guidelines for details.\n\n---\n\n## License\n\nMIT License - see [LICENSE](../LICENSE) for details.\n"}