Martin Fowler
Read post

The Orchestrator's Tax

A developer reflects on a real Claude Code session involving four subagents on a .NET codebase refactor, discovering that the biggest cost wasn't parallelism overhead but orchestrator context pollution. When status-check tool calls pulled full raw transcripts (tens of thousands of tokens) into the main thread, those tokens persisted across every subsequent turn, degrading the orchestrator's working memory. The author introduces the concept of 'cognitive locality' — tasks sharing the same mental model should stay together rather than be split across agents — and argues that subagents' primary value is keeping noisy intermediate reasoning out of the orchestrator's context, not just saving wall-clock time. The post concludes with four concrete CLAUDE.md rules (limit wave size, avoid transcript polling, ban concurrent repo-wide git ops, treat overlapping file ownership as a consolidation signal) and a heuristic for when to add standing instructions versus when a single clarifying fact suffices.

    #ai-agents#claude-code#context-engineering
Jul 28•14m read time•From martinfowler.com
Post cover image
Table of contents
The Incident Was Not Really About ParallelismThe Costs Were Not All the SameThe Scarce Resource Is the Orchestrator's Working MemoryCognitive Locality Changes What Parallelism Is ForTurning a Session into Standing RulesThe Next Mistake Would Have Been More GovernanceWhere This Leaves Me
206 Impressions
Martin Fowler's image
Martin Fowler

MAFO (Mobile App Development Forum) is a community platform for mobile app developers, offering disc...

120 Followers

•

313 Upvotes

Would you recommend this post?

Copy link
WhatsApp
Facebook
X
New Squad
  • © 2026 Daily Dev Ltd.
  • Guidelines
  • Explore
  • Tags
  • Sources
  • Squads
  • Leaderboard