Cascade Platform Documentation
Application-as-Data Platform
Define entire business systems as structured YAML. Because applications are data (not code), LLMs understand them, visual tools render them, and Git versions them meaningfully.
Built on Temporal • LLM-Native • Autonomous Agents • Production-Ready
What is Application-as-Data?
Core Insight: When your application is structured data instead of imperative code, it becomes machine-readable, AI-manipulable, and visually renderable.
Traditional development requires imperative code. Machines can’t understand intent, AI tools can’t safely modify it, and Git diffs show syntax changes rather than business logic.
Cascade takes a different approach. Applications are defined as structured YAML data. This enables LLMs to read and generate workflows, visual tools to auto-render diagrams, and Git to track meaningful business logic changes.
Code vs. Data Comparison
Traditional Approach: Imperative Code
// 500+ lines of orchestration logic
class OrderWorkflow {
async execute(order) {
const validated = await this.validate(order);
if (!validated) throw new Error();
const charged = await this.stripe.charge(order.amount);
if (!charged.success) await this.compensate();
// ... 450+ more lines
}
}Problems with imperative code:
- Machines cannot understand intent (limits AI/LLM capabilities)
- Cannot generate visual diagrams automatically
- Git diffs show syntax changes, not business logic
- Requires deployment to change business rules
- Agents cannot read or modify safely
Cascade Approach: Structured Data
# 50 lines of structured data
workflows:
- name: order_processing
start: ValidateOrder
states:
- name: ValidateOrder
type: Task
action: validate
next: ChargeCard
- name: ChargeCard
type: Task
action: stripe.charge
retry: {max_attempts: 3}
catch:
- error: PaymentFailed
next: Compensate
next: CompleteBenefits of structured data:
- LLMs can read it - Clear structure with explicit intent
- LLMs can generate it - From natural language descriptions
- LLMs can optimize it - Suggest improvements automatically
- Visual tools auto-render - State machine diagrams from structure
- Git diffs make sense - Business logic changes are visible
- Non-developers configure - Via UI without deployment
- Agents can orchestrate - Read, modify, and execute workflows
Three Revolutionary Capabilities
1. AI-Native Development
Because applications are data, LLMs become first-class development tools.
Generate Applications
Describe in natural language and receive production-ready YAML
”I need a leave request workflow with manager approval” generates 200 lines of CDL instantly
Optimize Workflows
LLMs analyze workflows and suggest improvements
”This step could run in parallel"
"Add retry policy here"
"Consider caching this result”
Debug Intelligently
LLMs understand execution traces and explain failures
”Why did workflow xyz-123 fail?” - Agent reads logs, analyzes state, explains issue
2. Autonomous Agent Platform
Because workflows are data, agents can read and orchestrate them autonomously.
Unique Capability: Agents have full platform SDK (18+ capabilities) to read, write, and orchestrate workflows at runtime.
Agent Platform SDK Capabilities (v5.1):
Read-Only (7 capabilities):
read.workflow- Access workflow state via JSONPathread.memory_kv- General key-value storageread.memory_conversation- Dialogue historyread.memory_semantic- Vector-based knowledgeread.database- Execute read-only SQLread.secrets- Access vault secretsevaluate.decision- Evaluate DMN/OPA policies
Write (9 capabilities):
write.workflow- Update workflow statewrite.memory_kv/write.memory_conversation/write.memory_semantic- Store agent insightswrite.database/write.database_batch/write.database_transaction- Database writesexecute.action- Call platform actionsexecute.connector- Invoke external systems
High-Privilege (2 capabilities, require approval):
execute.workflow- Start new processesexecute.workflow_cancel- Cancel workflows
Security: All capabilities controlled via OPA policies and RBAC
Learn more about Agent Platform SDK →
3. Visual Development Platform
Because everything is structured data, visual tools work automatically.
Auto-generate diagrams - State machines from YAML
Visual editors - Drag-drop workflow builder
Live monitoring - Real-time execution visualization
Configuration UIs - Business users tune thresholds
Test visualization - See test coverage graphically
The Complete Platform Stack
What You Define (Declarative YAML)
# ONE language (CDL) for everything
• Workflows and orchestration
• Business rules (OPA/DMN)
• AI agents and capabilities
• Tests (E2E, integration, chaos)
• UI forms and validation
• Webhooks and triggers
• Configuration and policiesWhat Platform Provides
Runtime Services
Temporal-based execution
Automatic persistence
Built-in resilience
Vault integration
Automatic isolation
OpenTelemetry traces
RBAC + OPA policies
Result:
- You write: 5% (business logic only)
- Platform provides: 95% (infrastructure, security, scaling)
- Time to production: Hours, not weeks
Real-World Impact
Example: Order Processing System
Traditional Approach:
5,000+ lines of code:
- Orchestration logic: 2,000 lines
- State management: 1,000 lines
- Error handling: 800 lines
- Retry logic: 500 lines
- Testing framework: 700 linesCascade Approach:
426 total lines:
- Workflows (CDL): 300 lines
- Business rules: 100 lines
- Tests (YAML): 50 lines
- Integration code (Go): 26 linesImpact:
- 92% less code than traditional BPM approach
- Zero orchestration code (100% declarative)
- Declarative tests (no Jest/pytest required)
- AI can generate most workflow definitions
- Visual tools work automatically from structure
The “Two Primitives” Mental Model
For 90% of workflows, you only need 2 patterns:
1. TASK - Execute Work Immediately
- name: ChargeCard
type: Task
resource: "urn:cascade:action:stripe.charge"Duration: Milliseconds to seconds
Examples: API calls, agent analysis, policy decisions
2. WAITFORINPUT - Pause and Resume
- name: ManagerApproval
type: Task
resource: "urn:cascade:waitFor:human"Duration: Minutes to months
Examples: Human approval, webhook callback, event arrival
Learn the Two Primitives in depth →
CSL: ASL Superset with Agent Extensions
Architecture: CSL (Cascade State Language) is 100% compatible with Amazon States Language (ASL) v1.0 plus Cascade extensions.
Standard ASL Features (100% Support)
All 8 state types: Task, Choice, Parallel, Map, Pass, Wait, Succeed, Fail
JSONPath expressions (RFC 9535)
Error handling (Catch, Retry)
InputPath, ResultPath, ResultSelector
Execution context ($$. references)
AWS SDK validates syntax
Cascade Extensions
| Extension | Purpose | Example |
|---|---|---|
| Agent URNs | Invoke agents | urn:cascade:agent:fraud-analyzer |
| WaitForEvent | Multi-event waiting | Wait for Event A OR Event B OR timeout |
| DMN URNs | Decision tables | urn:cascade:dmn:leave-approval |
| Action URNs | Execute actions | urn:cascade:action:send-email |
| Saga | Distributed transactions | Auto-compensation on failure |
Why ASL Baseline?
- Industry standard (developers know it)
- AWS tooling works (visualizers, validators)
- Portability (export to Step Functions)
- Proven at scale (billions of executions)
Platform Capabilities
Cascade provides 35+ production-ready capabilities out-of-the-box:
Process Orchestration
Durable, fault-tolerant execution on Temporal
AI Agents
Autonomous agents with full platform SDK
Multi-Engine Policies
OPA + DMN + WASM for decision making
Memory System
KV, Conversation, Semantic knowledge
UI Generation
JSON Schema to multi-framework UIs
WASM Runtime
Sub-1ms cold start, 1000+ concurrent instances
Current Status: 35 capabilities, 30 fully implemented (85% coverage), 78% test coverage
View all capabilities in detail →
Start Building
5-Minute Quickstart
Deploy your first application-as-data
AI Development Guide
Use LLMs to generate and optimize workflows
Autonomous Agents
Build agents that orchestrate your platform
Platform Examples
See complete platforms built on Cascade
Why Cascade?
Application-as-Data Foundation:
- Structured YAML (not code)
- Machine-readable (LLMs understand)
- Git-versionable (meaningful diffs)
- Visually renderable (auto-diagrams)
AI-Native Capabilities:
- LLM generation (prompt to app)
- LLM optimization (auto-improve)
- Agent orchestration (autonomous)
- Declarative tests (AI-readable)
Autonomous Agent Platform:
- Agents at ANY step
- 18+ platform capabilities
- Full orchestration SDK
- OPA-based security
Developer Experience:
- 92-98% less code
- 100% declarative
- Sub-1s hot reload
- Visual tools included
- Production-ready
Compare Cascade with alternatives →
Ready to build? → Install Cascade | View Examples