Operating a Fleet of Coding Agents

Context Is the Budget

This chapter was written by an orchestrator that never read the files it is built from.

That's the literal truth, and it's the cleanest demonstration of the chapter's thesis I can offer. The evidence base for this book is eleven sessions of logs, tens of thousands of words of dense, dated primary material. I did not read most of it. Cheap subagents read it; they were dispatched, one per source, to pull the exact numbers and quotes, and they returned a few hundred words of distilled findings each. The raw bytes, the logs, the transcripts, the configuration dumps, never entered the context of the thing doing the authoring. The expensive reasoning that wrote these sentences spent its budget on judgment and synthesis, and outsourced every act of reading to a model a fraction of its cost. The book about verifying your environment was itself produced under a strict context budget, and that budget shaped every move I made writing it.

So before the last chapter, the resource that has been running silently underneath all the others: context is not free working memory. It's a budget, finite, depleting, and shared, and operating a fleet means spending it on purpose, because the alternative is letting it get spent for you by whatever noise a tool happened to return.

The byte that costs you the next decision

Here's the mechanic that makes context a budget and not a scratchpad. Every byte a tool returns enters the model's context and stays there, consuming attention for the rest of the session. A verbose command output, a giant JSON blob, a file you read in full when you needed three lines of it, each one is not free. It's working memory you've now committed, and the model's capacity to reason well degrades as that memory fills with material that didn't earn its place. The cost is not the dollars of the tokens. The cost is the judgment you have left after the noise crowds in.

That reframes the operator's job in a way that connects every chapter of this book. Each of the four moves, the instruction file, the guard, the eval, the knowledge substrate, is ultimately an act of putting the right information in front of judgment at the right moment. And every one of them runs into the same ceiling: the agent does not have infinite room to attend. The instruction file from Chapter 2 had to be a map and not an encyclopedia for exactly this reason: a bloated file doesn't just age badly, it spends budget, burying the three rules that matter under ninety that don't. Chapter 11 is that same insight pulled up from the file to the whole session: the scarce thing is not storage, it is attention, and attention is the budget you are always spending.

Delegation is the relief valve

If context is the budget, delegation is the structural way you stop blowing it.

The operating contract I ran this entire book-writing campaign under says it in one line: the expensive model's tokens are the scarce resource; spend them only on the irreducible reasoning the session exists for, the synthesis, the decision, the authoring, the judgment, and delegate everything else to the cheapest model that suffices. Reading, searching, inventory, first drafts: hand them to a small model. That is not, at root, a cost-savings trick, though it saves cost. It is a context-preservation architecture. The reason to send the reading to a subagent is not only that the subagent is cheaper; it's that if I had done the reading myself, the reading would have evicted the authoring. The forty thousand words of source logs would have filled the budget that the chapters needed, and the synthesis would've been worse for it. Delegation keeps the expensive context clean for the one thing only it can do.

This is the orchestrate-don't-labor pattern, and it is the relief valve that makes a fleet possible at all. One operator can run far more agent surface than one operator can hold in their own head precisely by not holding it, by spending their own scarce attention on the judgment and pushing the labor out to cheap models whose filled-up context is disposable. The lead reasons; the workers read; the workers' raw bytes die with the workers. The fleet scales on the difference.

More context is not better context

The counter-intuition, and it's a real one, is that the answer to "is the agent doing a worse job?" is very often give it less, not more.

The instinct runs the other way. When an agent gets something wrong, the reflex is to feed it more: more documentation, more examples, more of the codebase, on the theory that it failed because it didn't have enough. But there is a measured finding, reported in at least one published evaluation, that cuts directly against the reflex: adding context made code review worse. The model with more material to attend to did a worse job of the review than the model with less, not because the extra context was wrong, but because it was noise relative to the task, and noise spends the attention the task needed. The rule that falls out is the one I now operate by: smallest complete bundle, not maximum bundle. Give the agent exactly what the task requires and not one byte more, because every byte past "complete" is a byte competing with the signal.

It's the same subtraction I keep arriving at from every direction: the map that isn't an encyclopedia, the guard that shouldn't enumerate, the knowledge index that got better when I cut the corpus and the "intelligence." Across four layers, the instruction file, the guard, the retrieval index, the session context, the lesson keeps rhyming: more is not better, complete-and-minimal is better, and the discipline is subtraction. This book was written under tooling built on exactly that principle: a context-mode layer that runs analysis in a sandbox and lets only the derived answer back into the conversation, so the raw output stays out of the budget: think in code, don't read the data in. The footprint levers are all one principle at different scales: scope the tool surface, suppress the skills you aren't using, load the rules only on the file types they apply to. Keep out of the budget everything that hasn't earned its seat.

The ledger I haven't filled in

Now I have to do to this chapter exactly what this book demands I do to every control I build: turn the suspicion on it and report honestly what I find. And what I find is that it's the one chapter whose backing is doctrine, not data.

I believe the argument. Context is finite; delegation preserves it; smallest-complete-bundle beats maximum; this session is a live instance of all three. But belief and a live anecdote are not measurement, and the discipline I'd preach is precisely the one I can't yet practice here. The honest version of "manage your context budget" is: separate cost-per-session from cost-per-outcome. Track not just what a session spent but what it produced per unit spent, so you can tell the delegation that genuinely bought you better work from the delegation that just moved tokens around and felt productive. I do not have that ledger. I have the operating contract, I have this book written cheaply, I have the published finding pointing the right way, and I do not have a month of telemetry tying token spend to graded outcome quality across enough sessions to separate signal from noise. So by the standard of Chapter 5, every cost intuition in this chapter is an unverified measurement; by the standard of Chapter 10, an argument with no instrument behind it is a check that cannot fire.

I'm telling you that before you catch me, because that is the whole book. The telemetry that would earn this chapter is specific and buildable: per-session output-token spend, tagged to a graded outcome, accumulated until the trend is real and not a story. Until that ledger exists, take this chapter as the hypothesis it is, the shape of the answer, with the proof honestly marked absent. The other ten chapters earned their place on reproduced, dated evidence; this one earns its place by refusing to invent the evidence it lacks, which is the only move consistent with everything that came before it.

Context is the budget you spend to operate a fleet, and like every other resource in this book it'll lie to you if you stop watching it. "More context is better" is the lie. "I'm sure the delegation helped" is the unmeasured claim. The honest operator spends context the way they'd spend money they're accountable for: deliberately, on the irreducible, with the cheap labor outsourced, and keeps the receipt. I've shown you the spending discipline and I've shown you the empty line in the ledger where the receipt should be. Filling it in is the next thing I owe this argument, and saying so is the argument, turned on itself one more time.