| 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:
ops/queue/queue.yaml
ops/queue/queue.yml
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:
cd workflow-engine
./install-hooks.sh
openclaw hooks enable session-orient
openclaw hooks enable write-validate
openclaw hooks enable session-capture