Agent skill · yeachan-heo
graph
Deterministic orchestration graph runtime - declarative DAG pipelines with journal-based crash recovery
What it needs
About 3k tokens when loaded.
What this skill does
Graph Skill Run a deterministic orchestration graph from a declarative JSON descriptor. The runtime consumes the sealed-descriptor and pure-scheduler contracts in src/graph/ and executes through an independent OS process (omc graph run), so crash recovery (kill mid-run, rerun, resume from journal) works for real. Usage The execution surface is always the CLI subcommand: omc graph run <descriptor.json> [--runs-root <dir>] Run it via the Bash tool for non-interactive graphs. Progress lines stream as [run], [node], [ok], [fail], [join], [done]. When To Use Repeatable multi-step pipelines with explicit dependencies (DAG) Work that must survive interruption: kill/restart resumes from journal Auditable runs: OCC journal + projection snapshots under .omc/graph-runs/<runid>/ When NOT to use: exploratory one-off work (use conversation or /team); anything needing adaptive re-planning mid-run (graphs are deterministic). Workflow 1. Descriptor given -> go to step 3. 2. Pipeline described -> author the descriptor JSON (schema below), write it next to the project (suggest .omc/graphs/<name>.json) and show it to the user before running. runid must be unique per logical pipeline; rerunning with the same runid RESUMES, not restarts. 3. Approval nodes: if the descriptor contains any "kind": "human-approval" node, do NOT run it through the Bash tool (stdin is not interactive there; EOF fails closed to denied). Tell the user to run interactively instead: ! omc graph run <file> The ! prefix runs it inside this session with live stdin so y/n works. 4. Run and relay progress. Exit codes (normative): 0 succeeded 1 terminal failed 19 another writer owns this run (busy) 20 corrupt/tampered journal (fail-closed) 21 descriptor drift on resume 70 runtime crash (unmapped error) 5. Resume: rerunning the same command after a crash replays committed transitions and continues. Completed nodes never re-execute. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yeachan-heo/graph