Cómo leer este libro

Este libro tiene dos objetivos.

Primero, plantea un argumento: los agentic systems necesitan arquitectura antes que autonomía. Segundo, te ofrece una referencia de patterns que puedes usar durante el trabajo de diseño.

No necesitas leer todos los capítulos en orden. Pero sí debes leer los capítulos de selección antes de agregar loops, tools, memory o múltiples agents a un sistema.

Elige tu ruta

Usa la ruta que coincida con la decisión que tienes enfrente.

Si eres…	Comienza con	Objetivo
Nuevo en agentic systems	First-Time Path	Aprende el vocabulario central y los límites.
Diseñando o revisando un sistema	Builder Path	Elige patterns, controles y responsabilidades de producción.
Ejecutando código	Lab Path	Construye pequeños ejemplos y conéctalos con la arquitectura.
Buscando ejemplos tipo producto	Capstone Path	Ve patterns combinados en sistemas completos.
Aprendiendo visualmente o integrando un equipo	Visual Architecture Route	Usa diagramas para entender límites, propiedad y controles de producción.
Consultando un pattern durante el trabajo	Reference Path	Revisa casos de uso, modos de falla, evals y listas de verificación de producción.
Eligiendo una sección para leer	Logical Groups	Entiende por qué el libro está agrupado así y dónde cada grupo aporta valor.
Atorado con la terminología	Glossary and Acronyms	Descifra agent, eval, protocol, security y términos de producción.
Preparando un release	10/10 Production Gate	Verifica si el sistema es revisable, testeable, observable y reversible.

La ruta más útil no es la lista más corta de páginas. Es la que te lleva a una decisión de diseño con suficiente context para evitar una mala abstracción.

Flujo de decisión de ruta de lectura

flowchart TD Start["What evidence do you need?"] --> Vocabulary{"Need vocabulary and boundaries?"} Vocabulary -->|Yes| FirstTime["First-Time Path"] Vocabulary -->|No| Design{"Designing or reviewing a system?"} Design -->|Yes| Builder["Builder Path"] Design -->|No| Build{"Need runnable code?"} Build -->|Yes| Lab["Lab Path"] Build -->|No| Compare{"Need complete examples?"} Compare -->|Yes| Capstone["Capstone Path"] Compare -->|No| Release["10/10 Production Gate"] FirstTime --> Decision["Explain model call, workflow, agent, and multi-agent boundaries"] Builder --> Evidence["Produce architecture sketch, owners, evals, and rollback path"] Lab --> Controls["Run a slice and list missing production controls"] Capstone --> Gaps["Compare against traces, evals, ADRs, runbooks, and rollout controls"] Release --> Gate["Make a ship or no-ship decision from evidence"]

La ruta termina solo cuando produce la evidencia de la derecha.

Guía de tiempo y dificultad

Consulta esta tabla antes de elegir una ruta. Las estimaciones asumen un ingeniero de software que puede hojear material familiar y detenerse en patterns, código o controles de producción desconocidos.

Ruta	Mejor para	Dificultad	Tiempo	Evidencia que debes producir
First-Time Path	Aprender el vocabulario y los límites.	Principiante a intermedio	2-4 horas	Una breve explicación de agent, workflow, tool, state, memory, eval y condición de stop.
Builder Path	Diseñar o revisar un sistema real.	Intermedio a avanzado	1-2 días	Boceto de arquitectura, pattern seleccionado, alternativas rechazadas, owners, evals y ruta de rollback.
Lab Path	Ejecutar ejemplos y ver límites de implementación.	Intermedio	1-3 días	Pruebas aprobadas, salida de trace, lista de controles faltantes y una tarea de hardening por lab.
Capstone Path	Comparar sistemas completos tipo producto.	Avanzado	4-8 horas	Análisis de brechas contra traces, evals, ADRs, runbooks y controles de release.
Reference Path	Consultar un pattern durante el diseño.	Intermedio	10-30 minutos por capítulo	Decisión de fit/avoid, modo de falla, caso de eval y checklist de producción.
Release Path	Decidir si un sistema puede lanzarse.	Avanzado	2-6 horas	Scorecard completado, registro de evidencia de release, límites conocidos y decisión de ship/no-ship.

No optimices por velocidad. Optimiza por evidencia. Una lectura rápida que no cambia el diseño no es útil.

Criterios de salida de ruta

Usa estos chequeos para decidir si una ruta ya te sirvió. Si no puedes responder la pregunta de salida, continúa con la ruta enlazada antes de elegir un pattern o lanzar un sistema.

Ruta	Terminas cuando puedes…	Si no, continúa con…
First-Time Path	Explicar la diferencia entre una llamada a model, prompt chain, workflow, single agent y multi-agent system.	Pattern Selection and Composition
Builder Path	Dibujar el límite del sistema, nombrar el owner de state, tools, memory, policy, evals y rollback, y defender por qué cada pattern pertenece.	Reference Architecture
Lab Path	Ejecutar una pequeña implementación, identificar los controles de producción faltantes y nombrar el siguiente paso de hardening.	Lab Production Readiness Checklist
Capstone Path	Comparar un ejemplo completo con tu propio sistema y listar las brechas en traces, evals, ADRs, runbooks y controles de rollout.	Capstone Projects
Reference Path	Decidir si el pattern encaja, su costo, cómo falla y qué eval prueba que funciona.	Choosing the Right Pattern
Release Path	Mostrar evidencia de que el sistema es revisable, testeable, observable, reversible y tiene owner.	10/10 Production Gate

No consideres una ruta como completa solo porque leíste las páginas. Considérala completa cuando cambia la decisión de diseño que tienes enfrente.

Grupos lógicos

La barra lateral está organizada como una ruta de diseño, no como un catálogo plano.

Grupo	Propósito	Lee cuando
Start Here	Oriéntate, elige una ruta de lectura y define qué cuenta como agent.	Eres nuevo en el libro o necesitas la entrada más corta.
Pattern Selection and Composition	Decide si usar un prompt, chain, router, loop, multi-agent system o reliability pattern.	Estás eligiendo o revisando una arquitectura.
Agent Runtime Foundations	Aprende los primitivos centrales de runtime: single agent, loop, state, tools y structured output.	Necesitas el vocabulario y los límites de control.
Engineering Practice and Frameworks	Pasa de demo a sistema diseñado con lifecycle, harnesses, elecciones de framework y hojas de trabajo.	Estás planeando la implementación.
Evaluation, Security, and Trust	Agrega eval gates, threat modeling, sandboxing y controles de confianza humana.	El sistema afecta usuarios, datos o acciones externas.
Control Loops	Agrega planning, reflection, evaluator-optimizer, self-improvement y patterns de self-healing.	El agent necesita control iterativo.
Context, Memory, and Knowledge	Diseña working sets, context packets, memory, semantic recall, RAG y límites de knowledge.	El sistema depende de evidencia o state recordado.
Tools, Skills, and Protocols	Diseña tool capabilities, skills, MCP, A2A, aprobaciones y comunicación segura.	El agent necesita capacidades externas.
Multi-Agent Systems	Elige y opera topologías para delegación, supervisión, debate y trabajo en paralelo.	Un agent ya no es suficiente.
Systems Architecture	Compón sistemas completos: servicios, sistemas RAG, coding agents, computer-use agents, dominios, ADRs y referencias.	Estás diseñando todo el límite del sistema.
Production Runtime	Ejecuta agents con durabilidad, observability, feedback loops, policy, budgets, eventos y controles de rollout.	Estás preparando para producción.
Hands-On Labs	Construye los patterns en ejercicios pequeños y tracks de framework.	Quieres práctica de implementación.
Capstone Projects	Estudia ejemplos completos tipo producto con traces, evals, ADRs, runbooks y rollback.	Quieres ver patterns combinados.

Recomendación para la Primera Lectura

Empieza aquí si quieres que el libro se lea como un libro, no como un catálogo:

Lector: ingeniero o líder técnico que busca el argumento completo.
Resultado: comprender la postura de arquitectura-primero del libro antes de usar el catálogo.
Profundidad aproximada: media-larga; lo ideal es leerlo en varias sesiones.

Esta ruta te da la tesis antes de los detalles del catálogo.

Ruta para Primeros Lectores

Empieza aquí si eres nuevo en agentic systems:

Lector: ingeniero de software aprendiendo el vocabulario.
Resultado: saber qué hace diferente a un agent de una llamada a un model, chain o workflow.
Profundidad aproximada: corta-media; léelo antes de los labs.

Esta ruta te da el vocabulario central antes de los capítulos de production runtime.

Ruta para Builders

Usa esta ruta cuando estés diseñando o revisando un sistema:

Lector: builder, staff engineer, arquitecto, revisor o líder técnico.
Resultado: producir un diseño defendible con state, tools, memory, policy, evals y límites de runtime explícitos.
Profundidad aproximada: media-larga; úsala junto con un diseño real.

Esta ruta es ideal para trabajo de arquitectura, revisiones de diseño y verificaciones de preparación para producción.

Ruta de Labs

Usa esta ruta cuando quieras ejecutar código:

Lector: ingeniero enfocado en la implementación.
Resultado: ejecutar ejemplos pequeños, inspeccionar límites y entender qué debe cambiar antes de producción.
Profundidad aproximada: práctica; espera tiempo de configuración y depuración.

Cada lab enlaza de regreso a los capítulos de patterns y a los paquetes de código fuente descargables. Los labs se mueven intencionalmente entre Python, TypeScript, código neutral a frameworks, recuperación estilo LangChain/LangGraph, state graphs estilo LangGraph, supervisión y transcript evals estilo AutoGen, runtime packaging estilo Mastra, orquestación de flows estilo CrewAI, código A2A orientado a protocolos y evals basados en pruebas para que puedas ver la arquitectura debajo de la API.

Capstone Path

Usa esta ruta cuando quieras ejemplos completos con forma de producto:

Lector: ingeniero que ha terminado los capítulos principales o los labs.
Resultado: conectar patterns, traces, evals, ADRs, runbooks y rollout controls en sistemas completos.
Profundidad aproximada: media; se recomienda como material para revisión de diseño.

Esta ruta es ideal después de los labs. Muestra cómo los patterns, frameworks, evals, traces, ADRs y runbooks encajan entre sí.

Reference Path

Usa la barra lateral o la búsqueda cuando necesites un pattern específico. Cada capítulo generado de pattern sigue la misma estructura:

Lector: ingeniero que toma una decisión local sobre un pattern.
Resultado: decidir si un pattern es adecuado, cuál es su costo y cómo probarlo.
Profundidad aproximada: consulta rápida; salta entre capítulos relacionados.

Las páginas de patterns incluyen:

cuándo usarlo
cuándo evitarlo
arquitectura
system shape
core protocol
notas de implementación
modos de falla
estrategia de evaluación
checklist de producción
código fuente y descargas

La estructura repetida facilita escanear los capítulos durante el trabajo de diseño. No leas esas páginas como una novela. Usa los capítulos redactados para el argumento y las páginas de patterns para tomar decisiones.