
Choosing Swarm Patterns
Pattern reference and decision framework for choosing among 24 Agent Relay orchestration patterns.
- GitHub stars
- 1.1K
- last updated
- Jun 11, 2026
What it does
- Covers 10 core patterns (fan-out, pipeline, hub-spoke, consensus, mesh, handoff, cascade, dag, debate, hierarchical) with topology and best-fit use cases
- Includes a decision framework that starts from whether tasks are independent, linear, or require a decision, then narrows to one pattern
- Lists 14 role-driven patterns such as
map-reduce,supervisor,red-team, andreview-loop, each with the roles that shape its topology - Notes that
hierarchicalcurrently resolves to the same edges ashub-spoke, and thatswarm.patternmust be set explicitly in YAML
Install
$ npx -y skills add agentworkforce/relay --skill choosing-swarm-patterns -yInstalls into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.
Files
Overview
Overview
The Agent Relay SDK (@agent-relay/sdk) supports 24 swarm patterns via a single swarm.pattern field. Patterns are configured declaratively in YAML — 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.
Run a pattern
TypeScript SDK runner
import { runWorkflow } from '@agent-relay/sdk/workflows';
const run = await runWorkflow('workflows/feature-dev.yaml', {
vars: { task: 'Add OAuth login' },
});
Quick Decision Framework
Details
- Repository
- github.com/agentworkforce/relay
- Category
- AI & Agent Building
- License
- Apache-2.0
- First seen
- Jun 11, 2026
More from agentworkforce/relay
All 17- Creating Agent Skills Skill
- Creating Claude Agents
- Creating Claude Hooks
- Creating Claude Rules
- Creating Skills
- Debugging Websocket Issues
- Deploying To Staging Environment
- Github Oauth Nango Integration
- Implementing Command Palettes
- Prpm Json Best Practices
- Relay 80 100 Workflow
- Review Fix Signoff Loop
- Setting Up Relayfile
- Using Agent Relay
- Writing Agent Relay Workflows
- Browser Testing With Screenshots
Similar to Choosing Swarm Patterns
More AI & Agent Building
Natural Language Processingaj-geddes/useful-ai-promptsBuild NLP applications using transformers library, BERT, GPT, text classification, named entity recognition, and sentiment analysis
aibutterbase-ai/butterbase-skillsWraps every Butterbase app's built-in LLM gateway into a single MCP tool: chat completions, embeddings, model listing, config...
butterbase-skillsbutterbase-ai/butterbase-skillsClaude Code plugin for Butterbase — 30+ guided skills and auto-configured MCP for the AI-native backend-as-a-service.
journey-agentsbutterbase-ai/butterbase-skillsUse as the agents build stage of the Butterbase journey. Implements the Agents section of 02-plan.md by delegating to the `agents` skill for each agent. Registe
substratebutterbase-ai/butterbase-skillsIf you're building a founder copilot or any AI agent that needs to remember things across sessions, this gives Claude direct access to...
happyhorse-promptercclank/lanshu-awesome-ai-video-kit生成符合 HappyHorse 1.0 严格规则的紧凑提示词(30-55 词),主体先行 + 明确镜头技术 + 音频激活路径(with X audible / speaking English at natural pace)。可选加入"8s 时序节拍"结构。用于"用 HappyHorse 生成视频"、"做个 3-15