- 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 <id>] [--type <extract|create|reflect|reweave|verify>]
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:
- positional
target(optional) --handoff(boolean)--batch <id>(optional)--type <phase>(optional)- 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
--handoffis 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