🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Workflow Engine

by @plgonzalezrx8

Structural parity skeleton for queue-driven orchestration in a workflow context.

Versionv1.0.0
Downloads2,063
TERMINAL
clawhub install workflow-engine

πŸ“– About This Skill


name: workflow-orchestrator description: Structural parity skeleton for queue-driven orchestration in a workflow context. user-invocable: true version: "0.1" allowed-tools: Read, Write, Edit, Grep, Glob, Bash argument-hint: "[target] [--handoff] [--batch ] [--type ]"

Contract

This skill is intentionally skeleton-only. It provides structure parity with canonical queue orchestration without plugin hooks.

Wave 2 execution parity includes:

  • Setup derivation phase ordering: detection -> understanding -> derivation -> proposal -> generation -> validation
  • Required persisted setup artifacts: ops/derivation.md, ops/derivation-manifest.md, ops/config.yaml
  • In-skill lifecycle emulation routines (not real hook execution):
  • - session orient - write-time validation checklist - stop/session capture persistence

    Argument Parsing

    Parse arguments in this order: 1. positional target (optional) 2. --handoff (boolean) 3. --batch (optional) 4. --type (optional) 5. unknown flags are non-fatal; report and ignore

    If no target is supplied, list candidate inbox files and request explicit selection.

    Runtime Loader Requirements

    Before doing queue work, load runtime context from:

  • ops/derivation-manifest.md (if present)
  • ops/config.yaml (if present)
  • queue file with fallback precedence:
  • 1. ops/queue/queue.yaml 2. ops/queue/queue.yml 3. ops/queue/queue.json

    If no queue file exists, fail safely with actionable remediation.

    Safety Constraints

    Never:

  • execute arbitrary shell from user-provided strings
  • continue processing after parse/load failures
  • mutate tasks outside declared queue schema fields
  • call external plugins/hooks (explicitly out of scope)
  • Always:

  • validate queue structure before state transitions
  • make state transitions explicit (extract -> create -> reflect -> reweave -> verify -> done)
  • produce deterministic handoff text when --handoff is set
  • preserve resumability by reading persisted queue state first
  • Scope Boundary

    No plugin hooks are implemented in this skeleton. Lifecycle behavior is emulated in-skill to preserve deterministic execution semantics only.

    Installation

    To install the workflow-engine and enable its hooks:

    # Clone or navigate to the workflow-engine directory
    cd workflow-engine

    Run the install script to set up hooks

    ./install-hooks.sh

    Or manually enable hooks via openclaw

    openclaw hooks enable session-orient openclaw hooks enable write-validate openclaw hooks enable session-capture