Topic · 9 articles

Architecture

November 20265

  • Durable Execution for Agents: Surviving Restarts Mid-Task

    Checkpointing, idempotency keys and replay — what Temporal-style durability gives an agent that a retry loop cannot. The determinism rules that make ordinary Python illegal inside a workflow, why uuid4() is the wrong idempotency key, the 51,200-event ceiling that collides with your context budget, and the framework defaults that quietly hand the guarantee back.

    Series · Part 2610 min readAI EngineeringAI AgentsReliability
  • Human-in-the-Loop: Designing the Approval Boundary

    Which actions need a human, how to pause a running agent without losing its state, and why confirming everything trains people to click yes. The approval boundary is a claim about reversibility and blast radius, and the blast radius lives in the arguments, not the tool name. Includes the resume bug every framework has, and the aviation data that explains why your gate stops working in week three.

    Series · Part 259 min readAI EngineeringAI AgentsArchitecture
  • Handoffs: Passing Work Between Agents Without Losing State

    A handoff is not a message forward. Control does not return, so anything the caller knew and did not write down is gone the moment the transfer lands. OpenAI ships a filter to cut the trace, LangChain tells you to forward exactly two messages, and Google ADK isolates each subagent in its own session branch — three frameworks admitting the same thing. What travels across a handoff, and the three things that must never.

    Series · Part 229 min readAI EngineeringMulti-AgentArchitecture
  • Supervisor, Pipeline, or Swarm: Multi-Agent Topologies Compared

    Anthropic measured its orchestrator-worker research system beating a single agent by 90.2%, while burning roughly 15x the tokens of a chat. Cognition spent a year telling people not to build multi-agent systems, then shipped one under a single rule: writes stay single-threaded. Three topologies, the failure mode each one owns, and the one you should default to.

    Series · Part 2110 min readAI EngineeringMulti-AgentArchitecture
  • Knowledge Graphs for Agent Grounding: Worth the Build?

    Microsoft measured GraphRAG beating vector RAG on 72-83% of sense-making questions. Microsoft then shipped LazyGraphRAG, which indexes at 0.1% of that cost. When the vendor builds the cheap version, the expensive version's price was the finding. Here is where a graph actually earns its keep, and the hybrid most teams land on instead.

    Series · Part 2010 min readAI EngineeringRAGKnowledge Graphs

September 20264

  • RAG or Tool Calling? Stop Retrieving What You Could Query

    Vector search over data you could have queried with SQL is the most common architecture smell in agent systems. It is slower, less accurate, more expensive to maintain, and it fails in a way that is hard to detect. Here is the decision rule.

    Series · Part 169 min readAI EngineeringRAGAI Agents
  • Seven MCP Server Design Mistakes (And the Fixes)

    A server that works in the inspector and fails in practice usually fails for one of seven reasons. None of them are protocol bugs — they are interface decisions that only show up once a model, rather than a developer, is doing the calling.

    Series · Part 139 min readAI EngineeringMCPArchitecture
  • OpenAI Agents SDK vs LangGraph vs Google ADK: Choosing by Constraint

    Feature tables do not help, because all three do the same core thing. What separates them is four constraints — where state lives, where it deploys, what you can see when it breaks, and what your team already knows. Pick on those and the choice makes itself.

    Series · Part 1010 min readAI EngineeringAI AgentsFrameworks
  • When Not to Build an Agent (A Decision Tree)

    A large share of agent projects should have been a workflow, a retrieval endpoint, or a scheduled job. The tell is usually visible in week one and ignored until month three. Here is how to check before you commit a quarter to it.

    Series · Part 67 min readAI EngineeringAI AgentsArchitecture