What 20 Years of API Design Taught Me About Agents
We spent two decades making APIs easy for developers to discover and consume. Agents change the consumer, and the old lessons apply in a stricter form.
The Agentic Architect with Hugo Guerrero
Architecture patterns for agentic systems people can trust.
Notes for the people building the capabilities, context, controls, and operating models behind useful AI agents.
Latest articles
View all
Your Agent Shouldn't Need Your Laptop
Proactive agents need integrations, live events, and compute that stays reachable. A better sandbox on a Mac mini is not production. The real requirement is an agent that is always available, not always running.
A Simple Agent Request Is Actually a Distributed System
Ask an agent for the weather and ten messages cross five components. Agentic AI is not only an AI problem. It is a distributed-systems problem, and it needs distributed-systems discipline.
Start Here: Six Essays on the Architecture Beneath AI Agents
A reading guide to The Agentic Architect: six essays on the APIs, events, context, memory, and control beneath useful, trustworthy AI agents, in the order that makes the argument easiest to follow.
AGNTCon + MCPCon San Jose: MCP Grows Up, and So Do the Attackers
My takeaways from two days at AGNTCon + MCPCon North America: MCP tasks and events, skills over MCP, agent identity, and what Solo.io announced, including Agent Shield, standalone agentgateway, and Agent Substrate.
Events Are APIs Too
Event streams are business products, not an ungoverned firehose. Treating them like APIs makes real-time context usable for people, applications, and agents.
Five themes, one thesis
All topicsAgent quality is bounded by the architecture around the model. Each theme covers one part of it.
API Foundation
The contracts and capabilities agents inherit: API design, discoverability, and outside-in architecture.
3 articlesContext Economy
How context is assembled, moved, and governed: MCP, tools, retrieval, and the paths data takes.
3 articlesAgentic Infrastructure
The connectivity layer around agents: gateways, registries, servers, and the controls that govern them.
3 articlesAgentic Reliability
Making agent behavior dependable: deterministic boundaries, state, history, and evidence.
1 articleEvent-Driven Agents
Real-time context for agents: events as products, streams as memory, and contracts for change.
1 article
Start here
From Pong to Minecraft: How GenAI Is Redefining the User Experience
Generative AI shifts enterprise software from predefined workflows to intent-driven experiences—and makes architecture the foundation of UX.
Read the essay