workflow-shim-prefix-scheme

What problem does it solve?

Prevents node and binding name collisions when converting LLMStateGraph (XSM) into WorkflowNet, especially for nested ParallelSubgraph (PSG) inner nodes.

Core Features & Use Cases

• Deterministic naming rules: Defines exact prefixes for WorkflowNet places and transitions derived from XSM nodes (in/out/handler) plus PSG split/join transitions and cross-node edges.
• Collision avoidance for nested PSGs: Uses __ as a namespace delimiter and propagates a recursive prefix like prefix <> parentNodeId <> "__" to uniquely qualify inner node names at any nesting depth.
• Safety validation for reserved identifiers: Enforces the rule that node IDs must not contain __, validated at runtime via iValidateNodeId.
• Prefix-aware handler bindings: Ensures handler factories generate binding keys using the same prefix scheme so that lookup succeeds even when inner nodes are renamed.
• Payload/token structure alignment: Documents how handler outputs should be stored in GlobalState (including node-isolated Decision results and stategraph-compatible Stages[nodeId][Output]).

Quick Start

Use this skill when implementing or extending the WorkflowNet generation shim so that every derived place/transition name and handler binding key follows the specified prefix scheme.