dynamic-workflows

Dynamic Workflows Plugin Skill

Use this when operating the hermes-dynamic-workflows plugin itself. It is not the generic fan-out pattern skill. It tells you how to call the plugin tools that ship with this repo.

Plugin-provided skills are explicit-load only. Load this one as:

skill_view(name="hermes-dynamic-workflows:dynamic-workflows")

When to Use

Use this skill when the user asks to:

• validate, run, inspect, pause, resume, stop, or retry a Dynamic Workflows run;
• author or run a workflow-script harness;
• use agent(...), kanban_agent(...), parallel(...), pipeline(...), or capability(...) inside a workflow script;
• inspect blocked waits, approvals, finalizers, or child-agent state;
• debug the plugin installation or its workflow state stores.

Do not use this for small one-off tool sequences. Just call the normal tools.

Installed Surface

The plugin registers two model-facing tools in the dynamic_workflows toolset:

• workflow — validate/run/status/catalog/script operations.
• workflow_control — operator controls and blocked-wait/status inspection.

The plugin stores state under the active HERMES_HOME by default:

$HERMES_HOME/dynamic-workflows/runs/
$HERMES_HOME/dynamic-workflows/controls/
$HERMES_HOME/dynamic-workflows/script-runs/
$HERMES_HOME/dynamic-workflows/background-runs/
$HERMES_HOME/dynamic-workflows/scripts/
$HERMES_HOME/dynamic-workflows/templates/

Useful overrides:

HERMES_WORKFLOWS_STATE_DIR          # run store root; sibling stores live beside it
HERMES_WORKFLOWS_SCRIPT_CATALOG_DIR # saved script harness catalog root
HERMES_WORKFLOWS_CATALOG_DIR        # JSON workflow template catalog root

JSON Workflow Definitions

Fast path:

workflow(action="validate", definition={...})
workflow(action="run", definition={...}, inputs={...})
workflow(action="status", run_id="wf_...")

Minimal definition:

{
  "version": "1",
  "name": "hello",
  "policy": {"network": false, "filesystem": false, "max_parallel": 2},
  "inputs": {"name": "string"},
  "steps": [
    {
      "kind": "agent",
      "id": "greet",
      "agent": "hermes.greeter",
      "input": {"subject": "$ref:inputs.name"},
      "output_schema": {"greeting": "string"}
    }
  ]
}