orchestration

Drives validated campaign DAGs through dispatch, reconcile, and merge as a deterministic state machine.

10|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/nrdxp/predicate --skill orchestration-nrdxp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchestration
Source: https://github.com/nrdxp/predicate/tree/main/skills/orchestration
Command: npx skills add https://github.com/nrdxp/predicate --skill orchestration-nrdxp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-node campaign plan by hand is error-prone: workers drift into the wrong worktree, merges happen out of order, and resumed runs rely on memory instead of the git record. This Skill turns a validated campaign DAG into a runnable state machine that a composer or cheap-tier runner can drive mechanically, with every transition decided by gate exit codes rather than judgment. ## Core Features & Use Cases - Deterministic driver state machine: Lifts the orchestration protocol's pseudocode (DERIVE, RUN_LAYER, DISPATCH, AWAIT, RECONCILE, MERGE, BOUNDARY, CHECKPOINT, CLOSE) into a table where each state names the exact command and each exit code routes the next transition. - Log-first resume: Reconstructs campaign state from the flight recorder's git log and the single in-flight sketch, then boot-gates the reconstruction against contract exports and adherence audits before any dispatch. - Wired quality gates: Runs surface-honesty checks, coherence-impact over cumulative diffs, internal-ID leak sweeps, premise-freshness re-verification, merge-consent, and recorder-close gates at the exact protocol steps. - Use Case: A campaign with a validated DAG and worker IBCs needs execution — invoke the driver to derive the Kahn layer schedule, dispatch workers into isolated git worktrees per layer, reconcile and merge in node-id order, and halt at human seams for final acceptance. ## Quick Start Ask the agent to run the orchestration driver over the validated campaign DAG at .ledger/state/dag.yaml and drive dispatch and reconcile through to the merged integration branch.

Frequently Asked Questions about orchestration

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

FAQPage Schema
How do I execute a validated campaign DAG automatically?

Invoke the orchestration driver with the DAG bound as a parameter; it exports the DAG under the dag_apply.ncl contract, derives the Kahn layer schedule, then walks the state machine — dispatching workers into git worktrees per layer and reconciling in node-id order until CLOSE.

How do I resume a campaign that halted mid-execution?

Resume is log-first reconstruction: read the recorder's git log to find the single in-flight topic, open only that sketch, rebuild node statuses and the tip, then boot-gate the reconstruction against contract exports and the adherence audit before dispatching anything.

What happens when a worker touches files outside its declared surface?

The reconcile step derives the actual touched set from git and runs authorized.py against the declared surface. Undeclared touches route to SURFACE_EXCEED, where a collision check returns WIDEN (rc 0) or SERIALIZE (rc 3) to decide the fix.

Can the driver merge branches without human approval?

No. A merge-consent gate requires the lead maintainer's recorded assent before any git merge, and final acceptance plus any push is always a human seam — remotes belong to the human in both AUTONOMOUS and INTERACTIVE modes.

What happens when an acceptance evaluator cannot run?

The node is QUARANTINED rather than accepted or reworked: the landed work is retained and recorded, dependents are blocked, and the only exits are explicit discharge (evaluator restored and green, or converged decorrelated review) or REWORK.