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.yamlops/queue/queue.ymlops/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