Skip to slide
Chapter 1 · What Is an Agent Harness?
04 / 142

CHAPTER 01 · What Is an Agent Harness? · 3 / 6

How it works: two mental maps

Different sources slice the harness in different ways. Two slicings are worth keeping in your head as a map for the rest of the guide.

Map A: the six layers (from the Claude Code architecture breakdown)

This view puts a simple loop in the middle and wraps six concentric layers around it.

LayerWhat it doesWhere in this guide
1. InputSession boundary, trust, what the agent is allowed to doCh 7
2. KnowledgePersistent instructions and context that survive long sessionsCh 9
3. ExecutionDispatching tools and running the loopCh 2, 6
4. IntegrationExternal systems and packaged extensions (MCP, plugins)Ch 10
5. Multi-agentDelegated work that does not blow up the main contextCh 11
6. ObservabilityDeterministic control and audit points (hooks, checkpoints)Ch 12

The key phrase from that breakdown is that the loop in the center is "the dumb part on purpose." The intelligence is not in some clever orchestration engine. It is in the model's reasoning plus the quality of the layers around it.

Map B: the seven pillars (from the "Agentic Harness Architecture" breakdown)

This view is more opinionated and more builder-focused. It lists seven things a production harness gets right, and for each one it separates what the platform gives you for free from what you have to architect yourself.

PillarThe core ideaWhere in this guide
1. Context engineeringDecide what enters the context window, and what stays outCh 3, 4, 5
2. Memory managementKnowledge that lives outside the model's weightsCh 9
3. Skills as workflow encodingPackage a repeatable procedure the agent loads on demandCh 10
4. Agent contracts and orchestrationGive each subagent a clear input/output contractCh 11
5. Tiered executionAnswer cheaply when you can, escalate only when you mustCh 5, 11
6. Deterministic computationPush exact work into code, not the model's headCh 10
7. Portability and shareabilityThe whole setup lives in the repo, so a teammate can clone itCh 9, 16

The seven pillars breakdown adds one more idea that deserves a spot of its own: the anti-hallucination contract. The most important rule for any agent handling real data is that if a tool can fetch the truth, the agent must not be allowed to make the answer up. We will return to this in Chapters 10 and 13.

Do not memorize either table. The point is that "harness" is not one blob. It is a set of distinct problems (context, memory, tools, safety, delegation, observability) that you can attack one at a time. That is exactly how the rest of this guide is organized.

← → arrow keys work too