huangjia2019/agent-design-patterns

204 stars · Last commit 2026-08-02

A 7×6 framework for agent architecture. 28 patterns, each placed at a coordinate, runnable Python code with verified engineering slices from Claude Code, Aider, OpenHands, DeerFlow. Companion to Designing AI Agents (Manning) by Jia Huang.

README preview

# Agent Design Patterns

> **A 7×6 framework for agent architecture. 28 patterns, each placed at a coordinate, each with runnable code and a verified engineering slice from real production codebases.**

*The model spends. The harness budgets. This repo is the vocabulary you can put in your project tomorrow.*

[简体中文 README](README.zh-CN.md) · [**Pattern Docs**](https://adpsagent.com/zh/patterns/) · [**Manning · *Designing AI Agents***](https://hubs.la/Q04hCsH10) · [Paper · arXiv:2605.13850](https://arxiv.org/abs/2605.13850) · [极客时间专栏](https://time.geekbang.org/) · [Newsletter](https://agentpatterns.substack.com) · [Author site](https://kage-ai.com)

> **📖 Browse the full pattern documentation** — every pattern with its whitepaper, organized by cognitive function, with a left-rail index: **[adpsagent.com/zh/patterns](https://adpsagent.com/zh/patterns/)**. Enterprise case studies (蓝皮书) live at [adpsagent.com/zh/cases](https://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**](https://github.com/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

View full repository on GitHub →