Agent Design Patterns

Agent Design Patterns

Reference code and editable ADPS documentation for agent architecture: 27 core patterns, extension patterns, and three cross-cutting engineering concerns.

English documents · 中文文档 · Review and publishing

Code and documentation now share this repository. Propose article changes through a PR, or comment on a passage on the website. Accepted source revisions are published separately; each website article links to the exact source commit it displays.

简体中文 README · Pattern Docs · Manning · *Designing AI Agents* · Paper · arXiv:2605.13850 · 极客时间专栏 · Newsletter · Author site
📖 Browse the full pattern documentation — every pattern with its whitepaper, organized by cognitive function, with a left-rail index: adpsagent.com/zh/patterns. Enterprise case studies (蓝皮书) live at adpsagent.com/zh/cases.
Looking for the full Argus running example as one evolving
codebase, organized by book chapter? See the companion repo
huangjia2019/designing-ai-agents
— Argus grows module by module from Ch2 to Ch10, with each chapter's
patterns/ + argus/ side by side. That repo follows the book's
narrative; this repo is the standalone pattern catalog.

The book

*Designing AI Agents* — the design-pattern catalogue for production AI agents. (Manning)

The framework comes from a paper

The two-axis framework, the 27 named patterns, and the five
pattern-selection laws are introduced in A Two-Dimensional Framework
for AI Agent Design Patterns: Cognitive Function × Execution
Topology (Huang & Zhou,
arXiv:2605.13850). This repository is the runnable companion to the
paper.

Why this exists

Most "agent architecture" guides give you a flat list — Reflection, ReAct,
Multi-Agent, Tree of Thoughts, Reflexive Metacognitive, and so on. A flat
list answers *what patterns exist*. It does…