Guide

Agent Design Patterns

Agent design patterns treat the agent loop as a software-engineering primitive: an observe→reason→act cycle wrapped in tools, memory, supervision, and budgets. ReAct, plan-and-execute, augmented LLM, decision log, agent resumption.

Step back from the AI hype and "agent" becomes a software primitive: a thing that observes, decides what to do next, acts, and remembers. Agent design patterns are what you write down once you accept that primitive and start designing around it — how the loop terminates, how a plan is revised when reality contradicts it, how state survives a crash, how a peer agent receives a half-finished task without re-doing it.

These patterns are deliberately about the *shape* of the loop, not the model that drives it. The same patterns held in earlier agent literature (BDI, RL, dialogue systems), and they hold now with augmented LLMs at the centre. The catalog inherits the GoF discipline: intent, context, problem, forces, therefore, solution, consequences, constrains, related[] — typed edges to other patterns.

The selection below is the agent-loop spine: ReAct (observe-think-act), plan-and-execute (separate planning from execution), augmented LLM (model + retrieval + tools + memory), reflection (self-critique), decision log (auditable trail), supervisor (a parent that can stop the child), handoff (transfer control), agent resumption (survive a crash). For adjacent framings see the related guides.

Field-tested patterns to start with

  • ReActInterleave a single thought, a single tool call, and a single observation per step so the agent reasons over fresh evidence.
  • Plan-and-ExecutePlan all the steps once with a strong model, then execute each step with a cheaper model under the plan.
  • Augmented LLMBuild the foundational agent block as an LLM augmented with retrieval, tools, and memory that the model actively chooses to use, rather than a bare-model call.
  • Tool UseLet the LLM produce typed calls against an external toolkit instead of producing free-form text the surrounding system has to parse.
  • ReflectionHave the model review its own output and produce a revised version in one or more passes.
  • Decision LogPersist the agent's reasoning trace alongside its actions so post-hoc review can explain why.
  • SupervisorPlace a coordinating agent above a set of specialised agents and route work to them.
  • HandoffTransfer the active conversation from one agent to another, carrying context across the switch.
  • Agent ResumptionPersist agent execution state so a long-running run survives restarts, deploys, or user disconnects.
  • Agent-as-a-JudgeEvaluate an agent's full trajectory (steps, tool calls, intermediate states) by another agent rather than scoring only the final output.
  • Subagent IsolationRun subagents in isolated workspaces so their writes do not collide and parallelism is safe.
  • Step BudgetCap the number of tool calls or loop iterations the agent is allowed within a single request.

Recommended reading

Or open the full contents for all 421 patterns in 14 books.

Related guides

  • LLM Agent Design PatternsA GoF-formal catalog of LLM agent design patterns: ReAct, tool use, plan-and-execute, reflection, step budget, and more. Each pattern decom…
  • Agentic Design PatternsA GoF-formal catalog of agentic design patterns — named, reusable shapes for building autonomous AI agents: agent loops, tool use, planning…
  • Agentic AI Design PatternsAgentic AI design patterns for systems already in production — what to ship, what to observe, what to budget, what to gate. Augmented LLM,…
  • AI Agent Design PatternsHow to build an AI agent: the named shapes you reach for during design and implementation — reasoning (ReAct, plan-and-execute, reflection)…
  • Agentic PatternsA complete pattern language for agentic systems, organised in Alexander-style books across reasoning, planning, tool use, retrieval, verifi…
  • Agentic AI ArchitectureHow to structure agentic AI: the architectural patterns that hold an LLM-powered system together. Supervisor, orchestrator-workers, augment…
  • RAG Agent PatternsPatterns for building retrieval-augmented generation agents: naive RAG, agentic RAG, hybrid search, cross-encoder reranking, contextual ret…
  • Multi-Agent PatternsPatterns for coordinating multiple LLM agents: supervisor, orchestrator-workers, handoff, debate, hierarchical agents, swarm, role assignme…
  • AI Agent Safety PatternsSafety patterns for LLM agents: step budget, kill switch, constitutional charter, approval queue, sandbox isolation, input/output guardrail…

About this catalog

The Agent Patterns Catalog is an open, GoF-formal reference of 421 design patterns for building LLM agents. Each pattern is decomposed in the manner of Christopher Alexander (1977) and the Gang of Four (1994). Source of truth at github.com/agentpatternscatalog/patterns — CC BY 4.0.

Open the contents