choosing-swarm-patterns
Installation
SKILL.md
Overview
The Agent Relay SDK (@agent-relay/sdk) supports 24 swarm patterns via a single swarm.pattern field. Patterns are configured declaratively in YAML or programmatically via the workflow() fluent builder — there are no standalone fanOut(...) / hubAndSpoke(...) helpers. Pick the simplest pattern that solves the problem; add complexity only when the system proves it's insufficient.
Two ways to run a pattern
1. YAML (portable):
import { runWorkflow } from "@agent-relay/sdk/workflows";
const run = await runWorkflow("workflows/feature-dev.yaml", {
vars: { task: "Add OAuth login" },
});