| name | ager-to-orca |
| description | Translate a validated AGER/OKF AgentGraph into Orca ADE orchestration with named worktree agents, parallel fan-out, remote-control rename or disable, and official orca-cli + orchestration skills. |
AGER → Orca ADE
This plugin compiles. Authoring is okf-agent-graph.
Orca is the ADE from Stably AI (stablyai/orca). It has no native AGER YAML; this translator emits orca-project.yaml, named worker-start --name, isolated git worktrees, a remote-control rename map, and a coordinator that drives the DAG with official Orca skills.
Peer skills (required)
Compiled fleets run inside Orca. Install from this plugin, then load the live Orca guides:
npx skills add https://github.com/SpillwaveSolutions/orca-ager --skill ager-to-orca --global
npx skills add https://github.com/SpillwaveSolutions/orca-ager --skill orca-cli --global
npx skills add https://github.com/SpillwaveSolutions/orca-ager --skill orchestration --global
orca skills get orca-cli
orca skills get orchestration --full
| Skill | Translator use |
|---|
| orca-cli | Named worktrees, terminals, full handoffs. Prefer over raw git worktree. |
| orchestration | Run / Task / worker DAG, worker_done waits, decision gates, coordinator loop. Maps onto plan → review → implement → judge → mediate. |
The plugin vendors the discovery stubs under skills/orca-cli and skills/orchestration. They are not the command reference — the running binary is.
Mapping
| AGER | Orca |
|---|
| AgentGraph | Orca Project / Run (orchestration run-create) |
| OrchestratorAgent | Named lead session (no isolated worktree) |
| WorkerAgent | Named agent in isolated git worktree via orca-cli |
| JudgeAgent | Dedicated judge worktree; writes critique markdown |
| SynthesizerAgent | Mediator / idea-steal step on the orchestration DAG |
| GuardrailAgent | Final spec review against the plan |
| HumanGate | orchestration gate-create |
| FanOut / ParallelGroup | Parallel named worktrees, one per agent |
| LoopPolicy | Task budget, max_turns, deadline, no_progress |
| ScratchPad | docs/planning/ + artifacts/ |
Named roles are required: <Host>-<Role> (Claude-Plan-Drafter, Grok-Mediator). Remote-control policy is rename (default) or disable.
Steps
- Locate the AGER bundle. Validate with
ager-validate if present.
- Confirm orca-cli and orchestration are installed (see above). Load the live guides. Do not guess Orca flags.
- Run the deterministic emitter. Do not freehand the tree.
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT>
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT> --remote-control disable
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT> --name-prefix Fleet
python3 scripts/validate.py --bundle <AGER_ROOT>
- Report written paths. Confirm:
- every agent matches
<Host>-<Role>
- parallel worktrees do not overlap
- every
SYSTEM.md instructs the agent to orca skills get orca-cli and orca skills get orchestration --full
scripts/run-feature.sh uses orca-cli worktrees (not raw git) and orchestration primitives
agents/Orca-Coordinator/SYSTEM.md is present
- Never claim production-ready without tests. Hosts do not meter USD; document the budget and stop.
References