ruvnet avatar

Workflow Run

This handles the full lifecycle of running workflows in two different modes. For MCP workflows, you get execute, pause, resume, cancel, and status operations with support for sequential, parallel, conditional, and manual gate execution. For native .claude/workflows/*.js files, it invokes the Workflow tool and manages deterministic subagent fan-outs with journal-based resume from a prior runId. The MCP side is stateful orchestration, the native side is cached replay. Use it when you need to actually run a workflow you've already defined, not just create or inspect one. The two surfaces don't share a pause mechanism, which is a bit awkward but reflects the underlying architecture.

skills.sh installs
744
GitHub stars
81.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add ruvnet/ruflo --skill workflow-run --agent claude-code

Installs into .claude/skills of the current project.

Files

Workflow Run

Run and manage a workflow on either surface.

A — MCP workflow lifecycle

When you need to run a persisted definition and control its lifecycle (pause/resume/cancel):

  1. Execute — call mcp__plugin_ruflo-core_ruflo__workflow_execute or mcp__plugin_ruflo-core_ruflo__workflow_run with the workflow ID
  2. Monitor — call mcp__plugin_ruflo-core_ruflo__workflow_status to check progress and step outcomes
  3. Pause — call mcp__plugin_ruflo-core_ruflo__workflow_pause to halt at the current step
  4. Resume — call mcp__plugin_ruflo-core_ruflo__workflow_resume to continue from where paused
  5. Cancel — call mcp__plugin_ruflo-core_ruflo__workflow_cancel to abort the workflow

Execution modes: sequential, parallel (independent steps), conditional (branch on outcome), manual gate (pause for human approval).

B — Native .claude/workflows/*.js

When you need a deterministic subagent fan-out, run a named native workflow with the Workflow tool. The named workflows are the meta.name of each .claude/workflows/*.js file (list them with /workflow or ls .claude/workflows/).

Sponsors

Details

Repository
github.com/ruvnet/ruflo
Categories
AI & Agent Building, Automation & Workflows
First seen
Jun 3, 2026

More from ruvnet/ruflo

All 236
1ruvnet avatarchat-formatruvnet/rufloFormat prompts for different LLM providers with chat templates and HNSW-powered context retrieval743skills.sh installs
2ruvnet avatarvalidate-pluginruvnet/rufloValidate a Claude Code plugin structure, frontmatter, and MCP tool references742skills.sh installs
3ruvnet avatarobserve-traceruvnet/rufloTrace agent execution by collecting spans and building a trace tree for a task733skills.sh installs
4ruvnet avatarfederation-statusruvnet/rufloShow federation health — peers, sessions, trust levels, and message metrics. Use when the user asks "is federation healthy?", "show peers", "federation status",731skills.sh installs
5ruvnet avatarcost-reportruvnet/rufloGenerate a cost report showing token usage and USD costs by agent and model730skills.sh installs
6uniswap avatarv4-hook-generatoruniswap/uniswap-aiGenerate Uniswap v4 hook contracts via OpenZeppelin MCP. Use when building custom swap logic, async swaps, hook-owned liquidity, custom curves, dynamic fees, ME714skills.sh installs