Session Design: S8 - La Capa Agéntica

Position in Journey

Phase: Fase 8 — La Capa Agéntica
Emotional goal: Orgullo + visión. El equipo se reconoce como algo que no era al empezar.
Cognitive goal: Reconocer la transformación profesional vivida — de usuarios de IA a arquitectos de sistemas agénticos. Visualizar los retos del horizonte (control, ingeniería de contextos, gobernanza, orquestación) como la siguiente frontera.
Key question: ¿Cómo integro todo en un sistema coherente para el equipo?

Terminal Objective

Reconocer la transformación profesional vivida durante el curso — de usuarios de IA a arquitectos de sistemas agénticos — y visualizar los retos del horizonte (control, ingeniería de contextos, gobernanza, orquestación) como la siguiente frontera.

Learning Objectives

O1 (COMPRENDER): Dado el recorrido S1-S7, el participante recapitulará la progresión del curso como una transformación de identidad profesional — de pedir-revisar-corregir a diseñar sistemas que producen software autónomamente — identificando qué cambió en cada fase y cómo ese cambio habilitó el siguiente.
O2 (COMPRENDER): Dados los cuatro retos del horizonte (control, ingeniería de contextos, gobernanza, orquestación) presentados como dimensiones interrelacionadas, el participante explicará cómo cada uno representa una faceta distinta de la siguiente frontera del trabajo con agentes y cómo se afectan mutuamente.
O3 (COMPRENDER): Dado que un prompt en lenguaje natural no garantiza cumplimiento, el participante explicará cómo el código (hooks, tests, orquestación determinista) convierte instrucciones en garantías, y cómo la trazabilidad y la observabilidad permiten convertir la caja negra del agente en caja blanca.
O4 (COMPRENDER): Dado el concepto de context engineering (Karpathy) como disciplina que engloba prompt engineering, RAG, memoria, estado y structured outputs, el participante describirá la memoria agéntica (semántica, episódica, procedural) como caso concreto y conectará CLAUDE.md, comandos y git con formas de memoria que ya practican.
O5 (COMPRENDER): Dado el crecimiento de la capa agéntica del equipo, el participante identificará retos de gobernanza usando analogías de organización de repos (monorepo vs multi-repo, secretos, acceso) y de MRs (proceso de incorporación de cambios), reconociendo que el blast radius de cambios en contextos agénticos está oculto y que los stakeholders no técnicos (product, legal, seguridad) necesitan participar.
O6 (COMPRENDER): Dados los patrones de Anthropic (“Building Effective Agents”), el participante identificará qué patrones ya aplican (Prompt Chaining, Routing, Evaluator-Optimizer) y qué patrones representan el horizonte (Parallelization, Orchestrator-Workers), reconociendo que “lo que hacemos ya tiene nombre”.

Activities

Check-in

Duration: 5 min
Description: Ritual de apertura. “¿Cómo llegáis a la última sesión?” Ronda rápida.
Materials needed: —

Pregunta provocativa

Duration: 3 min
Description: Concepto-doble. Primera slide: “Lo que sabéis hoy sobre trabajar con IA no existía hace un año.” Dejar que aterrice. Segunda slide revela la pregunta: “¿Qué de lo que sabéis hoy seguirá siendo válido dentro de tres meses?” No se responde — se deja flotar. La sesión responde progresivamente: Acto I muestra que la transformación es real, Acto II muestra lo que viene, la paradoja muestra que la tecnología caduca, El espejo muestra que lo que permanece es el equipo.
Materials needed: —

Agenda

Duration: 2 min
Description: Mapa de la sesión. Tres bloques: El viaje, El horizonte, La paradoja. “Hoy no abrimos portátiles. Hoy miramos atrás, y miramos adelante.”
Materials needed: Slide con agenda

El viaje: S1→S7 (MODELAR)

Objective: O1
Duration: 15 min
Description: Espejo: S1→S7 como etapas de cambio de identidad profesional. No es un resumen de contenidos — es reconocimiento de transformación. El facilitador recorre el arco con callbacks a momentos específicos que el grupo vivió:
- S1: Vibe coding no escala. El prompt de calidad como unidad fundamental.
- S2: La perspectiva del agente. Los 12 puntos de apalancamiento.
- S3: Templates y plans — sistematizar problemas recurrentes. Los tres escenarios (bug, chore, feature).
- S4: AFK — los cuatro elementos. El agente trabajó mientras no estaban. La orquestación es código, no IA.
- S5: Bucles cerrados — R-V-R. El agente que se corrige solo. Playwright moviendo el browser.
- S6-S7: Proyecto real — aplicar todo al contexto del equipo.
Espacio para debate orgánico.
Materials needed: Slides con callback por sesión (S1→S7) y slide de síntesis “Build the system that builds the system"

"Build the system that builds the system” (MODELAR)

Objective: O1
Duration: 5 min
Description: Síntesis del arco. “De vibe coding a construir el sistema que construye el sistema.” Pausa. “Eso es lo que habéis hecho en 8 sesiones.” Espacio para debate: “¿Qué ha cambiado para vosotros?” Primer momento de orgullo de la sesión. No apresurarse. Transición: “Y ahora: ¿hacia dónde va esto?”
Materials needed: Slide “Build the system that builds the system”

Mapa de retos (MODELAR)

Objective: O2
Duration: 3 min
Description: Vista panorámica: los cuatro retos del horizonte como dimensiones interrelacionadas. Control, Ingeniería de contextos, Gobernanza, Orquestación. No es una cascada secuencial — son cuatro dimensiones que se afectan mutuamente, cada una con un origen distinto. “Cuatro retos. Cuatro dimensiones. Los vamos a recorrer.” No explicar cada uno — solo plantar el mapa.
Materials needed: Slide con los cuatro retos como tabla (reto + pregunta)

Control (MODELAR)

Objective: O3
Duration: 8 min
Description: Arranca con la tensión core: “Un prompt no es un contrato.” Un CLAUDE.md, un comando, un prompt — son texto, no enforcement. Lenguaje natural es probabilístico. Código es determinista. Ese es el salto.

Respuesta: “El código pone los límites.” Hooks, tests, herramientas, orquestación determinista. Ya lo hacemos: ADWs con orquestación determinista, hooks PreToolUse que interceptan acciones, R-V-R con tests. El prompt sugiere. El código impone.

Segunda dimensión: “¿Cómo sabemos lo que hace el agente por debajo?” Trazabilidad (reconstruir cada decisión) y observabilidad (ver en tiempo real). Sin esto, la autonomía es un acto de fe. La prevención ya la tenemos. La observabilidad es frontera.

Espacio para debate: ¿qué escenarios os preocupan?
Materials needed: Slide “Un prompt no es un contrato”, slide “El código pone los límites”, slide trazabilidad/observabilidad

Ingeniería de contextos (MODELAR)

Objective: O4
Duration: 8 min
Description: A medida que el sistema trabaja, produce contexto. Transición natural desde control.

Ancla con autoridad: cita de Karpathy — “Context engineering es el arte y la ciencia de llenar la ventana de contexto con exactamente la información correcta para el siguiente paso.” No es prompt engineering — es la ingeniería de TODO lo que rodea al prompt.

Diagrama de context engineering (LangChain): prompt engineering es solo una pieza dentro de un superconjunto que incluye RAG, memoria, estado, structured outputs. Cada una es una disciplina en sí misma.

Caso concreto — memoria agéntica: short-term vs long-term, semántica (hechos: CLAUDE.md) vs episódica (experiencias: git log, PRs) vs procedural (instrucciones: comandos, templates). Ya lo practican sin saberlo. El horizonte: el sistema gestiona su propia memoria.
Materials needed: Slide cita Karpathy, slide diagrama context engineering (imagen LangChain), slide memoria agéntica (imagen tipos de memoria)

Gobernanza (MODELAR)

Objective: O5
Duration: 5 min
Description: Consecuencia de tener contextos organizados: ¿quién decide qué va ahí y cómo evoluciona?

Concepto-doble para hacer sentir el problema: “Alguien modifica un contexto de la organización.” → reveal: “Todos los agentes de la organización cambian de comportamiento.” El impacto está oculto tras la simplicidad del artefacto.

Concepto-doble para conectar con lo conocido: “¿Cómo funciona la gobernanza en desarrollo de software?” → reveal: “MRs, code reviews, permisos de acceso.” El músculo ya existe.

Warning organizacional: “¿Quién hace code review de una política de IA? Product, legal, seguridad — no hacen MRs.” Las soluciones técnicas no cubren este caso. Gobernanza agéntica = gobernanza organizacional.

No hay solución estándar. El punto es que es un problema real.
Materials needed: Slides concepto-doble (impacto oculto), slides concepto-doble (prácticas conocidas), slide warning organizacional

Orquestación (MODELAR)

Objective: O6
Duration: 8 min
Description: Consecuencia de tener un sistema controlado, organizado y gobernado: ahora quieres escalar.

Lo que ya hacemos (sin saberlo). 5 patrones del artículo “Building Effective Agents” de Anthropic, cada uno con su diagrama:
- Prompt Chaining: template → plan → implement (S3-S4). Cadena secuencial predefinida.
- Routing: classify del ADW decide bug/chore/feature (S4). El flujo se bifurca según el tipo.
- Evaluator-Optimizer: bucles cerrados R-V-R (S5). Ejecuta → valida → corrige → repite.
El aha: “eso que hacemos tiene nombre.”

Lo que viene. Patrones horizonte:
- Parallelization: múltiples agentes simultáneos. Lo hemos rozado con worktrees, pero como proceso manual.
- Orchestrator-Workers: un agente central decide qué sub-agentes lanzar. No hay caminos predefinidos — la IA decide en tiempo real.
Referencia: “Building Effective Agents” de Anthropic (anthropic.com/engineering/building-effective-agents).
Materials needed: 5 slides imagen (una por patrón, con diagrama de Anthropic y fuente)

La paradoja (REFLEXIONAR)

Duration: 16.5 min
Description: Acto III — cierre emocional. La paradoja de la nave generacional como hilo conductor: lo que sabemos hoy se quedará obsoleto mañana. Lo importante no son los conocimientos técnicos — es el cambio de mentalidad.

Título: “La paradoja.” Tono pausado, reflexivo.

Nave generacional: dos imágenes (generadas con Gemini) que materializan la paradoja visualmente. Una nave lanzada hoy con la mejor tecnología sería adelantada por una más rápida lanzada después. Si esperas la nave perfecta, nunca lanzas. Aplicado: los comandos, los templates, los ADWs — pueden cambiar. Los modelos cambian cada mes. ¿Entonces esperamos?

Resolución: “Lo que permanece no es la tecnología. Es la capacidad de adaptarnos a la siguiente.”

Tesis: “El trabajo ha cambiado. Y todavía no sabemos cómo.” Frase directa, sin adornos. No es una confesión de fracaso — es honestidad intelectual.

Desarrollo: “Nadie tiene el mapa. Ni Anthropic. Ni OpenAI. Ni nosotros. Los modelos cambian cada mes. Las herramientas, cada trimestre.” Pero hay una diferencia entre estar perdido y saber navegar sin mapa. Tenemos frameworks (12 puntos, SAPS), práctica construyendo sistemas agénticos, criterio para evaluar lo que venga.

Cierre del arco metafórico: “La nave que importa no es la nave. Es la tripulación.” La tecnología caduca. Lo que permanece: el equipo, el criterio, la forma de pensar. Esta es la respuesta a la provocación del inicio (“¿qué seguirá siendo válido dentro de tres meses?”). La respuesta: nosotros.

Despedida: “Build the system that builds the system.” El mantra del curso como última palabra antes del check-out. Ya apareció en El Viaje como síntesis. Ahora es la despedida. No explicar — solo dejar que resuene.
Materials needed: Slide título “La paradoja”, 2 slides imagen nave generacional, slide resolución “Lo que permanece”, slide “El trabajo ha cambiado”, slide “Nadie tiene el mapa”, slide “La tripulación”, slide “Build the system” (lead)

Check-out

Duration: 5 min
Description: “Última ronda. ¿Cómo os vais?” Última ronda del curso. Dejar que sea más larga si el grupo quiere. Terminar con agradecimiento.
Materials needed: Slide check-out, slide de cierre (Gracias)

Time Budget

Block	Duration	Activity
Check-in	5 min	Ritual: cómo llega cada persona
Pregunta provocativa	3 min	Concepto-doble: “¿válido dentro de 3 meses?”
Agenda	2 min	Mapa de la sesión
El viaje (S1→S7)	15 min	MODELAR — Espejo: callbacks como transformación
”Build the system”	5 min	MODELAR — Síntesis + debate
Mapa de retos	3 min	MODELAR — Panorámica de cuatro dimensiones
Control	8 min	MODELAR — Prompt ≠ contrato + código + trazabilidad
Ingeniería de contextos	8 min	MODELAR — Karpathy + context engineering + memoria agéntica
Gobernanza	5 min	MODELAR — Impacto oculto + prácticas conocidas + warning organizacional
Orquestación	8 min	MODELAR — 5 patrones Anthropic (3 ya usados + 2 horizonte)
La paradoja	16.5 min	REFLEXIONAR — Nave generacional + incertidumbre + tripulación + despedida
Check-out	5 min	Ritual de cierre
Total planificado	83.5 min
Safety margin (44%)	66.5 min
Total sesión	~150 min

Nota sobre el margen: 44% (~67 min). Deliberadamente superior al 25% estándar. Sesión capstone donde los debates se extienden y la gente quiere hablar. El margen se absorbe en espacios de debate orgánico entre slides. Bloques que más se extienden: Control (genera debate sobre escenarios), La paradoja (la gente reconoce su viaje). Bloque prescindible si falta tiempo: Gobernanza se absorbe en ingeniería de contextos. Bloques expandibles si sobra tiempo: profundizar debate en cualquier reto, extender la reflexión con espacio para compartir.

Materials Needed

Slides (~45): Portada, check-in, pregunta provocativa (concepto-doble: 2 slides), agenda, título “El viaje”, diagrama evolución 7 etapas, callbacks temáticos (prompt como unidad, 12 puntos, through-agent, SAPS, cuatro elementos, in/out-of-loop, R-V-R, tabla roles, “Build the system” concepto-doble: 2 slides), título “El horizonte”, mapa de cuatro retos, título “Control”, “Un prompt no es un contrato”, “El código pone los límites”, trazabilidad/observabilidad, título “Ingeniería de contextos”, cita Karpathy, diagrama context engineering (imagen), memoria agéntica (imagen), título “Gobernanza”, concepto-doble impacto oculto (2 slides), concepto-doble prácticas conocidas (2 slides), warning organizacional, título “Orquestación”, 5 slides patrón Anthropic (imágenes), título “La paradoja”, 2 imágenes nave generacional, resolución “Lo que permanece”, “El trabajo ha cambiado”, “Nadie tiene el mapa”, “La tripulación”, “Build the system” (despedida), check-out, gracias.
Imágenes en assets/: context-engineering-langchain.jpeg, memory-types-for-ai-agent.png, anthropic-prompt-chaining.png, anthropic-routing.png, anthropic-parallelization.png, anthropic-orchestrator-workers.png, anthropic-evaluator-optimizer.png, nave-generacional-1.png, nave-generacional-2.png.
NO se necesita: demo app, portátiles de participantes, Claude Code configurado, pizarra. Esta sesión no tiene componente técnico hands-on.

Notes

Rol del contenido: semilla (A) con toques de evidencia (B). El Acto II planta curiosidad mostrando paisaje, no enseña soluciones. Detalles técnicos en notas del facilitador, no en slides.
Sesión sin PRACTICAR/APLICAR. Sesión capstone reflexiva. Actos I y II son MODELAR. Acto III es REFLEXIONAR.
Arco narrativo de tres actos. Acto I (El viaje): reconocerse. Acto II (El horizonte): cuatro dimensiones interrelacionadas. Acto III (La paradoja): aceptar que todo cambia, encontrar fortaleza en el equipo.
Cuatro retos como dimensiones, no cascada. No es secuencial — son cuatro dimensiones que se afectan mutuamente, cada una con un origen distinto. Control (el sistema es autónomo), contextos (el sistema produce cada vez más), gobernanza (quién decide), orquestación (cómo escalar).
Gobernanza es un reto nuevo. Conecta directamente con el entregable contractual “política de gobernanza de IA”. Las analogías de repos y MRs lo hacen tangible. Warning: los stakeholders no técnicos necesitan participar.
S6-S7 pendientes. Los callbacks a S6-S7 son deliberadamente genéricos (“aplicasteis todo en vuestros proyectos”). Se concretarán durante delivery con los momentos reales del equipo.
Sesiones de acompañamiento. Después de S8 hay 4 sesiones de 1h/semana. Los retos del horizonte plantan semillas: el equipo identificará qué profundizar.
Entregables contractuales. “Política de gobernanza de IA” (conecta con bloques de control y gobernanza), “roadmap técnico a 6 meses” (conecta con todo el Acto II), “biblioteca compartida de prompts” (conecta con ingeniería de contextos y gobernanza). S8 planta semillas; el acompañamiento cierra.
Recursos del facilitador (no en slides). Eventos de hooks (PreToolUse, PostToolUse, Stop, SubagentStop). Retry con backoff (1s, 3s, 5s). Estructura de repo madura (adws/, specs/, agents/{id}/). Nuevas primitivas (sub-agentes, skills, memoria, model selection dinámica). Pipeline de refinamiento de memoria detallado (log → resumen sesión → diario → semanal → curado). Escalera de complejidad (primitivas → multi-agente → observabilidad → routing → agente autónomo).

S8: Capa Agentica