This skill should be used when the user asks to "design multi-agent system", "implement supervisor pattern", "create swarm architecture", "coordinate multiple agents", or mentions multi-agent patterns, context isolation, agent handoffs, sub-agents, or parallel agent execution.
View on GitHubguanyang/antigravity-skills
antigravity-skills
January 24, 2026
Select agents to install to:
npx add-skill https://github.com/guanyang/antigravity-skills/blob/main/skills/multi-agent-patterns/SKILL.md -a claude-code --skill multi-agent-patternsInstallation paths:
.claude/skills/multi-agent-patterns/# Multi-Agent Architecture Patterns Multi-agent architectures distribute work across multiple language model instances, each with its own context window. When designed well, this distribution enables capabilities beyond single-agent limits. When designed poorly, it introduces coordination overhead that negates benefits. The critical insight is that sub-agents exist primarily to isolate context, not to anthropomorphize role division. ## When to Activate Activate this skill when: - Single-agent context limits constrain task complexity - Tasks decompose naturally into parallel subtasks - Different subtasks require different tool sets or system prompts - Building systems that must handle multiple domains simultaneously - Scaling agent capabilities beyond single-context limits - Designing production agent systems with multiple specialized components ## Core Concepts Multi-agent systems address single-agent context limitations through distribution. Three dominant patterns exist: supervisor/orchestrator for centralized control, peer-to-peer/swarm for flexible handoffs, and hierarchical for layered abstraction. The critical design principle is context isolation—sub-agents exist primarily to partition context rather than to simulate organizational roles. Effective multi-agent systems require explicit coordination protocols, consensus mechanisms that avoid sycophancy, and careful attention to failure modes including bottlenecks, divergence, and error propagation. ## Detailed Topics ### Why Multi-Agent Architectures **The Context Bottleneck** Single agents face inherent ceilings in reasoning capability, context management, and tool coordination. As tasks grow more complex, context windows fill with accumulated history, retrieved documents, and tool outputs. Performance degrades according to predictable patterns: the lost-in-middle effect, attention scarcity, and context poisoning. Multi-agent architectures address these limitations by partitioning work across multipl