graph-engineering
Installation
SKILL.md
Graph Engineering
A fan-out is not a graph. Launching N agents at one scope is scatter-gather; a graph exists only when some units depend on others, and then the ordering is the work. Build the graph: a verification contract fixed before any node runs, nodes cut at judging seams, edges that state why order matters, a schedule that defaults to serial and earns every concurrency, one independent verifier per node — and a rendering the user reads and approves before the first node is dispatched.
Three rules carry the rest.
- The contract precedes the artifact. Define correctness before implementation, or implementation defines correctness and every later check merely confirms it.
- Whoever built it does not judge it. Every node is judged by a fresh context that never saw the building.
- Concurrency is an exception with evidence. Serial is the default because conflicting edits, duplicated work, and divergent decisions cost more than the wall-clock they save.
Build a graph only when there are edges to schedule. One unit of work in one context is not a graph, and no amount of structure rescues a goal that was never fixed.
Roles
| Role | Owns | Never |
|---|---|---|
| Orchestrator | contract, cut, edges, schedule, integration, re-planning | implements a node's artifact, or judges one |
| Worker | one node's artifact and its raw evidence | judges its own work, or decides ordering |
| Verifier | one node's verdict against the contract | edits the artifact, or reads the worker's reasoning |