Hands on
agentes

Dónde y con qué correr tus agentes, y cómo hacer que mejoren.

QR al repo github.com/Jero110/hand-on-agents-presentation

Escanea para abrir el repo
github.com/Jero110/hand-on-agents-presentation

Hoy aprenderás esto

Chat webCopias y pegas Agente enterminalActúa en tu compu Varios agentesCada uno en su panely hablan entre ellos WorkflowsUn equipo con un planque tú apruebas Más autonomía, más herramientas, más pasos sin ti

Lo que vamos a ver

    1

    ¿Dónde los corro?

    La terminal y los multiplexers.

    Tres formas de usar agentes

    Por la web

    Entras a un sitio, chateas y copias lo que te da. Solo ve lo que tú le pegas.

    Dentro de un IDE

    El agente vive dentro de tu editor de código, como VS Code o Cursor.

    Por la terminal

    El agente corre en la terminal y trabaja directo sobre tu computadora.

    La usamos por el acceso, no por complicarlo

    En la terminal el agente tiene mejor acceso a todo lo que hay en tu computadora.

    Por la web

    1. Buscas el archivo tú
    2. Lo subes
    3. Lo pegas en el chat

    Por la terminal

    Le pides que lo busque por ti, y lo encuentra.

    terminal
    > Encuentra mi contrato de renta
    ✓ buscando en tu computadora
    ✓ Documentos/casa/contrato-renta.pdf

    ¿Y los IDEs o la app de escritorio?

    Son una capa extra encima de la terminal. Sirven para ver mejor, pero no son necesarias.

    App de escritorio o IDE · para ver mejor Terminal + agente · donde pasa todo Tu computadora

    Multiplexer

    Un nombre muy fancy para algo simple: varias terminales abiertas en una sola pantalla.

    planner ¿Qué quieresconstruir? agente 1 · Claude diseñando… agente 2 · Codex programando… agente 3 · opencode buscando…

    Sirven para dos cosas

    Ver todo a la vez

    Trabajas con varios agentes y los ves al mismo tiempo, cada uno en su panel.

    Que se hablen

    Un Claude puede hablar con otro Claude, o con cualquier otro agente.

    Agente A Agente B

    Claude y Codex no lo permiten solos: hace falta una pequeña extensión.

    Los tres más usados

    Logo de tmux

    tmux

    El original y el más básico. Funciona en cualquier sistema.

    Logo de cmux

    cmux

    Solo Mac, gratis y de código abierto. Pestañas verticales y avisos cuando un agente te necesita.

    Logo de herdr

    herdr

    Pensado para agentes: los deja corriendo y los retomas cuando quieras.

    El workflow que usaremos hoy funciona con cmux y con tmux.

    2

    ¿Con qué los corro?

    El harness y los modelos.

    Harness

    Otra palabra fancy para lo que está encima del modelo, vigilándolo: herramientas, memoria, reglas y el ciclo que lo hace trabajar.

    HARNESS Claude · Anthropic GPT · OpenAI Gemini · Google

    Los harness que se usan hoy

    Qué tanto se usaQué tanto lo puedes cambiar
    Logo de Claude Code

    Claude Code

    De Anthropic. Usa los modelos Claude. Muy pulido, pero cerrado.

    Logo de Codex

    Codex

    De OpenAI. Usa los modelos GPT. Muy usado, con poco que cambiar.

    Logo de opencode

    opencode

    Código abierto. Funciona con muchos modelos, incluso gratuitos.

    Logo de pi

    pi

    Mínimo y de código abierto. Cualquier modelo. Casi todo lo configuras tú.

    Cada harness es mejor en algo

    Unos son más configurables

    Puedes cambiar casi todo, como en pi.

    Otros son más baratos

    Cuesta menos usarlos.

    Otros te dan modelos gratis

    Como opencode, que incluye algunos.

    Otros son mejores en una tarea

    Uno para diseñar, otro para la lógica, otro para buscar.

    Por eso importa que los agentes puedan comunicarse entre sí.

    Todo cambia muy rápido

    Hoy un harness es el mejor; mañana, otro. En vez de casarte con uno, lo mejor es una solución global que sirva para todos.

    Capa común para todos Claude CodeCodex opencodepi

    Un harness nuevo se conecta igual que los demás.

    Logo de pi

    pi: el que usamos hoy

    Un harness mínimo. Adáptalo a tu forma de trabajar, no al revés.

    • Código abierto y funciona con cualquier modelo
    • Se personaliza con extensiones, skills, plantillas de prompts y temas
    • Lo que armas se empaqueta y se comparte por npm o git

    pi es ligero: estos son sus comandos

    pi
    /model    cambia de modelo en plena sesión
    /tree     vuelve a un punto anterior y sigue desde ahí
    /export   guarda la sesión como HTML
    /share    la sube a un gist y te da un link
    /reload   recarga pi después de que se modifique a sí mismo
    
    pi -p "pregunta"           modo script, sin interfaz
    pi --mode json             salida en JSON
    pi install npm:<paquete>  instala un paquete (o git:<repo>)

    Hoy usamos un agente construido sobre pi

    Ya trae las skills y todo configurado, para que no tengas que armarlo desde cero.

    El agente de hoy: skills, MCPs y ajustes ya listos pi
    3

    Tres niveles para configurarlo

    Skills, MCPs y el propio harness.

    Skill, MCP, harness

    NivelQué esEjemplo
    1. Skill
    la sesión
    Texto que el modelo lee para saber cómo trabajarimpeccable
    2. MCP
    un programa
    Un programa aparte que le da herramientas nuevasagent-link
    3. Harness
    settings, hooks, extensiones
    Configuración que cambia al harness mismoEl workflow de hoy con Claude

    1. Skill

    Texto que el modelo lee para saber cómo trabajar: método, reglas, contexto.

    Límite: depende de que el modelo obedezca. No le da herramientas nuevas.

    Ejemplo: impeccable le enseña a diseñar interfaces bonitas.

    Así se ve una skill completa

    Un archivo de texto. Son instrucciones, no un README: el modelo las lee y las sigue.

    skills/explica-simple/SKILL.md
    ---
    name: explica-simple
    description: Explica cualquier tema técnico sin jerga,
      para personas que no son técnicas.
    ---
    
    # Explica simple
    
    Cuando te pidan explicar algo técnico:
    
    1. Empieza con una analogía de la vida diaria.
    2. Usa frases cortas, de 15 palabras o menos.
    3. Si usas un término técnico, defínelo en esa misma frase.
    4. Termina con un ejemplo concreto.
    
    No hagas:
    - Listas largas de conceptos.
    - Palabras en inglés si existe una en español.

    Skills: cuatro grupos

    Pre-build

    Entender antes de construir

    • planner
    • grilling

    Build

    Construir con método

    • test-driven-development
    • incremental-implementation
    • security-and-hardening
    • spec-driven-development

    Post-build

    Cerrar bien

    • handoff
    • shipping-and-launch

    Extras herramientas sueltas, cuando las necesites

    • impeccable
    • code-review-and-quality
    • code-simplification
    • debugging-and-error-recovery

    2. MCP

    Un programa aparte que le da al modelo herramientas nuevas, igual en cualquier harness.

    Límite: solo actúa cuando el modelo decide usarlo.

    Ejemplo: agent-link le da herramientas para lanzar otros agentes y hablar con ellos.

    3. Harness

    Configuración y código que el propio harness ejecuta: qué modelo usa, qué acciones aprueba o bloquea, cómo se ve.

    Límite: se hace una vez por cada harness.

    Ejemplo: conectar el workflow de hoy con Claude. Ya arranca usando los modelos de Claude con tu login, y el modelo no decide eso.

    4

    Un workflow completo

    De la idea al resultado, con agentes que trabajan en equipo.

    Planner, executor y tú

    plan aprobado reporte final PlannerExecutorTú planea contigoconstruye sin tirevisas y decides

    El planner: alinear antes de construir

    El planner no escribe código. Su trabajo es que el agente entienda exactamente lo que tú quieres.

    • Te pregunta hasta que los dos entienden lo mismo
    • Investiga el proyecto antes de proponer nada
    • Deja todo en un plan escrito: objetivo, decisiones, tareas y quién hace qué
    • Tú lo apruebas. Así el agente no inventa cosas ni hace lo que no pediste, y después no tiene que preguntarte nada

    El executor trabaja sin necesitarte

    Con el plan aprobado, lo ejecuta todo solo.

    • Lanza a los agentes que haga falta, cada uno con el modelo ideal para su tarea
    • Responde por ti cuando un agente pregunta o pide permiso. Lo riesgoso te lo deja a ti
    • Sigue hasta cumplir el objetivo que pusiste en el plan

    Así se ve en el multiplexer

    executor lee el plan lanza a los agentes corre las pruebas cierra lo verificado opencode · buscaPASS ✓ Claude · diseñoPASS ✓ Codex · lógicatrabajando…

    Un agente por tarea, con el modelo ideal para cada una. Cada uno responde PASS, ISSUES o BLOCKED, con su prueba.

    Después: extras, a mano

    Cuando termina de construir, tú puedes pedir más cosas. Son manuales: no siempre quieres que corran.

    Por ejemplo, una revisión de código:

    terminal
    > /skill:code-review-and-quality

    El agente revisa lo que se construyó y te dice qué mejorar.

    5

    Memoria persistente

    Que el agente no empiece de cero cada vez.

    El problema

    Sesión 1

    lunes
    Tú:      Haz la página de mis gastos,
             en azul.
    Agente: Listo. Creé gastos.html.

    Sesión 2, otro día

    martes
    Tú:      Cámbiale el color a la página.
    Agente: ¿Cuál página? No tengo registro
             de ninguna sesión anterior.

    Cada sesión empieza en blanco. El agente no sabe qué hizo en la sesión 1.

    La solución: darle memoria al agente

    Un cuaderno que él mismo escribe y vuelve a leer: archivos de texto.

    Sesión 1Sesión 2 notas.md escribe lo aprendido lo lee al empezar

    La idea de Karpathy: una LLM wiki

    El modelo lee tus fuentes y construye una wiki: archivos conectados entre sí.

    FUENTES Links, archivos, transcripciones LLM Lee, extrae y conecta PÁGINAS WIKI Persistente, enlazada y consultable

    Cómo se ve en carpetas

    Un ejemplo:

    mi-wiki/
    mi-wiki/
    ├── AGENTS.md            ← las reglas
    ├── raw/                  ← las fuentes (no se tocan)
    │   ├── articulo-agentes.pdf
    │   └── notas-reunion.md
    └── wiki/                 ← la escribe el modelo
        ├── index.md          ← el catálogo
        ├── log.md            ← la bitácora
        ├── harness.md
        └── multiplexers.md
    Logo de Obsidian

    Obsidian: para ver tu wiki

    Abre esa carpeta de archivos Markdown y muestra cómo se conectan las páginas, en un grafo. Es la herramienta que usaremos hoy.

    harnessskillsmultiplexersmemoriaworkflowmcpmodelos
    6

    Self-learning

    Que tu sistema mejore con el uso.

    El primer paso

    No es que el sistema se optimice solo y sin control.

    Es algo más simple: que entienda cómo está armado y te diga, con evidencia, qué conviene cambiar.

    La decisión sigue siendo tuya.

    Pieza 1: alguien que sabe todo de tu setup

    Un agente con el contexto completo: qué harness y modelos tienes, qué skills existen, cómo se conectan los agentes y qué pasó en las últimas corridas.

    • Responde sobre tu propio sistema sin que se lo expliques
    • Evalúa cosas nuevas: ya tienes algo mejor, es casi igual a algo tuyo, o vale la pena probarlo

    Pieza 2: alguien que observa y recomienda

    Un registro automático de todo: qué agente hizo qué, con qué modelo y skills, cuántos tokens, cuánto tiempo, dónde se trabó. Al final, un análisis.

    • Los números se calculan, no se adivinan
    • Cada recomendación trae su evidencia y dónde cambiarla

    El ciclo

    1 TrabajasCon tus agentes2 Se registra todoAlguien te observa3 AnálisisCon números reales4 RecomendacionesQué cambiar y por qué Toma nota de skillsmodelosharnesspromptsresultadosgasto 5 Tú decides¿Lo aceptas?6 Tu workflow mejoraSkills, plan y modelos Cada vuelta deja tu workflow un poco mejor
    7

    Demo

    Vamos a ver el workflow de hoy funcionando.

    Muchas gracias
    por su atención