multi-agent-patterns

Document orchestration patterns, failure modes, and token economics for Claude Code systems.

2|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/dandudzi/dotfiles --skill multi-agent-patterns-dandudzi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multi-agent-patterns
Source: https://github.com/dandudzi/dotfiles/tree/main/dot_claude/skills/multi-agent-patterns
Command: npx skills add https://github.com/dandudzi/dotfiles --skill multi-agent-patterns-dandudzi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to designing, implementing, and debugging complex multi-agent systems, addressing common pitfalls and offering best practices for orchestration, coordination, and token efficiency.

Core Features & Use Cases

  • Orchestration Patterns: Learn about Supervisor, Peer-to-Peer, and Hierarchical patterns for managing agent interactions.
  • Failure Mode Analysis: Understand and mitigate common issues like divergence, error propagation, and consensus hallucination.
  • Token Economics: Optimize agent system performance by understanding token usage multipliers for different patterns.
  • Use Case: When designing a system where multiple AI agents need to collaborate on a complex task, like software development or research analysis, consult this Skill for proven architectural patterns and coordination strategies.

Quick Start

Consult the multi-agent patterns skill for guidance on designing an agent workflow.

Frequently Asked Questions about multi-agent-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the common failure modes in multi-agent orchestration?

Common multi-agent orchestration failure modes include divergence, error propagation, and consensus hallucination. This Skill catalogs these specific coordination failures and provides mitigation strategies to stabilize agent workflows.

How do I design a supervisor pattern for coordinating multiple AI agents?

To design a supervisor pattern for coordinating multiple AI agents, this Skill provides specific rules and context isolation principles. It details how a central supervisor manages interactions and distributes tasks across the system.

How do token economics impact different multi-agent coordination patterns?

Token economics impact multi-agent coordination patterns through specific token usage multipliers. This Skill analyzes these costs across Supervisor, Peer-to-Peer, and Hierarchical patterns to help optimize parallel task execution and reduce overhead.

When should I use hierarchical versus peer-to-peer agent workflows?

You should use hierarchical agent workflows for structured task delegation and peer-to-peer for direct coordination. This Skill compares these orchestration patterns, highlighting their specific rules and token cost implications for complex system design.

Why does my multi-agent system fail at parallel task execution?

Multi-agent parallel task execution often fails due to context isolation breakdowns or unhandled error propagation. This Skill offers debugging strategies for coordination failures, focusing on context isolation principles and failure mode analysis.