Plan Cascade
AI-Powered Cascading Development Framework
Transform complex projects into parallel executable tasks with intelligent decomposition and multi-provider execution
Why Plan Cascade? • Product Editions • Quick Start • Architecture
Why Plan Cascade?
Traditional AI coding assistants hit a wall with large, complex projects:
The Solution: Cascading Decomposition
┌─────────────────────────────────────────────────────────────────────┐
│ Your Project Goal │
│ "Build a REST API with authentication" │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ Level 1: Mega Plan │
│ ───────────────────── │
│ Project-level orchestration → Manages multiple features in batches │
│ Output: mega-plan.json + design_doc.json │
└─────────────────────────────────────────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ Feature: Auth │ │ Feature: API │ │ Feature: Database │
│ ─────────────── │ │ ─────────────── │ │ ─────────────── │
│ PRD + Design Doc │ │ PRD + Design Doc │ │ PRD + Design Doc │
└─────────────────────┘ └─────────────────────┘ └─────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ Stories (Parallel) │ │ Stories (Parallel) │ │ Stories (Parallel) │
│ ───────────────── │ │ ───────────────── │ │ ───────────────── │
│ □ JWT Implementation│ │ □ CRUD Endpoints │ │ □ Schema Design │
│ □ Password Hashing │ │ □ Rate Limiting │ │ □ Migrations │
│ □ Session Management│ │ □ Input Validation │ │ □ Connection Pool │
└─────────────────────┘ └─────────────────────┘ └─────────────────────┘
│
▼
┌─────────────────┐
│ Quality Gates │
│ ───────────── │
│ ✓ DoR / DoD │
│ ✓ Test Coverage │
│ ✓ Lint / Format │
└─────────────────┘
Product Editions
Plan Cascade is available in three editions to suit different workflows:
Which Edition Should I Choose?
- Choose Plugin if you're a Claude Code power user who wants seamless integration
- Choose Desktop if you need multi-model support, visual workflows, or offline capability
- Choose CLI if you're building automation pipelines or CI/CD integration
Core Capabilities
Unified Workflow Kernel
All modes share a common foundation:
- Unified lifecycle — Consistent state management across modes
- Event streaming — Real-time progress updates via typed events
- Mode handoff — Seamless switching between Chat → Plan → Task
- Checkpointing — Recovery from interruptions
Quality Gates Pipeline
Every Story passes through validation:
┌─────────┐ ┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐
│ DoR │ → │ Code │ → │ DoD │ → │ AI Verify │ → │ Review │
│ (Ready) │ │ (Write) │ │ (Done) │ │ (No Stubs) │ │ (Score) │
└─────────┘ └─────────┘ └─────────────┘ └─────────────┘ └─────────┘
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
Validate Implement Verify all Detect stub Code quality
requirements solution criteria code & TODOs scoring
Design Document Hierarchy
Two-level architecture ensures consistency:
- Project-level — Global patterns, shared decisions (ADR-001, ADR-002...)
- Feature-level — Component-specific decisions (ADR-F001, ADR-F002...)
External Framework Skills
Auto-injected best practices from Git submodules:
- React/Next.js — detected via
package.json - Vue/Nuxt — detected via
package.json - Rust — detected via
Cargo.toml
Architecture
┌────────────────────────────────────────────────────────────────────────────┐
│ Plan Cascade Core │
├────────────────────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Strategy │ │ PRD │ │ Parallel │ │ Quality │ │
│ │ Selector │ │ Generator │ │ Executor │ │ Gates │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
├────────────────────────────────────────────────────────────────────────────┤
│ Agent Backend Layer │
│ ┌────────────────────────────┐ ┌────────────────────────────┐ │
│ │ ClaudeCodeBackend │ │ BuiltinBackend │ │
│ │ (subprocess, no API) │ │ (direct API, ReAct loop) │ │
│ └────────────────────────────┘ └────────────────────────────┘ │
├────────────────────────────────────────────────────────────────────────────┤
│ LLM Provider Layer │
│ Anthropic │ OpenAI │ DeepSeek │ Ollama │ GLM │ Qwen │ MiniMax │
└────────────────────────────────────────────────────────────────────────────┘
Quick Start
Plugin (Stable)
# Install in Claude Code
claude plugins install plan-cascade
# Use slash commands
/plan-cascade:auto "Implement user authentication"
CLI (Development)
# Requires Python 3.10+ and uv
git clone https://github.com/Taoidle/plan-cascade.git
cd plan-cascade
uv run pytest tests/ # Run tests
# CLI entry point
uv run plan-cascade --help
Desktop (Alpha)
See desktop/README.md for the full-featured desktop application.
Documentation
Project Structure
plan-cascade/
├── src/plan_cascade/ # Core Python library
│ ├── core/ # Orchestration engines
│ ├── backends/ # Agent abstraction layer
│ ├── state/ # Thread-safe state management
│ ├── llm/ # LLM provider abstraction
│ └── tools/ # ReAct tool implementations
├── desktop/ # Tauri desktop application
│ ├── src/ # React frontend
│ └── src-tauri/ # Rust backend
├── skills/ # Plugin skills
│ ├── hybrid-ralph/ # PRD-driven execution
│ ├── mega-plan/ # Multi-feature orchestration
│ └── planning-with-files/ # File-based planning
├── commands/ # Slash command definitions
└── mcp_server/ # FastMCP server
Roadmap
Contributing
We welcome contributions! Please see our contributing guidelines for details.
License
MIT License - see LICENSE for details.
