Workflow Engine

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 (optional)
• --type (optional)
• unknown flags are non-fatal; report and ignore

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

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)

• 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