plan-cascade
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).
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Taoidle/plan-cascade with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Taoidle/plan-cascade'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/taoidle--plan-cascade)HTML
<a href="/listings/taoidle--plan-cascade"><img src="/api/listings/taoidle--plan-cascade/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](./desktop/README.md) for the full-featured desktop application.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "plan-cascade",
- "owner": {
- "name": "Taoidle",
- "url": "https://github.com/Taoidle"
- },
- "plugins": [
- {
- "name": "plan-cascade",
- "source": "./",
- "description": "Three-layer cascaded parallel development framework with multi-agent collaboration. Breaks down projects into Features (Mega Plan), Features into Stories (Hybrid Ralph), with dependency-driven batch execution, Git Worktree isolation, and support for multiple AI agents (Codex, Amp, Aider, etc.).",
- "version": "4.0.1"
- }
- ]
- }
README.md · README · 260 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # Plan Cascade
- **AI-Powered Cascading Development Framework**
- *Transform complex projects into parallel executable tasks with intelligent decomposition and multi-provider execution*
- [](https://opensource.org/licenses/MIT)
- | Component | Version | Status | Description |
- |-----------|---------|--------|-------------|
- | **Plugin** | [](https://github.com/Taoidle/plan-cascade) |  | Claude Code integration |
- | **Desktop** | [](./desktop) |  | Local-first AI workstation |
- | **CLI** |  |  | Command-line interface |
- | **MCP Server** |  |  | Model Context Protocol |
- [Why Plan Cascade?](#why-plan-cascade) • [Product Editions](#product-editions) • [Quick Start](#quick-start) • [Architecture](#architecture)
- </div>
- ---
- ## Why Plan Cascade?
- Traditional AI coding assistants hit a wall with large, complex projects:
- | Challenge | Conventional AI | Plan Cascade |
- |-----------|-----------------|--------------|
- | **Complexity** | Gets lost in large codebases | Decomposes into manageable units |
- | **Parallelism** | Sequential, one-at-a-time | Independent tasks run in parallel |
- | **Context** | Lost during long sessions | Design docs + durable context survive compaction |
- | **Quality** | Manual verification needed | Automated testing & linting at each step |
- | **Control** | Black box execution | Transparent, inspectable workflow |
- ### 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:
- | Feature | Plugin | Desktop | CLI |
- |---------|--------|---------|-----|
- | **Target User** | Claude Code users | Multi-model teams | Automation/CI |
- | **LLM Backend** | Claude Code only | 7+ providers (Claude, OpenAI, DeepSeek, Ollama...) | 7+ providers |
- | **Offline Use** | ❌ | ✅ (Ollama) | ✅ (Ollama) |
- | **Installation** | `claude plugins install` | Desktop app / `pip install` | `pip install` |
- | **UI** | Slash commands | Full GUI with 4 workflow modes | Command-line |
- | **Quality Gates** | ✅ Standard | ✅ Enterprise-grade with auto-retry | ✅ |
- | **Security Model** | Basic | 5-layer (Guardrail → Gate → Policy → Sandbox → Audit) | Basic |
- | **Worktree Integration** | ✅ | ✅ Visual diff viewer | ✅ |
- | **Visual Workflow** | ❌ | ✅ Real-time timeline + checkpoints | ❌ |
- | **MCP Stack** | Client only | Full stack (Manager + Client + Server) | Client only |
- | **Knowledge System** | ❌ | ✅ Skills + Memory + RAG | ❌ |
- | **Remote Control** | ❌ | ✅ A2A protocol + Telegram bot | ❌ |
- | **Maturity** | Stable | Alpha | Development |
- ### 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)
- ```bash
- # Install in Claude Code
- claude plugins install plan-cascade
- # Use slash commands
- /plan-cascade:auto "Implement user authentication"
- ```
- ### CLI (Development)
- ```bash
- # 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](./desktop/README.md) for the full-featured desktop application.
- ---
- ## Documentation
- | Document | Description |
- |----------|-------------|
- | [Plugin Guide](./docs/Plugin-Guide.md) | Claude Code plugin usage |
- | [CLI Guide](./docs/CLI-Guide.md) | Command-line interface |
- | [Mega Plan Guide](./docs/Mega-Plan-Guide.md) | Multi-feature orchestration |
- | [Desktop README](./desktop/README.md) | Desktop application |
- | [PRD Template](./docs/prd-template.json) | PRD file format |
- ---
- ## 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
- | Component | Current | Next Milestone |
- |-----------|---------|----------------|
- | **Plugin** | 4.4.0 Stable | 5.0.0 - Enhanced CLI integration |
- | **Desktop** | 0.1.0 Alpha | 0.2.0 - Beta with full workflow |
- | **CLI** | Development | 1.0.0 - Stable release |
- | **MCP Server** | Stable | Enhanced tool support |
- ---
- ## Contributing
- We welcome contributions! Please see our contributing guidelines for details.
- ---
- ## License
- MIT License - see [LICENSE](../LICENSE) for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.