Skip to content

Architecture decision record: whether to adopt a multi-agent architecture

Copy this page to create a new ADR, and name the file ADR-NNN-简短标题.md.

Status

Proposed / Accepted / Rejected / Superseded

Context

Business objectives, users, task types, and current bottlenecks.

Constraints

Latency, cost, permissions, compliance, data, team, and operational constraints.

Options

  1. Deterministic workflow;
  2. LLM-enhanced workflow;
  3. Single agent;
  4. Multi-agent architecture.

Decision

Which option is selected, and why it is the simplest architecture that meets the requirements.

Actual boundaries

Describe the boundaries for domain, data, tools, permissions, state, failure, scaling, and organizational ownership.

Costs

The expected increase in model calls, latency, tokens, state synchronization, testing surface, and operational complexity.

Validation

Which Golden Datasets, metrics, baselines, and release gates will demonstrate the benefits.

Rollback

How to downgrade to a simpler architecture if the benefits fall short or the risks cannot be controlled.