ruflo-workflows

Workflow automation with templates, orchestration, and full state-machine lifecycle management.

Install

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-workflows@ruflo

Features

• Workflow creation: Define multi-step processes with conditions and parallel execution
• Templates: Reusable workflow patterns for common operations
• Lifecycle management: Execute, pause, resume, cancel running workflows
• Approval gates: Manual pause points for human review

Commands

• /workflow -- List workflows, check status, view templates

Skills

• workflow-create -- Create reusable workflow templates
• workflow-run -- Execute and manage running workflows

Compatibility

• CLI: pinned to @claude-flow/cli v3.6 major+minor.
• Verification: bash plugins/ruflo-workflows/scripts/smoke.sh is the contract.

MCP surface (10 tools)

All defined at v3/@claude-flow/cli/src/mcp-tools/workflow-tools.ts:

Tool	Purpose
workflow_create	Create a new workflow definition
workflow_run	Run a workflow with inputs
workflow_execute	Execute a one-shot workflow without persistence
workflow_status	Inspect a running workflow
workflow_list	List workflows
workflow_pause	Pause a running workflow
workflow_resume	Resume a paused workflow
workflow_cancel	Cancel a workflow
workflow_delete	Delete a workflow definition
workflow_template	Manage workflow templates

Lifecycle state machine

created ──run──→ running ──pause──→ paused ──resume──→ running
                    │                  │
                    │                  └──cancel──→ cancelled
                    │
                    ├──complete──→ completed
                    └──cancel────→ cancelled

State	Allowed transitions
created	running (via workflow_run), cancelled (via workflow_cancel)
running	paused (via workflow_pause), completed (auto), cancelled (via workflow_cancel)
paused	running (via workflow_resume), cancelled (via workflow_cancel)
completed	terminal
cancelled	terminal

workflow_execute is the stateless path — fire-and-forget, no persisted state machine.

Namespace coordination

This plugin owns the workflows-state AgentDB namespace (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

workflows-state indexes workflow definitions, current state, run history, and template metadata. Accessed via memory_* (namespace-routed).

Verification

bash plugins/ruflo-workflows/scripts/smoke.sh
# Expected: "11 passed, 0 failed"

Architecture Decisions

• ADR-0001 — ruflo-workflows plugin contract (10-tool MCP surface, lifecycle state machine, smoke as contract)

Related Plugins

• ruflo-agentdb — namespace convention owner
• ruflo-loop-workers — sibling automation surface (loops are recurring; workflows are stateful pipelines)
• ruflo-sparc — SPARC phase transitions can be modeled as workflows