How To Read This Book
This book has two jobs.
First, it makes an argument: agentic systems need architecture before autonomy. Second, it gives you a pattern reference you can use during design work.
You do not need to read every chapter in order. But do read the selection chapters before adding loops, tools, memory, or multiple agents to a system.
Choose Your Path
Use the path that matches the decision in front of you.
| If you are… | Start with | Goal |
|---|---|---|
| New to agentic systems | First-Time Path | Learn the core vocabulary and boundaries. |
| Designing or reviewing a system | Builder Path | Choose patterns, controls, and production responsibilities. |
| Running code | Lab Path | Build small examples and connect them back to architecture. |
| Looking for product-shaped examples | Capstone Path | See patterns combined into complete systems. |
| Learning visually or onboarding a team | Visual Architecture Route | Use diagrams to understand boundaries, ownership, and production controls. |
| Checking one pattern during work | Reference Path | Scan use cases, failure modes, evals, and production checklists. |
| Choosing a section to read | Logical Groups | Understand why the book is grouped this way and where each group pays off. |
| Stuck on terminology | Glossary and Acronyms | Decode agent, eval, protocol, security, and production terms. |
| Preparing a release | 10/10 Production Gate | Check whether the system is reviewable, testable, observable, and reversible. |
The fastest useful route is not the shortest list of pages. It is the path that gets you to a design decision with enough context to avoid a bad abstraction.
Reading Path Decision Flow
The path is finished only when it produces the evidence on the right.
Time And Difficulty Guide
Use this table before choosing a route. The estimates assume a working software engineer who can skim familiar material and slow down for unfamiliar patterns, code, or production controls.
| Path | Best For | Difficulty | Time | Evidence You Should Produce |
|---|---|---|---|---|
| First-Time Path | Learning the vocabulary and boundaries. | Beginner to intermediate | 2-4 hours | A short explanation of agent, workflow, tool, state, memory, eval, and stop condition. |
| Builder Path | Designing or reviewing a real system. | Intermediate to advanced | 1-2 days | Architecture sketch, selected pattern, rejected alternatives, owners, evals, and rollback path. |
| Lab Path | Running examples and seeing implementation boundaries. | Intermediate | 1-3 days | Passing tests, trace output, missing-controls list, and one hardening task per lab. |
| Capstone Path | Comparing complete product-shaped systems. | Advanced | 4-8 hours | Gap analysis against traces, evals, ADRs, runbooks, and release controls. |
| Reference Path | Checking one pattern during design work. | Intermediate | 10-30 minutes per chapter | Fit/avoid decision, failure mode, eval case, and production checklist. |
| Release Path | Deciding whether a system can ship. | Advanced | 2-6 hours | Completed scorecard, release evidence record, known limits, and ship/no-ship decision. |
Do not optimize for speed. Optimize for evidence. A fast read that does not change the design is not useful.
Path Exit Criteria
Use these checks to decide whether a path has paid off. If you cannot answer the exit question, continue with the linked path before choosing a pattern or shipping a system.
| Path | You are done when you can… | If not, continue with… |
|---|---|---|
| First-Time Path | Explain the difference between a model call, prompt chain, workflow, single agent, and multi-agent system. | Pattern Selection and Composition |
| Builder Path | Draw the system boundary, name the owner of state, tools, memory, policy, evals, and rollback, and defend why each pattern belongs. | Reference Architecture |
| Lab Path | Run a small implementation, identify the missing production controls, and name the next hardening step. | Lab Production Readiness Checklist |
| Capstone Path | Compare a complete example with your own system and list the gaps in traces, evals, ADRs, runbooks, and rollout controls. | Capstone Projects |
| Reference Path | Decide whether the pattern fits, what it costs, how it fails, and which eval proves it works. | Choosing the Right Pattern |
| Release Path | Show evidence that the system is reviewable, testable, observable, reversible, and owned. | 10/10 Production Gate |
Do not treat a path as complete because the pages were read. Treat it as complete when it changes the design decision in front of you.
Logical Groups
The sidebar is organized as a design path, not a flat catalog.
| Group | Purpose | Read When |
|---|---|---|
| Start Here | Orient yourself, choose a reader path, and define what counts as an agent. | You are new to the book or need the shortest entry point. |
| Pattern Selection and Composition | Decide whether to use a prompt, chain, router, loop, multi-agent system, or reliability pattern. | You are choosing or reviewing an architecture. |
| Agent Runtime Foundations | Learn the core runtime primitives: single agent, loop, state, tools, and structured output. | You need the vocabulary and control boundaries. |
| Engineering Practice and Frameworks | Move from demo to engineered system with lifecycle, harnesses, framework choices, and worksheets. | You are planning implementation. |
| Evaluation, Security, and Trust | Add eval gates, threat modeling, sandboxing, and human-trust controls. | The system affects users, data, or external actions. |
| Control Loops | Add planning, reflection, evaluator-optimizer, self-improvement, and self-healing patterns. | The agent needs iterative control. |
| Context, Memory, and Knowledge | Design working sets, context packets, memory, semantic recall, RAG, and knowledge boundaries. | The system depends on evidence or remembered state. |
| Tools, Skills, and Protocols | Design tool capabilities, skills, MCP, A2A, approvals, and secure communication. | The agent needs external capabilities. |
| Multi-Agent Systems | Choose and operate topologies for delegation, supervision, debate, and parallel work. | One agent is no longer enough. |
| Systems Architecture | Compose full systems: services, RAG systems, coding agents, computer-use agents, domains, ADRs, and references. | You are designing the whole system boundary. |
| Production Runtime | Run agents with durability, observability, feedback loops, policy, budgets, events, and rollout controls. | You are preparing for production. |
| Hands-On Labs | Build the patterns in small exercises and framework tracks. | You want implementation practice. |
| Capstone Projects | Study complete product-shaped examples with traces, evals, ADRs, runbooks, and rollback. | You want to see patterns combined. |
Recommended First Pass
Start here if you want the book to read like a book, not a catalog:
- Reader: engineer or technical lead who wants the full argument.
- Outcome: understand the book’s architecture-first position before using the catalog.
- Approximate depth: medium-long; best read across multiple sessions.
- Introduction
- Logical Groups
- What Is An Agent?
- Architecture Before Autonomy
- Choosing the Right Pattern
- From Patterns To Systems
- Agent Development Lifecycle
- Agent Harnesses
- Building a Minimal Agent Runtime
- Cross-Framework Decision Matrix
- Real Framework Setup Notes
- Templates and Worksheets
- Evaluation-Driven Agent Development
- Agent Threat Model
- Tool Capability Design
- Agentic System Architecture
- Agents As Services
- Choosing Multi-Agent Topology
- Coding Agents
- Production Runtime Overview
- Deployment Walkthrough
- Capstone Projects
- Support Refund Agent Capstone
- Research RAG Agent Capstone
- Multi-Agent Delivery Workflow Capstone
- Production Evaluation Feedback Loops
- Cost Controls and Runtime Budgets
- Reference Architecture
- 10/10 Production Gate
This path gives you the thesis before the catalog details.
First-Time Path
Start here if you are new to agentic systems:
- Reader: software engineer learning the vocabulary.
- Outcome: know what makes an agent different from a model call, chain, or workflow.
- Approximate depth: short-medium; read before the labs.
- Introduction
- Logical Groups
- What Is An Agent?
- Glossary and Acronyms
- Single Agent
- Agent Loop
- Goals and State
- Tool Use
- Tool Capability Design
- Context Budgets and Working Sets
- Context Engineering
- Choosing the Right Pattern
- Hands-On Labs
This path gives you the core vocabulary before the production runtime chapters.
Builder Path
Use this path when you are designing or reviewing a system:
- Reader: builder, staff engineer, architect, reviewer, or technical lead.
- Outcome: produce a defensible design with explicit state, tools, memory, policy, evals, and runtime boundaries.
- Approximate depth: medium-long; use alongside a real design.
- Choosing the Right Pattern
- Resource-Aware Agent Design
- Agent Development Lifecycle
- Agent Harnesses
- Building a Minimal Agent Runtime
- Cross-Framework Decision Matrix
- Real Framework Setup Notes
- Templates and Worksheets
- Evaluation-Driven Agent Development
- Agent Threat Model
- Tool Capability Design
- Agent Security and Sandboxing
- Agents As Services
- Choosing Multi-Agent Topology
- Reference Architecture
- Production Runtime Overview
- Deployment Walkthrough
- Capstone Projects
- Support Refund Agent Capstone
- Research RAG Agent Capstone
- Multi-Agent Delivery Workflow Capstone
- Observability and Evals
- Production Evaluation Feedback Loops
- Cost Controls and Runtime Budgets
- 10/10 Production Gate
This path is best for architecture work, design reviews, and production readiness checks.
Lab Path
Use this path when you want to run code:
- Reader: implementation-focused engineer.
- Outcome: run small examples, inspect boundaries, and understand what must change before production.
- Approximate depth: hands-on; expect setup and debugging time.
- Lab Framework and Language Matrix
- Real Framework Setup Notes
- Lab Production Readiness Checklist
- Deployment Walkthrough
- Lab 01 - Tool-Using Agent
- Lab 02 - Agent Loop and Planning
- Lab 03 - Agentic RAG
- Lab 04 - A2A Communication
- Lab 05 - Multi-Agent Supervisor
- Lab 06 - Observability and Evals
- Lab 07 - Mastra Runtime Packaging
- Lab 08 - CrewAI Flows and Crews
- From-Scratch Mini-Framework Track
- Lab 09 - Minimal Agent Loop
- Lab 10 - Tool Registry and Policy Gate
- Lab 11 - Context, Memory, Trace, and Evals
- Lab 12 - LangGraph State Graph
- Lab 13 - AutoGen Transcript Evals
- Capstone Projects
- Support Refund Agent Capstone
- Research RAG Agent Capstone
- Multi-Agent Delivery Workflow Capstone
- 10/10 Production Gate
Each lab links back to the pattern chapters and downloadable source bundles. The labs intentionally move between Python, TypeScript, framework-neutral code, LangChain/LangGraph-style retrieval, LangGraph-style state graphs, AutoGen-style supervision and transcript evals, Mastra-style runtime packaging, CrewAI-style flow orchestration, protocol-first A2A code, and test-based evals so you can see the architecture beneath the API.
Capstone Path
Use this path when you want complete product-shaped examples:
- Reader: engineer who has finished the core chapters or labs.
- Outcome: connect patterns, traces, evals, ADRs, runbooks, and rollout controls into complete systems.
- Approximate depth: medium; best used as design-review material.
- Capstone Projects
- Support Refund Agent Capstone
- Research RAG Agent Capstone
- Multi-Agent Delivery Workflow Capstone
- Deployment Walkthrough
- Templates and Worksheets
This path is best after the labs. It shows how patterns, frameworks, evals, traces, ADRs, and runbooks fit together.
Reference Path
Use the sidebar or search when you need a specific pattern. Each generated pattern chapter follows the same structure:
- Reader: engineer making a local pattern choice.
- Outcome: decide whether a pattern fits, what it costs, and how to test it.
- Approximate depth: fast lookup; jump between related chapters.
Pattern pages include:
- when to use it
- when to avoid it
- architecture
- system shape
- core protocol
- implementation notes
- failure modes
- evaluation strategy
- production checklist
- source code and downloads
The repeated structure makes chapters easy to scan during design work. Do not read those pages like a novel. Use the authored chapters for the argument and the pattern pages for decisions.