⬡ Overview
◈ Why Teams?
⌖ Architecture
↻ Message Flow
▶ Live Simulation
🔬 Inspect Output
⚠ Failure Modes
◇ Check
★ Results
0 / 5
Hands-On Lab  ·  Module 9  ·  BAA 9.0

Agent Team
Simulation

One agent researches. One agent writes. Together they produce something neither could alone — and the handoff between them is where all the interesting engineering happens. In this lab you design the architecture, sequence the message flow, and watch two real AI agents collaborate live.

What You'll Do
⌖
Design the architecture — assign the right responsibilities to the Research Agent vs. Writer Agent vs. Orchestrator.
↻
Sequence the message flow — drag 8 steps into the exact order that a two-agent pipeline follows.
▶
Run a live simulation — watch two real Claude instances pass a structured handoff message and produce a polished summary.
🔬
Inspect the output — annotate exactly which parts of the final summary came from research vs. synthesis vs. inference.
Roadmap
—
Why Agent Teams? The case for multi-agent systems
Explore the three problems that make one agent insufficient — and why specialization wins
1
Architecture Drag-and-Drop
Assign 12 responsibilities and capabilities to the correct agent role
2
Message Flow Sequencer
Reorder 8 pipeline steps into the correct execution order — the handoff message is the key
3
Live Two-Agent Simulation
Pick a topic, watch Agent 1 (Research) and Agent 2 (Writer) collaborate in real time
4
Output Inspection & Annotation
Read the Writer Agent's output — identify which parts are raw research vs. synthesis vs. inference
5
Multi-Agent Failure Mode Classification
Classify 6 real failure modes — which agent caused it? Which step in the pipeline broke?
—
Knowledge Check · 7 questions · 70% to pass
The Motivation

Why One Agent Isn't Enough

Before you build a team, you need to understand the three problems that make single-agent systems break down — and why splitting responsibilities between specialized agents fixes each one.

🧠
Problem 1 — Context Window Contamination

When a single agent both researches AND writes, it juggles two competing cognitive modes in one context window. Research mode favors breadth — collect everything, stay neutral, flag contradictions. Writing mode favors selectivity — pick the best angle, build narrative momentum, ignore tangents. These modes contaminate each other. The result: a half-researched summary, or a paralyzed researcher who can't commit to a narrative.

The fix: Separate context windows. The Research Agent's context is pure signal collection. The Writer Agent's context contains only the structured findings — not the noise.
⚙️
Problem 2 — Role Drift Under Instruction Pressure

Ask a single agent to "research the topic and write a summary" and it will start writing before it has finished researching — because the instruction contains implicit pressure to produce visible output. The research phase gets cut short. Alternatively, it over-researches and delivers a data dump instead of a summary. The two tasks have different completion signals and the agent can't satisfy both.

The fix: Each agent has one job and one completion signal. The Research Agent is done when it delivers a structured JSON handoff. The Writer Agent is done when it delivers a formatted summary.
🔁
Problem 3 — No Auditability of the Research-to-Writing Transition

When research and writing happen inside one agent, you can't inspect what the agent "knew" before it started writing. If the summary is wrong, was it a bad research phase or a bad synthesis phase? In a two-agent system, the handoff message is a first-class artifact — you can read it, validate it, and even route it to a human reviewer before the Writer Agent sees it.

The fix: The handoff message is structured and inspectable. The Orchestrator can validate, filter, or augment it before passing it downstream.
The Team Structure
👤 User / Trigger Topic request
topic + format
🔬 Orchestrator Routes & validates
research task
🔭 Research Agent Gather & structure
handoff JSON
✍️ Writer Agent Synthesize & write
final summary
📄 Output Delivered to user
🔮 The handoff message is the most important artifact in this system. It's the structured JSON that the Research Agent passes to the Writer Agent — containing key findings, source summaries, confidence levels, and gaps. It determines everything the Writer Agent can and cannot say. In this lab you will see exactly what it looks like — and why its structure matters.
Section 01 · Lab Activity

Architecture Assignment

12 responsibilities and capabilities. Each belongs to exactly one role: the Research Agent, the Writer Agent, or the Orchestrator. Drag each to the correct zone — one wrong placement reveals a design flaw.

💡 Guiding principle: The Research Agent never writes for humans. The Writer Agent never decides what to look up. The Orchestrator never does cognitive work itself — it only routes, validates, and controls flow.
Responsibilities & capabilities — drag to correct agent role
On mobile? Tap to assign
Section 02 · Lab Activity

Message Flow Sequencer

A two-agent pipeline has 8 distinct steps from user request to final output. Drag them into the correct execution order — pay close attention to when the handoff message gets created, validated, and consumed.

💡 Key insight: The Orchestrator appears twice in the pipeline — once to dispatch the Research Agent, and once to validate the handoff before passing it to the Writer Agent. That validation step is often skipped in naive implementations — and is where most real-world failures occur.
Section 03 · Live AI Demo

Watch Two Agents Collaborate

This is real. Pick a topic, hit Run — and watch an actual Research Agent and Writer Agent exchange a structured handoff message and produce a summary. Both agents are powered by Claude.

🔮 What makes this multi-agent: Two separate API calls with different system prompts and separate context windows. The Research Agent's output is extracted and formatted into a structured JSON handoff before it's injected into the Writer Agent's context. The Writer Agent never sees the Research Agent's internal reasoning — only the structured findings.
Choose a Topic
Or type your own:
Section 04 · Analysis

Inspect the Writer's Output

Not everything in the final summary comes from the research. Some parts are synthesis. Some are the Writer Agent's own inferences. Some may be things the Research Agent never found. Understanding the difference is critical for knowing what you can and can't trust.

Directly from Research Findings
Writer's Synthesis / Framing
Inference / Interpretation
Possible Gap / Needs Verification
Annotated Writer Agent Output — Hover highlights to learn what type of content each is
Run the simulation first to generate output for annotation.
Section 05 · Critical Analysis

Multi-Agent Failure Modes

Multi-agent systems fail in ways that single-agent systems don't. Classify each failure: which agent caused it, and which stage of the pipeline broke?

💡 Three failure categories: Research Agent (produced bad or incomplete findings) · Writer Agent (misused or exceeded the research) · Orchestrator / Handoff (the pipeline itself broke)
Classified: 0 / 6
Knowledge Check

7 Questions

Questions on multi-agent architecture, message flow, and the failure modes you just classified. 70% to pass.

Question 1 of 7Score: 0 / 0
Lab Debrief

Lab Complete