workflow-engine

Routes multi-step agent workflows through a machine-readable DAG with gates and fan-out.

Updated May 12, 2026
One-click install
npx skills add https://github.com/sohamda/apex-try-out-demo-repo --skill workflow-engine-sohamda
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-engine
Source: https://github.com/sohamda/apex-try-out-demo-repo/tree/main/.github/skills/workflow-engine
Command: npx skills add https://github.com/sohamda/apex-try-out-demo-repo --skill workflow-engine-sohamda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Orchestrating a multi-step agent pipeline with hardcoded step logic is brittle and hard to resume after interruptions. This Skill replaces hardcoded routing with a declarative, machine-readable workflow graph (DAG) that the Orchestrator reads to determine the next step, handle human approval gates, and resume from checkpoints. ## Core Features & Use Cases - DAG-Based Step Routing: Loads templates/workflow-graph.json and follows on_complete, on_skip, and on_fail edges to route between agent steps, gates, validations, and fan-out nodes. - Conditional IaC Branching: Routes Steps 4-6 to Bicep (*-b) or Terraform (*-t) tracks based on the decisions.iac_tool value captured in requirements. - Gate and Fan-Out Handling: Blocks downstream execution at human approval gates and dispatches parallel sub-steps (e.g., Step 7 documentation generation) concurrently. - Use Case: After a user approves the architecture gate, the Orchestrator runs apex-recall show <project> --json, finds the current node in the graph, and routes to governance discovery or the correct IaC planning branch without any hardcoded logic. ## Quick Start Ask the orchestrator to load the workflow graph and resume my project from its current step using apex-recall session state.

Frequently Asked Questions about workflow-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume a multi-step agent workflow after an interruption?▼

Run `apex-recall show <project> --json` to read the current_step from session state, then find the matching node in workflow-graph.json. Nodes marked in_progress resume from their sub_step checkpoint; completed nodes follow their on_complete edges to the next step.

How does the workflow route between Bicep and Terraform tracks?▼

Routing reads `decisions.iac_tool` from session state. Steps 4, 5, and 6 branch to `*-b` nodes (Bicep) or `*-t` nodes (Terraform) based on that value, which is captured during the requirements phase.

What edge conditions does the workflow DAG support?▼

Each edge uses exactly one of three conditions: on_complete (source finished successfully), on_skip (source was skipped, e.g., optional steps), or on_fail (source failed, routing to error handling). Ambiguous or multiple conditions per edge are validation errors.

How are human approval gates handled in the workflow graph?▼

Gate nodes block all downstream execution until human approval is recorded in session state. The orchestrator writes a 00-handoff.md file before presenting each gate so users can resume in a fresh chat without losing context.

Can the workflow graph schema be changed safely?▼

Yes, via the schema evolution policy. Additive changes bump the minor version and require updating the schema, validator, and all consumers; breaking changes bump the major version with dual-read support. Rolling back metadata.version degrades new rules to info severity.

When should I not use this workflow engine skill?▼

Do not use it for Azure infrastructure generation, code authoring, or troubleshooting tasks. It is a utility skill strictly for orchestrator step routing, resume-from-graph, and workflow validation within the agent pipeline.