AI Architecture & System Design
Cross-cutting patterns and system design, for Principal & Staff Engineers (L6/L7)
This book assumes you can already build, evaluate, and run an agent — see Production Agent Systems first. If this were a book, this page is the table of contents. It is organized as a learning journey — from the pattern catalog that formalizes what earlier books introduced in passing, through full system-design case studies grounded in real production agent products. Each chapter links out to the framework, platform, and SRE notes that already exist elsewhere in this wiki instead of duplicating them. Unwritten chapters are listed as stub rows, not empty files.
Parts
00 — AI Architecture Patterns
The cross-cutting pattern catalog. Two of these chapters formalize patterns already introduced in context in Building & Evaluating Agents’ Parts 00–01 — they cross-reference back rather than re-teaching from scratch, and are the single canonical source for each pattern’s full treatment; every other chapter that mentions Router Pattern or Planner–Executor Pattern in passing links back here.
- Chapter 1. Architectural Thinking — (stub) — How to evaluate an agentic architecture pattern against determinism, cost, latency, and blast-radius tradeoffs rather than picking the newest framework default.
- Chapter 2. Planner–Executor Pattern — The canonical treatment. Formalizes the planner–executor pattern introduced in Building Single-Agent Systems as a reusable pattern, with applicability criteria and trade-offs against the rest of this catalog.
- Chapter 3. Supervisor Pattern — (stub) — Formalizes the supervisor pattern introduced in Multi-Agent Systems, covering when a central supervisor outperforms peer-to-peer coordination and where it bottlenecks.
- Chapter 4. Orchestrator–Worker Pattern — (stub) — Fan-out/fan-in task decomposition, worker failure isolation, partial-result aggregation, and when it beats a supervisor-style hierarchy.
- Chapter 5. Router Pattern — The canonical treatment. Formalizes the router pattern introduced in Building Single-Agent Systems, covering intent classification and confidence-based fallback.
- Chapter 6. Blackboard Pattern — (stub) — A shared, structured workspace multiple specialist agents read and write to opportunistically, versus explicit message-passing.
- Chapter 7. Event-Driven Pattern — (stub) — Building agent systems on an event bus — event schema design, at-least-once delivery, idempotent reactions to replayed events.
- Chapter 8. Memory-Centric Pattern — (stub) — Architectures where long-term/episodic memory, not the planner, is the primary coordination substrate.
- Chapter 9. Human Approval Pattern — (stub) — Designing human-in-the-loop checkpoints for high-risk actions without becoming a rubber-stamp bottleneck.
- Chapter 10. Agent Mesh Pattern — (stub) — A decentralized mesh of peer agents that discover and negotiate directly, contrasted with centralized orchestrator/supervisor patterns.
- Chapter 11. Pattern Selection Framework — (stub) — A scorecard across coordination overhead, failure isolation, latency, and observability for choosing among the patterns in this catalog.
01 — Enterprise AI System Design
Full system-design case studies at the depth an L6/L7 loop expects, closing with architectural walkthroughs of real production agent products — grounded in their public engineering writing, not speculation about internals no one has disclosed.
- Chapter 1. AI Copilot Architecture — (stub) — Reference design for an in-product AI copilot — context assembly, streaming responses, scoped guardrails.
- Chapter 2. Coding Agent Platforms — (stub) — Codebase indexing, sandboxed execution, and diff review workflow, at L6/L7 interview depth.
- Chapter 3. Research Agents — (stub) — An agent that plans multi-step web/document retrieval, cites sources, and self-critiques for completeness.
- Chapter 4. Customer Support Agents — (stub) — Ticket triage, knowledge-base grounding, human escalation, and the metrics (deflection rate, CSAT) that define success.
- Chapter 5. Enterprise Knowledge Assistants — (stub) — An enterprise-wide knowledge assistant over heterogeneous internal sources, with access-control-aware retrieval.
- Chapter 6. Autonomous Operations Agents — (stub) — Agents that take autonomous remediation actions, and the safety envelope (dry-run, blast-radius limits, auto-rollback) required before granting write access.
- Chapter 7. AI SRE Platforms — (stub) — Alert ingestion, correlation, root-cause hypothesis generation, and runbook execution — the natural extension of Build an AI SRE Assistant (Part 00 of Agentic AI: Projects & Engineering Mastery) to platform scale.
- Chapter 8. AI Platform Architecture — (stub) — Ties together the gateway, registry, and multi-model infrastructure from Part 04 of Production Agent Systems into a single architecture-review-ready diagram.
- Chapter 9. Global AI Infrastructure — (stub) — Multi-region deployment — data residency, cross-region model failover, latency budgets.
- Chapter 10. Cursor: Architecture Case Study — An external, engineering-blog-grounded analysis of Cursor’s likely architecture — codebase indexing, inline edit prediction, and agent-mode tool use.
- Chapter 11. Claude Code: Architecture Case Study — An external, documentation-grounded analysis of Claude Code’s architecture — the agentic coding loop, tool permissions model, and subagent/orchestration design.
- Chapter 12. GitHub Copilot: Architecture Case Study — An external, engineering-blog-grounded analysis of GitHub Copilot’s evolution from inline completion to an agentic coding platform, including its CI/CD-triggered coding agent (see Agentic AI Engineering, Part 04, Chapter 13).
- Chapter 13. Perplexity: Architecture Case Study — An external, engineering-blog-grounded analysis of Perplexity’s real-time research-agent architecture — retrieval, citation grounding, and answer synthesis at low latency.
Metadata
| Author | Amit Singh |
| Scope | ai-architecture-and-system-design |
Local graph
Linked from 10 notes
Notes — Library Index
The front page of the notebook — every book-shaped domain, the applied Projects and flat Inbox folders, and how they cross-link into one wiki instead of duplicating content across each other.
Agentic AI: Projects & Engineering Mastery
A book-shaped table of contents for Agentic AI: Projects & Engineering Mastery: hands-on practitioner builds, Principal/Staff-level technical leadership, and the lookup appendices and vendor/framework reference notes for the whole series. Book 6 of the AI Systems Engineering series.
2. Planner–Executor Pattern
Formalizes the planner–executor pattern — a planning component that decomposes a goal into a full upfront plan, and a separate executor that carries out each step — with applicability criteria, concrete failure modes, and how it composes with the rest of the pattern catalog.
5. Router Pattern
The canonical treatment of the router pattern -- classifying an incoming request and dispatching it to exactly one specialized handler, tool, or sub-agent -- covering the three real ways to build the classification step, confidence-based fallback, and the structural line that separates a router from a supervisor.
10. Cursor: Architecture Case Study
An external, engineering-blog-grounded analysis of Cursor's likely architecture — Merkle-tree-synced codebase indexing, the Tab fast path for inline edit prediction, and the agent-mode tool-calling loop for multi-file changes — read as public inference, not disclosed internals.
11. Claude Code: Architecture Case Study
A documentation-grounded analysis of Claude Code's architecture — the gather/act/verify agentic loop against a real filesystem and shell, the allow/deny/ask tool-permission model, and subagent delegation with isolated context — distinguishing Anthropic's own documented mechanics from reasonable architectural inference.
12. GitHub Copilot: Architecture Case Study
An external, engineering-blog-grounded analysis of GitHub Copilot's evolution from a low-latency inline completion service into an asynchronous, multi-model coding agent platform — and why the safety envelope changes shape along with it.
13. Perplexity: Architecture Case Study
An external, engineering-blog-grounded analysis of Perplexity's real-time research-agent architecture -- live web retrieval instead of a static corpus, citation grounding as a hard output constraint, and answer synthesis under a tight latency budget.
AI & LLM Foundations
A book-shaped table of contents for AI & LLM Foundations: the pre-agentic substrate — symbolic AI through transformers, tokens, embeddings, attention, foundation models, and turning a raw LLM API into a dependable application component. Book 1 of the AI Systems Engineering series.
5. Agent Negotiation
Covers how agents with different objectives or partial information reach agreement on a shared action, including bidding and argumentation-based negotiation protocols.
Related notes
Observability Engineering
A book-shaped table of contents for observability engineering: foundations through architecture, metrics, logging, tracing, profiling, OpenTelemetry, instrumentation, Kubernetes/cloud, data platforms, visualization, alerting, SRE integration, cost, security, platform engineering, AI-driven operations, and MAANG interview preparation — cross-linking existing prometheus/grafana-cloud/kubernetes/sre/platform-engineering notes instead of duplicating them.
Kubernetes
A book-shaped table of contents for Kubernetes: cloud-native foundations, the CKAD/CKA/CKS certification tracks, control-plane internals, platform tooling, multi-cluster architecture, and MAANG-level system design and interview prep — cross-linking the existing Prometheus, Observability, and Platform Engineering chapters instead of duplicating them.
Site Reliability Engineering: From Foundations to Internet-Scale Systems
The complete 184-chapter, 15-part Site Reliability Engineering curriculum — from Linux internals and distributed-systems theory through reliability engineering, observability, incident response, platform engineering, and Staff/Principal-level MAANG interview preparation, ordered the way SRE expertise actually develops rather than as a topic index.
Aptitude
A book-shaped table of contents for aptitude test prep: quantitative aptitude, logical reasoning, verbal ability, and mock-test strategy for the aptitude rounds that still gate MAANG-adjacent hiring pipelines.