Demo Walkthrough
Esta guía está pensada para entender qué hace el asistente de IA cuando ejecuta este playbook. La idea es que puedas leerla, entender qué pasa en cada paso, y saber qué información tenés que darle al asistente para que la demo salga bien — sin necesidad de saber programar.
En resumen
- Para qué sirve: mostrarle a otras personas, en vivo y paso a paso, cómo el asistente prueba una funcionalidad de punta a punta.
- Cuándo usarlo: en una demo para un cliente o stakeholders, en el onboarding de alguien nuevo, al grabar un video o al pedir la aprobación final de una historia.
- Qué necesitás: una historia de usuario con criterios claros, la URL de la app funcionando, credenciales de prueba, el
qa-stack.yamldel proyecto y la pantalla compartida lista. - Qué te llevás: el plan de pruebas, los hallazgos de la exploración con capturas, las pruebas automáticas, un reporte final fechado y una audiencia que entendió el proceso.
- Pasos: 6 — leer la historia, armar el plan, explorar en vivo, generar las pruebas, ejecutarlas y repararlas, y el reporte final (con una pausa para preguntas después de cada uno).
¿Qué es un playbook? (si es la primera vez que usás uno)
Pensalo como una receta de cocina para el asistente de IA. Vos le decís "quiero hacer esto" (por ejemplo, "quiero mostrarle a un cliente cómo probamos su funcionalidad") y el playbook es la receta que el asistente sigue paso a paso, en orden, sin saltarse nada, para que el resultado sea siempre el mismo sin importar quién lo pida.
Cada paso de la receta usa una herramienta puntual (en la jerga técnica se las llama "skills"), algo así como un utensilio de cocina: uno sirve para leer, otro para explorar la aplicación, otro para escribir el reporte final. Vos no necesitás saber cómo funciona cada utensilio por dentro — solo necesitás saber qué ingrediente hay que poner en cada paso (por ejemplo, qué aplicación, qué historia, qué URL) para que el resultado final sirva.
Un playbook = una guía ordenada de pasos. Una skill = la herramienta puntual que ejecuta cada paso. Interactuás con el playbook — el asistente se encarga de usar la herramienta correcta en cada momento.
1. ¿Qué hace este playbook?
Es el playbook que usás cuando necesitás mostrarle a otras personas, en vivo y paso a paso, cómo el asistente prueba una funcionalidad de punta a punta — sin que se pierdan en el medio.
El asistente puede hacer todo el trabajo de QA de una historia de usuario (leerla, armar un plan de pruebas, probar la aplicación, escribir los tests automáticos, ejecutarlos y armar el reporte final) en un solo tiro, sin pausas. Eso es perfecto para el trabajo del día a día, pero no es ideal para una demo: si todo pasa de golpe, la audiencia no llega a entender qué está viendo, no puede hacer preguntas a tiempo, ni ver cada artefacto apenas se genera.
Este playbook resuelve exactamente ese problema: hace lo mismo que el flujo completo de QA, pero:
- Va narrando en lenguaje simple qué está haciendo en cada paso, antes de hacerlo.
- Se detiene después de cada paso, para que la audiencia mire el resultado en pantalla y pregunte lo que quiera.
- Deja bien visible cada documento o archivo que se generó, en el momento en que se generó (no todos juntos al final).
Lo que este playbook NO hace distinto
No prueba nada extra ni de forma diferente al flujo normal de QA. La aplicación se prueba exactamente igual — la única diferencia es el ritmo y la narrativa pensados para que una audiencia pueda seguir el proceso en vivo.
2. ¿Cuándo tengo que usar este playbook?
Usalo cuando estés frente a alguna de estas situaciones:
| Situación | Ejemplo de negocio |
|---|---|
| Tenés que mostrarle el proceso a un cliente o a stakeholders antes de que aprueben algo | El cliente de TechStore quiere ver, con sus propios ojos, cómo se prueba la nueva funcionalidad de carrito antes de dar el visto bueno para pasar a producción |
| Estás incorporando a alguien nuevo al equipo y necesita entender el flujo completo de una sola vez | Un nuevo QA se suma al equipo de TechStore y necesita ver de principio a fin cómo se prueba una historia, sin tener que leer diez documentos distintos |
| Vas a grabar un video para mostrar internamente cómo trabaja el equipo, o para venderle el proceso a otro cliente | El área comercial de TechStore pide una grabación corta para mostrarle a un cliente potencial "así probamos lo que construimos" |
| Necesitás la aprobación final del cliente ("aprobación final") sobre una historia candidata, mostrando en vivo que funciona | Antes de cerrar el sprint, el cliente de TechStore quiere ver funcionando el flujo de "Finalizar compra" antes de firmar la aceptación |
Importante
- Este playbook no es para el trabajo diario de QA — para eso ya existe el flujo normal, que hace lo mismo pero sin pausas ni narrativa, mucho más rápido.
- Usalo específicamente cuando hay una audiencia mirando (un cliente, un stakeholder, una persona nueva, una cámara grabando) y necesitás que esa audiencia entienda cada paso, no solo ver el resultado final.
3. Ejemplo guía: "TechStore", una tienda online con carrito de compras
Vamos a seguir el mismo caso de negocio de ejemplo que en otras guías: TechStore, una tienda online de electrónica con carrito de compras (agregar productos, ver el carrito, pagar). Es el tipo de aplicación que cualquiera reconoce por haber comprado alguna vez online.
Supongamos este escenario: el equipo de TechStore acaba de terminar de desarrollar la funcionalidad "Finalizar compra" (el cliente agrega productos al carrito, hace clic en "Finalizar compra", y el sistema le confirma el pedido). Antes de dar por cerrada esa historia, el Product Owner de TechStore quiere que el equipo le muestre, en una reunión de 20 minutos, cómo se probó esa funcionalidad de punta a punta — no solo que le digan "ya está probada", sino verlo pasar en vivo.
Ese es exactamente el escenario para este playbook: hay una audiencia (el Product Owner), hay una historia concreta ("Finalizar compra"), y el objetivo es que esa audiencia entienda y confíe en el proceso, paso por paso.
A lo largo de los pasos siguientes vamos a ver qué le dirías al asistente en cada momento, usando esta demo de TechStore como ejemplo.
3.1 Antes de arrancar: lo que necesitás tener a mano
No hace falta saber programar, pero sí tener a mano estos datos:
| Dato | Ejemplo con TechStore |
|---|---|
| La historia de usuario que vas a mostrar en la demo, con sus criterios de aceptación bien definidos | El documento que describe "Como cliente quiero finalizar mi compra y recibir una confirmación" |
| La URL de la aplicación, funcionando y accesible antes de que arranque la reunión | https://techstore-staging.com |
| Credenciales de acceso, si la app pide login | Usuario y contraseña de una cuenta de prueba |
El archivo qa-stack.yaml del proyecto ya armado |
Si TechStore todavía no lo tiene, hay que ejecutar primero el playbook de puesta en marcha del proyecto |
| Pantalla compartida lista, si la demo es presencial o por videollamada | Tener el navegador y el chat con el asistente visibles para toda la audiencia |
| (Recomendado) Haber leído la historia una vez antes, para saber qué esperar durante la demo | Así, si algo no sale como se esperaba, quien presenta no se sorprende frente al cliente |
Consejo
Si es la primera vez que ejecutás esta demo sobre una historia, probala antes en privado. La primera vez que se ejecuta puede aparecer algún imprevisto (por ejemplo, la app tarda en responder) que preferís descubrir a solas, no en vivo frente al cliente.
Si querés una demo \"desde cero\"
Si ya ensayaste la demo con la misma historia, borrá (o pedile a alguien del equipo técnico que borre) lo que quedó de esa ejecución anterior, así la audiencia ve cada archivo aparecer por primera vez:
- El plan de pruebas:
test-plans/TS-US-08-test-plan.md - Las pruebas automáticas: la carpeta
tests/playwright/TS-US-08/(o la carpeta de tests que tenga configurada el proyecto) - Los reportes:
test-results/reports/TS-US-08-test-report-*.md
Playbook original
El playbook general se encuentra en el repositorio NEO-releases.
3.2 Cómo arrancar la conversación
Antes de arrancar la demo, contale al asistente qué historia vas a mostrar y en qué contexto, así lo tiene presente durante todo el proceso. Por ejemplo:
Vamos a hacer una demo en vivo para el Product Owner de TechStore.
La historia a mostrar es "Finalizar compra" (archivo user-stories/TS-US-08.md).
La app está en https://techstore-staging.com.
Quiero que vayas narrando cada paso y te detengas después de cada uno para que el
Product Owner pueda mirar el resultado y hacer preguntas antes de seguir.
El asistente va a usar esta descripción durante todos los pasos siguientes, así no tenés que repetirla cada vez.
3.3 Paso a paso
Cada uno de estos seis pasos termina con una pausa — el asistente muestra lo que generó y espera antes de avanzar al siguiente. Esa pausa es el momento ideal para que la audiencia pregunte.
Paso 1 de 6 — Leer la historia de usuario
Skill que se usa: lippia-neo-read-user-story
Qué pasa: el asistente lee el documento de la historia ("Finalizar compra") y extrae de ahí lo esencial: qué tiene que cumplir la funcionalidad, en qué URL está, y con qué usuario de prueba hay que entrar.
Qué mostrarle a la audiencia: el documento de la historia abierto, y al lado, lo que el asistente entendió de ese documento.
Checkpoint — Lo que entendió el asistente
"¿Esto es lo que ustedes esperaban que hiciera 'Finalizar compra'? ¿Falta algo?"
Paso 2 de 6 — Armar el plan de pruebas
Skill que se usa: lippia-neo-create-test-plan
Qué pasa: con lo que sacó del Paso 1, el asistente arma una lista concreta de todo lo que hay que probar: el camino normal (el cliente compra y le confirman el pedido), y los casos raros o negativos (por ejemplo, qué pasa si el carrito está vacío, o si se pierde la conexión a mitad de pago).
Qué mostrarle a la audiencia: el documento con la lista de casos a probar, recién creado en la carpeta de planes (por ejemplo, test-plans/TS-US-08-test-plan.md), y cuántos casos salieron por cada requisito de la historia original.
Checkpoint — Casos a probar
"¿Hay algún caso que no se les había ocurrido? ¿Quieren que agreguemos alguno puntual?"
Paso 3 de 6 — Exploración en vivo, dentro de la aplicación real
Skill que se usa: lippia-neo-run-manual-testing
Qué pasa: este es el momento de mayor impacto de toda la demo. El asistente entra a TechStore como lo haría cualquier cliente real — agrega productos, va a pagar, hace clic en "Finalizar compra" — y la audiencia ve todo esto pasar en pantalla, en tiempo real, con un navegador abierto delante de todos. Mientras navega, anota cómo se llaman los botones y campos que usa (después las pruebas automáticas los van a usar para encontrarlos) y saca capturas de pantalla como evidencia.
Qué mostrarle a la audiencia: el navegador navegando solo por la aplicación, y cada hallazgo apareciendo a medida que se descubre (por ejemplo, si algo no se comporta como se esperaba). Todo queda guardado en un informe de la exploración en la carpeta execution/TS-US-08/, junto con las capturas.
La exploración solo recorre pantallas
Este paso solo navega la interfaz de la aplicación en el navegador. Si la demo es sobre una API (sin pantallas), no hay nada que mostrar navegando: las pruebas de la API se arman directamente a partir del plan en el Paso 4 (ver variantes de demo).
Momentos de mayor impacto para la audiencia
- Cuando el asistente encuentra algo inesperado (un bug, una inconsistencia).
- Cuando saca una captura de pantalla de un error real, en el momento en que ocurre.
- Cuando identifica un botón o un campo de la pantalla que después va a usar en las pruebas automáticas.
Checkpoint — Hallazgos de la exploración
"¿Encontramos algo que no esperaban? ¿Este comportamiento les parece correcto?"
Paso 4 de 6 — Generar las pruebas automáticas
Skill que se usa: lippia-neo-generate-test-suite
Qué pasa: con el plan del Paso 2 y todo lo que descubrió navegando en el Paso 3, el asistente escribe las pruebas automáticas — el conjunto de instrucciones que, de ahora en más, se van a poder ejecutar solas, cada vez que se necesite, sin que nadie tenga que repetir los clics a mano.
Qué mostrarle a la audiencia: los archivos de prueba apareciendo en una carpeta con el ID de la historia, dentro de la carpeta de tests del proyecto (por ejemplo, tests/playwright/TS-US-08/), y abrir uno para mostrar que usa exactamente los mismos pasos, botones y campos que se vieron navegar en el Paso 3 (nada se inventa de más).
Checkpoint — Pruebas generadas
"¿Esto se parece a los pasos que acabamos de ver? ¿Ven algo que les genere dudas?"
Paso 5 de 6 — Ejecutar las pruebas y repararlas si hace falta
Skill que se usa: lippia-neo-run-and-heal
Qué pasa: el asistente ejecuta las pruebas automáticas que acaba de generar. Si alguna falla, no se rinde ni te avisa y ya — analiza por qué falló, la ajusta, y la vuelve a ejecutar. Este ciclo se repite hasta 3 veces como máximo, hasta que todo pase o hasta que deja de haber mejoras entre un intento y otro — en ese caso queda claro que ese caso puntual necesita que lo revise una persona. No hace falta pasarle ninguna configuración extra: usa estos valores por defecto.
Qué mostrarle a la audiencia: la consola ejecutando las pruebas, y si hay alguna reparación automática, el ciclo completo: falla → se analiza → se corrige → se vuelve a ejecutar. Al final, el conteo: pruebas que pasaron, que se repararon y que no se pudieron reparar.
Momento de mayor impacto
Cuando una prueba falla y, segundos después, el asistente la repara solo y vuelve a pasar.
Checkpoint — Ciclo de reparación
"¿Qué les pareció el ciclo de reparación automática? Las pruebas que no se pudieron reparar — ¿son un problema real de la aplicación, o una limitación de la prueba en sí?"
Paso 6 de 6 — Reporte final
Skill que se usa: lippia-neo-write-test-report
Qué pasa: el asistente junta todo lo que pasó en la demo — lo que encontró navegando en el Paso 3, y los resultados de ejecutar las pruebas en el Paso 5 — y lo vuelca en un documento único, prolijo, con fecha y hora, que queda guardado como registro histórico (no borra reportes anteriores) en la carpeta de reportes del proyecto (por defecto test-results/reports/, por ejemplo TS-US-08-test-report-2026-07-17-1015.md).
Qué mostrarle a la audiencia: el reporte final abierto, mostrando con claridad el estado general (si todo terminó bien o si quedó algo pendiente de revisar) y la sección que separa lo que se encontró explorando de los resultados de las pruebas automáticas.
Cierre de la demo
"En una sola sesión pasamos de la historia de usuario a un conjunto de pruebas documentado, ejecutado y reportado. Todo esto se puede volver a ejecutar cuando quieran, y queda trazado hasta el requisito original."
3.4 ¿Qué me queda al finalizar los seis pasos?
| Qué obtenés | Para qué te sirve |
|---|---|
| El plan de pruebas de la historia mostrada | Documento de referencia de todo lo que se cubrió |
| Los hallazgos de la exploración en vivo, con capturas | Evidencia de que la funcionalidad se probó de verdad, no "de palabra" |
| Las pruebas automáticas generadas | Quedan disponibles para volver a ejecutarlas en el futuro, sin repetir la demo |
| El reporte final con fecha y hora | Documento único para adjuntar a la aprobación final del cliente o al onboarding de la persona nueva |
| Una audiencia que entendió y confía en el proceso | El objetivo principal de este playbook — no es solo "probar", es "mostrar cómo se prueba" |
4. Variantes de demo
Según el tipo de aplicación configurado en qa-stack.yaml y el tiempo que tengas, la demo puede tomar distintas formas:
| Variante | Qué cambia |
|---|---|
| Demo de pantallas (aplicación web) | El énfasis está en la exploración visual con el navegador del Paso 3 |
| Demo de API (sin pantallas) | El énfasis está en las pruebas de API generadas en el Paso 4; el Paso 3 solo explora pantallas, así que acá aporta poco o nada |
| Demo híbrida (pantallas + API) | Se generan pruebas de pantallas y de API (la exploración del Paso 3 cubre solo las pantallas); es más larga, pero tiene mayor impacto |
| Demo express | Si ya hay hallazgos de una exploración previa, se saltea el Paso 3 y se arranca desde el Paso 4 |
5. ¿Y después? — Qué hacer una vez terminada la demo
| Situación | Qué hacer |
|---|---|
| ✅ El cliente dio el visto bueno ("aprobación final") sobre la historia mostrada | Se cierra la historia como aceptada; las pruebas generadas quedan como parte de la cobertura del proyecto |
| ❌ La exploración en vivo encontró un bug real | Se documenta como tal y se sigue con el playbook de reproducción de bugs, para confirmarlo formalmente y pasarlo a desarrollo |
| La persona nueva del equipo ya vio el flujo completo | Puede empezar a ejecutar el flujo normal de QA (sin narrativa ni pausas) sobre sus propias historias |
| Se grabó la demo para uso comercial o interno | El video queda disponible para mostrarle el proceso a otros clientes o áreas, sin tener que repetir la sesión en vivo cada vez |
6. Problemas comunes (y qué hacer)
| Lo que ves | Por qué puede pasar | Qué hacer |
|---|---|---|
| El navegador no abre durante el Paso 3 | La herramienta que controla el navegador no está conectada | Verificarlo antes de que arranque la reunión, nunca en vivo frente al cliente |
| La historia no tiene criterios claros | La historia está mal redactada o incompleta | Reescribir la historia antes de la demo — el asistente solo puede extraer lo que el documento realmente dice |
| Las pruebas fallan con un error de conexión | El ambiente de pruebas (staging) no está disponible | Levantar y verificar el ambiente antes de empezar |
| Las pruebas fallan en el login durante la reparación | Las credenciales de prueba del proyecto (archivo .env.tests) están vacías |
Pedirle a alguien del equipo técnico que complete los valores reales antes de repetir el Paso 5 — nunca se escriben a mano dentro de las pruebas |
| La demo se siente muy larga para la audiencia | La historia elegida tiene demasiados criterios de aceptación | Elegir una historia más acotada (2 o 3 criterios) para una demo corta, o saltar directo al Paso 4 si ya existen hallazgos de una exploración previa (demo express) |
7. Resumen visual del flujo
flowchart TD
A([🎬 Historia de usuario a mostrar<br/>ej: Finalizar compra<br/>en TechStore]) --> B
B["<b>Paso 1</b> — Leer la historia<br/>⏸ pausa para preguntas"] --> C
C["<b>Paso 2</b> — Armar el plan de pruebas<br/>⏸ pausa para preguntas"] --> X{¿Demo express con<br/>hallazgos previos?}
X -->|No| D["<b>Paso 3</b> — Exploración en vivo<br/>⭐ momento de mayor impacto<br/>⏸ pausa para preguntas"]
X -->|Sí, saltear Paso 3| E
D --> E["<b>Paso 4</b> — Generar las pruebas<br/>automáticas<br/>⏸ pausa para preguntas"]
E --> F["<b>Paso 5</b> — Ejecutar y reparar<br/>las pruebas<br/>⏸ pausa para preguntas"]
F --> G["<b>Paso 6</b> — Reporte final<br/>🎤 cierre de la demo"]
G --> H([✅ Audiencia que vio, entendió<br/>y confía en cómo se prueba])