Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/taoidle--plan-cascade/badge.svg)](/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

i

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)

  1. {
  2. "name": "plan-cascade",
  3. "owner": {
  4. "name": "Taoidle",
  5. "url": "https://github.com/Taoidle"
  6. },
  7. "plugins": [
  8. {
  9. "name": "plan-cascade",
  10. "source": "./",
  11. "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.).",
  12. "version": "4.0.1"
  13. }
  14. ]
  15. }
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)

  1. <div align="center">
  2. # Plan Cascade
  3. **AI-Powered Cascading Development Framework**
  4. *Transform complex projects into parallel executable tasks with intelligent decomposition and multi-provider execution*
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. | Component | Version | Status | Description |
  7. |-----------|---------|--------|-------------|
  8. | **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 |
  9. | **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 |
  10. | **CLI** | ![Dev](https://img.shields.io/badge/status-dev-yellow) | ![Dev](https://img.shields.io/badge/status-dev-yellow) | Command-line interface |
  11. | **MCP Server** | ![Stable](https://img.shields.io/badge/status-stable-brightgreen) | ![Stable](https://img.shields.io/badge/status-stable-brightgreen) | Model Context Protocol |
  12. [Why Plan Cascade?](#why-plan-cascade) • [Product Editions](#product-editions) • [Quick Start](#quick-start) • [Architecture](#architecture)
  13. </div>
  14. ---
  15. ## Why Plan Cascade?
  16. Traditional AI coding assistants hit a wall with large, complex projects:
  17. | Challenge | Conventional AI | Plan Cascade |
  18. |-----------|-----------------|--------------|
  19. | **Complexity** | Gets lost in large codebases | Decomposes into manageable units |
  20. | **Parallelism** | Sequential, one-at-a-time | Independent tasks run in parallel |
  21. | **Context** | Lost during long sessions | Design docs + durable context survive compaction |
  22. | **Quality** | Manual verification needed | Automated testing & linting at each step |
  23. | **Control** | Black box execution | Transparent, inspectable workflow |
  24. ### The Solution: Cascading Decomposition
  25. ```
  26. ┌─────────────────────────────────────────────────────────────────────┐
  27. │ Your Project Goal │
  28. │ "Build a REST API with authentication" │
  29. └─────────────────────────────────────────────────────────────────────┘
  30. │
  31. ▼
  32. ┌─────────────────────────────────────────────────────────────────────┐
  33. │ Level 1: Mega Plan │
  34. │ ───────────────────── │
  35. │ Project-level orchestration → Manages multiple features in batches │
  36. │ Output: mega-plan.json + design_doc.json │
  37. └─────────────────────────────────────────────────────────────────────┘
  38. │
  39. ┌───────────────────┼───────────────────┐
  40. ▼ ▼ ▼
  41. ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
  42. │ Feature: Auth │ │ Feature: API │ │ Feature: Database │
  43. │ ─────────────── │ │ ─────────────── │ │ ─────────────── │
  44. │ PRD + Design Doc │ │ PRD + Design Doc │ │ PRD + Design Doc │
  45. └─────────────────────┘ └─────────────────────┘ └─────────────────────┘
  46. │ │ │
  47. ▼ ▼ ▼
  48. ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
  49. │ Stories (Parallel) │ │ Stories (Parallel) │ │ Stories (Parallel) │
  50. │ ───────────────── │ │ ───────────────── │ │ ───────────────── │
  51. │ □ JWT Implementation│ │ □ CRUD Endpoints │ │ □ Schema Design │
  52. │ □ Password Hashing │ │ □ Rate Limiting │ │ □ Migrations │
  53. │ □ Session Management│ │ □ Input Validation │ │ □ Connection Pool │
  54. └─────────────────────┘ └─────────────────────┘ └─────────────────────┘
  55. │
  56. ▼
  57. ┌─────────────────┐
  58. │ Quality Gates │
  59. │ ───────────── │
  60. │ ✓ DoR / DoD │
  61. │ ✓ Test Coverage │
  62. │ ✓ Lint / Format │
  63. └─────────────────┘
  64. ```
  65. ---
  66. ## Product Editions
  67. Plan Cascade is available in three editions to suit different workflows:
  68. | Feature | Plugin | Desktop | CLI |
  69. |---------|--------|---------|-----|
  70. | **Target User** | Claude Code users | Multi-model teams | Automation/CI |
  71. | **LLM Backend** | Claude Code only | 7+ providers (Claude, OpenAI, DeepSeek, Ollama...) | 7+ providers |
  72. | **Offline Use** | ❌ | ✅ (Ollama) | ✅ (Ollama) |
  73. | **Installation** | `claude plugins install` | Desktop app / `pip install` | `pip install` |
  74. | **UI** | Slash commands | Full GUI with 4 workflow modes | Command-line |
  75. | **Quality Gates** | ✅ Standard | ✅ Enterprise-grade with auto-retry | ✅ |
  76. | **Security Model** | Basic | 5-layer (Guardrail → Gate → Policy → Sandbox → Audit) | Basic |
  77. | **Worktree Integration** | ✅ | ✅ Visual diff viewer | ✅ |
  78. | **Visual Workflow** | ❌ | ✅ Real-time timeline + checkpoints | ❌ |
  79. | **MCP Stack** | Client only | Full stack (Manager + Client + Server) | Client only |
  80. | **Knowledge System** | ❌ | ✅ Skills + Memory + RAG | ❌ |
  81. | **Remote Control** | ❌ | ✅ A2A protocol + Telegram bot | ❌ |
  82. | **Maturity** | Stable | Alpha | Development |
  83. ### Which Edition Should I Choose?
  84. - **Choose Plugin** if you're a Claude Code power user who wants seamless integration
  85. - **Choose Desktop** if you need multi-model support, visual workflows, or offline capability
  86. - **Choose CLI** if you're building automation pipelines or CI/CD integration
  87. ---
  88. ## Core Capabilities
  89. ### Unified Workflow Kernel
  90. All modes share a common foundation:
  91. - **Unified lifecycle** — Consistent state management across modes
  92. - **Event streaming** — Real-time progress updates via typed events
  93. - **Mode handoff** — Seamless switching between Chat → Plan → Task
  94. - **Checkpointing** — Recovery from interruptions
  95. ### Quality Gates Pipeline
  96. Every Story passes through validation:
  97. ```
  98. ┌─────────┐ ┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐
  99. │ DoR │ → │ Code │ → │ DoD │ → │ AI Verify │ → │ Review │
  100. │ (Ready) │ │ (Write) │ │ (Done) │ │ (No Stubs) │ │ (Score) │
  101. └─────────┘ └─────────┘ └─────────────┘ └─────────────┘ └─────────┘
  102. │ │ │ │ │
  103. ▼ ▼ ▼ ▼ ▼
  104. Validate Implement Verify all Detect stub Code quality
  105. requirements solution criteria code & TODOs scoring
  106. ```
  107. ### Design Document Hierarchy
  108. Two-level architecture ensures consistency:
  109. - **Project-level** — Global patterns, shared decisions (ADR-001, ADR-002...)
  110. - **Feature-level** — Component-specific decisions (ADR-F001, ADR-F002...)
  111. ### External Framework Skills
  112. Auto-injected best practices from Git submodules:
  113. - React/Next.js — detected via `package.json`
  114. - Vue/Nuxt — detected via `package.json`
  115. - Rust — detected via `Cargo.toml`
  116. ---
  117. ## Architecture
  118. ```
  119. ┌────────────────────────────────────────────────────────────────────────────┐
  120. │ Plan Cascade Core │
  121. ├────────────────────────────────────────────────────────────────────────────┤
  122. │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
  123. │ │ Strategy │ │ PRD │ │ Parallel │ │ Quality │ │
  124. │ │ Selector │ │ Generator │ │ Executor │ │ Gates │ │
  125. │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
  126. ├────────────────────────────────────────────────────────────────────────────┤
  127. │ Agent Backend Layer │
  128. │ ┌────────────────────────────┐ ┌────────────────────────────┐ │
  129. │ │ ClaudeCodeBackend │ │ BuiltinBackend │ │
  130. │ │ (subprocess, no API) │ │ (direct API, ReAct loop) │ │
  131. │ └────────────────────────────┘ └────────────────────────────┘ │
  132. ├────────────────────────────────────────────────────────────────────────────┤
  133. │ LLM Provider Layer │
  134. │ Anthropic │ OpenAI │ DeepSeek │ Ollama │ GLM │ Qwen │ MiniMax │
  135. └────────────────────────────────────────────────────────────────────────────┘
  136. ```
  137. ---
  138. ## Quick Start
  139. ### Plugin (Stable)
  140. ```bash
  141. # Install in Claude Code
  142. claude plugins install plan-cascade
  143. # Use slash commands
  144. /plan-cascade:auto "Implement user authentication"
  145. ```
  146. ### CLI (Development)
  147. ```bash
  148. # Requires Python 3.10+ and uv
  149. git clone https://github.com/Taoidle/plan-cascade.git
  150. cd plan-cascade
  151. uv run pytest tests/ # Run tests
  152. # CLI entry point
  153. uv run plan-cascade --help
  154. ```
  155. ### Desktop (Alpha)
  156. See [desktop/README.md](./desktop/README.md) for the full-featured desktop application.
  157. ---
  158. ## Documentation
  159. | Document | Description |
  160. |----------|-------------|
  161. | [Plugin Guide](./docs/Plugin-Guide.md) | Claude Code plugin usage |
  162. | [CLI Guide](./docs/CLI-Guide.md) | Command-line interface |
  163. | [Mega Plan Guide](./docs/Mega-Plan-Guide.md) | Multi-feature orchestration |
  164. | [Desktop README](./desktop/README.md) | Desktop application |
  165. | [PRD Template](./docs/prd-template.json) | PRD file format |
  166. ---
  167. ## Project Structure
  168. ```
  169. plan-cascade/
  170. ├── src/plan_cascade/ # Core Python library
  171. │ ├── core/ # Orchestration engines
  172. │ ├── backends/ # Agent abstraction layer
  173. │ ├── state/ # Thread-safe state management
  174. │ ├── llm/ # LLM provider abstraction
  175. │ └── tools/ # ReAct tool implementations
  176. ├── desktop/ # Tauri desktop application
  177. │ ├── src/ # React frontend
  178. │ └── src-tauri/ # Rust backend
  179. ├── skills/ # Plugin skills
  180. │ ├── hybrid-ralph/ # PRD-driven execution
  181. │ ├── mega-plan/ # Multi-feature orchestration
  182. │ └── planning-with-files/ # File-based planning
  183. ├── commands/ # Slash command definitions
  184. └── mcp_server/ # FastMCP server
  185. ```
  186. ---
  187. ## Roadmap
  188. | Component | Current | Next Milestone |
  189. |-----------|---------|----------------|
  190. | **Plugin** | 4.4.0 Stable | 5.0.0 - Enhanced CLI integration |
  191. | **Desktop** | 0.1.0 Alpha | 0.2.0 - Beta with full workflow |
  192. | **CLI** | Development | 1.0.0 - Stable release |
  193. | **MCP Server** | Stable | Enhanced tool support |
  194. ---
  195. ## Contributing
  196. We welcome contributions! Please see our contributing guidelines for details.
  197. ---
  198. ## License
  199. MIT License - see [LICENSE](../LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.