multi-agent-topology-review

Reviews multi-agent architecture proposals against a five-gate test with cost and failure-rate evidence.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/dperussina/function2agent --skill multi-agent-topology-review-dperussina
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: multi-agent-topology-review
Source: https://github.com/dperussina/function2agent/tree/main/.cursor/skills/multi-agent-topology-review
Command: npx skills add https://github.com/dperussina/function2agent --skill multi-agent-topology-review-dperussina

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams frequently propose multi-agent designs (subagents, swarms, orchestrators, agent handoffs) without evidence that the added coordination cost is justified, leading to higher token spend, compounding errors, and debugging difficulty. This Skill challenges those proposals with a structured five-gate test and published cost and failure data. ## Core Features & Use Cases - Five-Gate Evaluation: Checks whether a proposed multi-agent design has genuinely independent threads, read-only or cleanly partitioned writes, evidence exceeding one context window, value absorbing a ~15x token multiplier, and a verification pass on synthesis. - Cost and Failure Evidence: Cites Anthropic's token-multiplier data, Berkeley's MAST study (41%-86.7% failure rates across seven frameworks), and the read/write asymmetry rule to argue against unnecessary fan-out. - Topology Ranking: Rates orchestrator-worker with read-only workers, sequential pipelines, hierarchical, and peer-network topologies, and identifies portable single-agent patterns like clean-context review. - Use Case: When a design document proposes splitting a single agent into an orchestrator with six workers, run this review to test the split against the five gates and present the single-agent-with-larger-budget control comparison. ## Quick Start Review this proposed multi-agent architecture and argue against it using the five-gate test unless every gate passes.

Frequently Asked Questions about multi-agent-topology-review

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

FAQPage Schema
When should I use a multi-agent system instead of a single agent?▼

Use multi-agent only when all five gates hold: genuinely independent threads, read-only or cleanly partitioned writes, evidence exceeding one context window, value absorbing a ~15x token multiplier, and a verification pass on synthesis. Otherwise a single agent with a larger budget and better tools wins on cost, latency, and reliability.

How much more expensive are multi-agent systems compared to single agents?▼

Multi-agent systems use roughly 15x the tokens of plain chat, versus about 4x for a single agentic loop with tools, per Anthropic's published measurements. Recursive subagent spawning or oversized tool results multiply this further, so per-run budget caps are necessary.

What are the most common multi-agent system failure modes?▼

Berkeley's MAST study found 41%-86.7% failure rates across seven frameworks, with roughly two-thirds of failures in architecture and plumbing rather than model quality. The largest single sub-category is missing termination conditions, followed by inter-agent misalignment and absent task verification.

Is it safe to run multiple agents in parallel for writes?▼

Parallel writes are where multi-agent failure modes concentrate, because writes carry implicit decisions and side effects that conflict at merge. Fan out freely for reads and analysis, but funnel all mutations through one writer or partition writes by strictly disjoint resources.

What is the best multi-agent topology for production systems?▼

Orchestrator-worker with read-only workers is the only topology with a strong track record. Sequential pipelines are the most debuggable option, hierarchical designs risk cost explosion without circuit breakers, and peer-to-peer agent networks are considered a research aesthetic.