swarm-star
Use when running truly independent parallel tasks where a hub collects results without cross-worker coordination. Also use for parallel research, multi-API data gathering, or fan-out/fan-in patterns.
| Model | Source |
|---|---|
| opus | pack: swarms |
Full Reference
Swarm — Star Topology
Section titled “Swarm — Star Topology”Hub-and-spoke. One hub dispatches independent spokes, collects results, aggregates. No cross-worker coordination — spokes never see each other’s output. Best for truly parallel work where results combine without conflict. If aggregation reveals conflicts, star was the wrong topology — no conflict resolution happens here.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Pattern | Hub dispatches spokes → spokes return → hub aggregates |
| Cross-worker coordination | None — spokes are fully isolated |
| Aggregation | Collection only, no review |
| Scale sweet spot | 2-5 spokes standard, 6-15 batched |
| Scale limit | 15+ → hierarchical with sub-stars |
| Speed | Fastest topology — full parallelism |
Reference Index
Section titled “Reference Index”| I want to… | File |
|---|---|
| See the topology diagram and when to use vs other topologies | reference/topology.md |
| Implement hub dispatch, spoke tasks, and aggregation | reference/implementation.md |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.
Announcement
Section titled “Announcement”┏━ ⚡ swarm-star ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ [one-line description of what’s being parallelized] ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛