Guide

AI Agent Design Patterns

How to build an AI agent: the named shapes you reach for during design and implementation — reasoning (ReAct, plan-and-execute, reflection), acting on the world (tool use, agentic RAG, handoff), and keeping the loop safe enough to ship (step budget, kill switch).

An AI agent is an LLM wrapped in a decision loop: observe, reason, act, repeat. AI agent design patterns name the parts of that loop and the recurring shapes around it — how to reason without runaway cost (ReAct, plan-and-execute, reflection), how to act on the world without losing accountability (tool use, agentic RAG, handoff), and how to keep the loop safe enough to ship (step budget, kill switch, human-in-the-loop).

These patterns are not framework features. They are commitments about behaviour that can be defended on specific grounds — and refused on specific grounds. The catalog decomposes each pattern in the manner of Christopher Alexander (1977) and the Gang of Four (1994), with the LLM-era constrains slot (the hard prohibition the agent must not violate) added so each pattern keeps its shape under a generator that can argue.

The selection below is a practical starter set for "how do I build an AI agent?". Open the related guides for adjacent framings: the broader agentic design pattern language, agentic AI architecture, multi-agent coordination, RAG, and the safety stack.

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.
  • Tool UseLet the LLM produce typed calls against an external toolkit instead of producing free-form text the surrounding system has to parse.
  • Plan-and-ExecutePlan all the steps once with a strong model, then execute each step with a cheaper model under the plan.
  • ReflectionHave the model review its own output and produce a revised version in one or more passes.
  • 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.
  • Agentic RAGReplace static retrieve-then-generate with autonomous agents that plan, choose sources, retrieve iteratively, reflect, and re-query.
  • 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.
  • Step BudgetCap the number of tool calls or loop iterations the agent is allowed within a single request.
  • Kill SwitchProvide an out-of-band control plane to halt running agent instances without redeploy.
  • Human-in-the-LoopRequire explicit human approval at defined points before the agent performs an action.
  • Decision LogPersist the agent's reasoning trace alongside its actions so post-hoc review can explain why.

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,…
  • Agent Design PatternsAgent design patterns treat the agent loop as a software-engineering primitive: an observe→reason→act cycle wrapped in tools, memory, super…
  • 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