Agent Architecture Introduction 12 of 12 steps written

Who asks whom, in what order, and what has to be true before that arrangement is worth building

Twelve steps, four parts, three runnable quarters — six shapes, eight decisions, and an exit at the fourth.

Introduction

You are about to choose a shape for an agent system — one agent with tools, a pipeline, a router, a planner, a checker, a fan-out — and you have read six articles each recommending a different one with equal confidence.

All six can be right. This volume runs the same job through six shapes on three workloads, and gets three different cheapest shapes with no shape winning twice. That is a fact about workloads, not about architectures.

What a shape is

Agent architecture is the practice of deciding who asks whom, in what order, and what has to be true before that arrangement is worth building.

The six shapes here run the same job, on the same input, against the same 9 checks, using the same model with the same instructions. The only thing that differs is the arrangement — and that difference is worth up to a factor of four in cost and the difference between a right and a wrong answer.

why it is not the shape
the modelhold it fixed and the six shapes still cost different amounts. Every figure here is measured with one scripted model, so the arrangement is the only variable
the promptthe wording is the same in every shape. What differs is how many times it is sent and what is in scope each time
the toolsall six read the same files and look rates up in the same table. Reading a file is free; asking about it is not
the frameworka framework is an implementation of a shape, usually of one shape. Choosing a framework before choosing a shape is choosing the answer before the question

The result, up front

quarterlineskinds of problemcheapest shapecost
A · quiet222fixed stages tied with split and rejoin2.10
B · messy1406do, then check23.42
C · busy40002sort first, then handle45.19
No shape appears twice, and two of the six never win anywhere. One is the dearest shape on one quarter and the cheapest on another. The question "which agent architecture should I use" has no answer that is a property of the architectures.
And on the largest workload, every check passes and the form is wrong. All 9 checks pass on five of the six shapes, and one box is wrong on every one of them — traced to one word in one line, by a mechanism no check could have caught.

The three things that cost money

Three things, and only three. Reading files, looking rates up, adding the totals and running the checks are arithmetic and free — so a shape is priced by what it asks, not by what it does.

what costs moneywhy
ask the model a questiontokens, priced per call and per word
send one thing to a personsomebody's attention, priced per item
get an answer wrongwhatever a wrong answer costs you, which only you can supply
everything elsefree. Reading, looking up, adding, sorting, comparing, and running every check

Eight decisions, and an exit at the fourth

The first four come before any shape is chosen. None of them mentions a shape and all four are answerable in an afternoon. Decision 4 is an exit, and on one of the three quarters it fires.

#the decisionwhat answering it costs
1what proves the work is rightwriting the checks
2what must a person decide, whatever you buildnaming the cases
3how many different kinds of work are actually in herecounting them
4can the simplest shape do itrunning it once
5one fixed order, or kinds that need different handlinga route per kind
6does anything have to be planned before it can be donea plan first
7is a wrong answer expensive enough to pay for a second opiniona second look
8is there enough work to split, and what does rejoining costbatches

Is this for you?

if…then
you are choosing between a pipeline and a routerstep 6 — but run step 4 first, because it may not matter
your input is large, so you are reaching for a routerstep 9. Volume and variety are different properties and choose different shapes
your checks all pass and you want to know if that means anythingstep 10. On one quarter it means nothing at all
somebody asked you to justify a second-opinion stepstep 7, and then the premise sweep in step 11
you have picked a framework alreadystep 1. A framework is an implementation of one shape

The three quarters

Same shop, same rules file, same checks, same six shapes. Only the lines differ — and the property that decides the winner is not size.

quarterlineskinds of problemchecks that failwhat it teaches
A · quiet2220the exit fires
B · messy14066variety, not volume
C · busy400020volume, and a wrong answer nothing can see

The large quarter has fewer kinds of problem than the middle one, deliberately. Give them the same kinds and one of them is waste: one is about volume, the other about variety, and they have different winners for that reason.

How to read the source labels

labelmeans
conceptargued from first principles, quotes nothing from a lab
measureda lab compares configurations and reports the difference
hands-onyou run it on your own material
Nothing here is a benchmark. Three quarters of one shop, one scripted model, and a cost model in which asking about twenty-five things at once costs what asking about one costs. That last assumption is what makes one of the six shapes unable to win, and step 12 says so. Every finding also depends on there being a way to check the work at all.
Build state: 12 of 12 steps written.