Session Design: S2 - Adoptando la Perspectiva del Agente

Position in Journey

Phase: Fase 2 — Adoptando la Perspectiva del Agente
Emotional goal: Claridad + dirección. De “no sé por dónde empezar” a “sé exactamente qué palancas tocar”.
Cognitive goal: Adoptar la perspectiva del agente — preguntarse “qué necesita mi agente” en vez de “qué quiero yo” — como método de trabajo. Mapear los 12 puntos de apalancamiento (4 in-agent + 8 through-agent) como herramienta concreta. Conocer los KPIs agénticos.
Key question: ¿Dónde invierto mi esfuerzo para obtener el máximo retorno?

Terminal Objective

Adoptar la perspectiva del agente como método de trabajo — preguntarse “qué necesita mi agente” en vez de “qué quiero yo” — sabiendo que existen 12 puntos de apalancamiento sobre los que actuar, y conocer los KPIs agénticos (SAPS) como medida de progreso.

Learning Objectives

O1 (COMPRENDER): Dado que los agentes son efímeros — nacen sin memoria, sin contexto, sin conocimiento del proyecto —, el participante explicará por qué adoptar la perspectiva del agente (“qué necesita mi agente” en vez de “qué quiero yo”) es el método fundamental para trabajar con ellos de forma efectiva, articulando al menos dos razones vinculadas a la naturaleza efímera del agente.
O2 (ANALIZAR): Dado un comando o prompt para un agente, el participante identificará qué puntos de apalancamiento activa, clasificándolos correctamente como in-agent o through-agent e identificando al menos 3 puntos por comando.
O3 (APLICAR): Dado un proyecto real del equipo, el participante configurará al menos un comando para el agente aplicando la perspectiva del agente — identificando qué puntos de apalancamiento cubre y cuáles quedan como oportunidad.
O4 (COMPRENDER): Dados los 12 puntos de apalancamiento como mapa de inversión, el participante explicará los KPIs agénticos (SAPS: Size, Attempts, Presence, Streak) como métricas complementarias, describiendo qué mide cada KPI y conectándolo con al menos un punto de apalancamiento.

Activities

Check-in

Duration: 5 min
Description: Ritual de apertura. “¿Cómo llegáis?” Ronda rápida — cómo se encuentra cada persona. Sin relación con el contenido de la sesión.
Materials needed: —

Pregunta provocativa

Duration: 3 min
Description: “¿Sabéis qué necesita vuestro agente para hacer bien su trabajo?” Dejar que la pregunta aterrice en silencio (5-10 segundos). No responderla — el ejercicio “Sois el agente” la responde directamente.
Materials needed: —

Recapitulación

Duration: 5 min
Description: Puente desde S1: “Supervisar no escala. El prompt es la unidad de trabajo. Para diseñar un buen prompt… ¿no necesitáis entender cómo piensa el agente?” Conecta la conclusión de S1 con el tema de S2.
Materials needed: —

“Sois el agente” — Ejercicio de perspectiva (MODELAR)

Objective: O1
Duration: 20 min
Description: El facilitador propone: “Sois un agente. Os acaban de crear. Memoria vacía. Alguien dice: ‘Añade fecha límite a los TODOs — migración, validación, endpoint y date picker en React.’ ¿Qué necesitáis para hacerlo?” El grupo va respondiendo libremente, el facilitador anota las respuestas en pizarra sin agrupar ni categorizar — el objetivo es que experimenten el cambio de perspectiva, no que descubran un framework. Segunda ronda: “Ya tenéis eso. Empezáis a trabajar. ¿Qué más encontraríais en el proyecto que os haría más efectivos?” — más respuestas, más notas en pizarra. El facilitador NO busca que emerjan los 12 puntos; busca que el grupo sienta lo que es pensar desde el agente. Cierre: “Acabáis de hacer exactamente lo que debéis hacer siempre: pensar desde la perspectiva del agente. Esta es LA táctica de esta sesión y de todo el curso.” La pizarra queda como está — cuando llegue el Mapa, el facilitador conectará: “Lo que dijisteis encaja aquí.”
Materials needed: Pizarra para anotar respuestas (sin agrupar)

El mapa de los 12 puntos de apalancamiento (MODELAR)

Objective: O1, O2
Duration: 15 min
Description: El facilitador presenta el framework completo con slides. In-Agent (Core Four: Context, Model, Prompt, Tools) — lo que viaja siempre con el agente. Through-Agent (Standard Out, Types, Documentation, Tests, Architecture, Plans, Templates, ADWs) — lo que el agente encuentra en el entorno y fluye a través del context window. Para cada punto, una frase y un ejemplo. Al llegar a Tools: “Estamos a una herramienta de distancia de que un agente pueda hacer cualquier cosa.” Mención al SDLC (Plan, Code, Test, Review, Document) como el ciclo donde operan estos puntos. Cierra con: “Esto es el mapa completo. A lo largo del curso profundizaremos en cada punto. Ahora vamos a usarlo como herramienta de análisis con las manos.”
Materials needed: Slides: diagrama in-agent vs through-agent, los 12 puntos

Lab Demo: Analizando comandos con el mapa (PRACTICAR)

Objective: O2
Duration: 30 min
Demo app branch: S2
Description: El facilitador guía al grupo a examinar y probar comandos en la TODO app (Rails + React), siguiendo una progresión deliberada: conocer → preparar → componer → invertir. Después de cada comando, el grupo analiza DESDE LA PERSPECTIVA DEL AGENTE qué puntos de apalancamiento toca. El facilitador marca en pizarra los puntos que cada comando activa, construyendo un mapa visual acumulativo.

/tools — Conoce a tu agente: El facilitador ejecuta /tools. “¿Sabéis qué herramientas tiene vuestro agente? Él ya lo sabe. ¿Vosotros?” El grupo ve la lista de herramientas disponibles. Insight: “Para adoptar la perspectiva del agente, necesitáis saber qué puede hacer. No podéis diseñar buenos comandos si desconocéis las capacidades de vuestro agente.” Este comando existe para los HUMANOS — para que conozcáis a vuestro agente. Conecta directamente con el ejercicio “Sois el agente”: ellos imaginaron ser el agente y descubrieron necesidades — ahora ven las capacidades reales.

/prime — Prepara a tu agente: El facilitador ejecuta /prime. “¿Qué acaba de hacer? Ha leído la estructura del proyecto y los READMEs. Ahora el agente sabe dónde está.” “Ya sabéis qué puede hacer vuestro agente. Ahora decidid qué necesita SABER.” Preguntas: “¿Y si solo quisiéramos trabajar en el frontend? ¿O en el backend? ¿O en seguridad? ¿O en los propios comandos?” El facilitador explica que /prime es para cuando queremos “hablar” con el agente — investigar, explorar, cuando todavía no tenemos claro qué comandos necesitamos. Es el contexto inicial de una sesión de trabajo. Si da tiempo: crear /prime:backend y /prime:frontend en vivo, mostrando cómo se especializa el contexto. Nota: en la demo app no hace falta porque es pequeña, pero en un proyecto real estas variantes son esenciales. Mención a CLAUDE.md como mecanismo equivalente pero automático — /prime permite decidir qué y cuándo. Insight: “Sin /prime, cada interacción empieza de cero — exactamente el problema de S1.”

/env:start — Composición: El facilitador ejecuta /env:start. El grupo observa qué pasa: el agente invoca /env:setup, que a su vez invoca /infra:up. Tres niveles de delegación en una sola ejecución. Preguntas: “¿Qué ha pasado? ¿Cuántos comandos se han ejecutado? ¿Quién invocó a quién?” El grupo abre los ficheros para ver la cadena. Insight: un comando puede invocar otros comandos — esto es composición. El facilitador pide que miren el árbol de .claude/commands/: “10 comandos organizados en env:, infra:, git:. Los comandos se organizan como el código.”

/git:commit — Invierte para el agente: El grupo ejecuta /git:commit (después de hacer un cambio pequeño en la demo app). “¿Cuánto caso le hacemos los humanos a los mensajes de commit? Para un agente futuro que lea el histórico, un buen mensaje es un leverage point claro.” Insight: “Los mensajes de commit son importantes para los agentes, no para nosotros. Esto es exactamente adoptar la perspectiva del agente: invertir en lo que a ellos les importa.”

Cierre de la actividad: los comandos son código del proyecto. “Todo lo que habéis visto vive en .claude/commands/. Son ficheros markdown en el repositorio. Se versionan con git. Se revisan en PR. Se comparten con el equipo. Los comandos son código del proyecto — y es responsabilidad del equipo decidir cuáles van al repo.” Conectar con los 12 puntos: “Estos comandos cubren 9 de 12 puntos. ¿Cuáles faltan?” Respuesta: Types, Tests, ADWs — el camino del resto del curso.
Materials needed: Aplicación demo TODO app con 10 comandos predefinidos (rama S2), cada participante con portátil y Claude Code, pizarra con el mapa de los 12 puntos

Práctica en Proyecto (APLICAR)

Objective: O3
Duration: 15 min
Description: El grupo elige un proyecto real del equipo. El primer paso es crear un /prime para ese proyecto, pensando desde la perspectiva del agente: “¿Qué necesita vuestro agente para ser efectivo en este proyecto? ¿Qué leería vuestro /prime? ¿Vuestro README es útil para un agente?” Si da tiempo, también un comando de entorno. El facilitador guía pero no prescribe — el objetivo es que piensen en cómo cada comando afecta al agente: qué le aporta, qué capacidades le da. Recordar: estos comandos irán a su repositorio — es código del equipo. Primera transferencia al contexto real.
Materials needed: Proyecto real del equipo accesible desde los portátiles

KPIs agénticos: SAPS (MODELAR)

Objective: O4
Duration: 10 min
Description: El facilitador introduce los KPIs agénticos: “Tenéis el mapa de dónde invertir. Ahora: ¿cómo sabéis que estáis progresando? No hay un destino fijo — estos KPIs os ayudan a entender qué significa mejorar en desarrollo agéntico.” Presenta los cuatro: Size (tamaño de tarea delegada al agente), Attempts (iteraciones necesarias para completar), Presence (tiempo de supervisión humana), Streak (éxitos consecutivos a la primera). Cada métrica ilumina una dimensión diferente del progreso. Cierra: “Vamos a usar estos KPIs a lo largo del curso.”
Materials needed: Slides: KPIs SAPS

Reflexión / Resumen (REFLEXIONAR)

Objective: O1, O2, O3, O4
Duration: 10 min
Description: Reflexión metacognitiva (3 min): “Pensad en el último comando que escribisteis para Claude Code. ¿Qué puntos de apalancamiento cubría? ¿Qué le faltaba al agente?” El facilitador deja 30 segundos de silencio y luego pide 2-3 respuestas voluntarias. Síntesis (4 min): “Pensar desde el agente cambia dónde invertimos esfuerzo. Los 12 puntos son el mapa. Los KPIs os dicen si estáis avanzando.” Semilla para S3 (3 min): “Los comandos de hoy son simples — un propósito, una acción. ¿Cómo convertís un tipo de problema recurrente en un proceso completo que el agente siga siempre?”
Materials needed: —

Check-out

Duration: 5 min
Description: Ritual de cierre. “¿Cómo os vais?” Ronda rápida — cómo se va cada persona. Sin relación con el contenido de la sesión.
Materials needed: —

Time Budget

Block	Duration	Activity
Check-in	5 min	Ritual: cómo se encuentra cada persona
Pregunta provocativa	3 min	”¿Sabéis qué necesita vuestro agente para hacer bien su trabajo?”
Recapitulación	5 min	Puente desde S1: supervisar no escala, el prompt es la unidad de trabajo
Sois el agente	20 min	Ejercicio de perspectiva grupal — descubrir Core Four y through-agent
Mapa 12 puntos	15 min	Framework completo: in-agent vs through-agent, SDLC
Lab Demo	30 min	/tools → /prime → /env:start → /git:commit (conocer → preparar → componer → invertir)
Práctica en Proyecto	15 min	Crear comandos para un proyecto real del equipo
KPIs SAPS	10 min	Introducción: qué significa progresar en desarrollo agéntico
Reflexión / Resumen	10 min	Metacognición + síntesis del shift de perspectiva + semilla S3
Check-out	5 min	Ritual: cómo se va cada persona
Total planificado	118 min
Safety margin (21.3%)	32 min
Total sesión	150 min

Nota sobre el margen: El 21% de margen es suficiente. La actividad del lab demo puede y debe extenderse si el grupo genera discusión rica al analizar los comandos. El facilitador tiene libertad para dedicar más tiempo a /prime (variantes de contexto) y /env:start (composición) si el grupo está enganchado.

Contenido prescindible (si falta tiempo):

Los KPIs SAPS pueden comprimirse a 5 min (solo nombrarlos y dejar para sesiones posteriores)
La recapitulación puede eliminarse si el grupo conecta rápido con el ejercicio de perspectiva
En el lab demo, las variantes de /prime (frontend/backend) son opcionales. /git:commit puede comprimirse a mención si falta tiempo

Materials Needed

Pizarra/whiteboard: para el ejercicio de perspectiva y para el mapa acumulativo de puntos por comando
Slides: framework 12 puntos (diagrama in-agent vs through-agent), KPIs SAPS
Aplicación demo TODO app (Rails + React) con 10 comandos predefinidos (rama S2): /prime, /tools, /env:setup, /env:start, /env:stop, /env:restart, /infra:up, /infra:down, /infra:restart, /git:commit
Cada participante con portátil y Claude Code configurado contra la demo app
Proyecto real del equipo accesible para la actividad de práctica

S2: Puntos De Apalancamiento