Frontend UI Change PR
Esta guía explica qué es un playbook de control de calidad (QA) y qué hace exactamente el playbook "Frontend UI Change PR". 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 revisión del cambio salga bien — sin necesidad de saber programar.
En resumen
- Para qué sirve: confirmar que un cambio de pantalla subido como Pull Request no rompió nada antes de aprobarlo.
- Cuándo usarlo: cuando un PR de frontend modifica botones, formularios o pantallas que ya existían, o agrega una interacción nueva.
- Qué necesitás: el número del PR, el ticket (o la lista de cambios), la URL de staging con el PR desplegado y el
qa-stack.yamldel proyecto. - Qué te llevás: la suite existente reparada, pruebas nuevas para lo nuevo (si hubo) y un reporte con el detalle de cada identificador corregido, listo para adjuntar al PR.
- Pasos: 6 — leer el ticket, recorrer la pantalla, reparar la suite, generar pruebas para lo nuevo, ejecutar todo y reportar (con 2 pausas para que decidas vos).
¿Qué es un playbook? (si es la primera vez que usás uno)
Es, por ejemplo, la checklist que sigue un piloto antes de despegar: no improvisa cada vez, sigue una secuencia probada de pasos. Un playbook es esa misma idea aplicada a probar una aplicación: una receta escrita que le indica al modelo de IA, paso a paso, qué hacer usando diferentes elementos/herramientas llamadas "Skills".
¿Qué es una "Skill"? Una skill es la herramienta puntual que ejecuta cada paso del Playbook. Interactuás con el playbook — el asistente se encarga de usar la herramienta correcta en cada momento.
Parte de este flujo también existe como plan automático
La reparación de la suite (Paso 3) se puede ejecutar sin el asistente, desde el pipeline de CI, con el plan UI Selector Repair: corrige solo los selectores que el código del cambio renombró, sin explorar la app ni generar pruebas nuevas.
1. ¿Qué hace este playbook?
Es el playbook que usás cuando un desarrollador ya modificó una pantalla y subió ese cambio como Pull Request (PR), y necesitás confirmar que no rompió nada antes de aprobarlo.
Pensalo así: un Pull Request (PR) es un cambio de código que un desarrollador ya armó, pero que todavía no llegó a los usuarios reales — está guardado aparte, esperando que alguien lo revise y diga "está bien, se puede publicar". Ese "alguien" es este playbook.
A diferencia de otros playbooks, acá no se arranca de una historia de usuario — se arranca de una pantalla que ya existe, construida. El asistente recorre esa pantalla nueva como lo haría un usuario real, y hace tres cosas con lo que encuentra:
- Si algo dejó de funcionar solo porque cambió un identificador interno (el botón sigue estando y haciendo lo mismo, pero por dentro cambió de "nombre"), lo repara él solo.
- Si encuentra algo que directamente no existía antes (un campo nuevo, un paso nuevo), te pregunta si hace falta cubrirlo con una prueba nueva.
- Si el comportamiento cambió de verdad (no es un tema de nombres, la pantalla no hace lo que el ticket dice que debería hacer), no lo esconde: lo deja anotado como un problema real.
Qué dispara este playbook
Este playbook lo dispara un Pull Request ya subido — el punto de partida es el cambio que el desarrollador ya hizo, no una decisión de QA de revisar algo.
2. ¿Cuándo tengo que usar este playbook?
Usalo cuando estés frente a alguna de estas situaciones:
| Situación | Ejemplo de negocio |
|---|---|
| Un Pull Request modifica componentes, formularios o botones de una pantalla que ya existía | El equipo de desarrollo de TechStore subió un PR que mueve el botón "Finalizar compra" arriba de todo y agrega un campo nuevo para aplicar un cupón de descuento en el carrito |
| Las pruebas que ya existían empiezan a fallar después del cambio | Las pruebas automáticas del carrito de TechStore, que venían pasando bien, ahora fallan — hay que confirmar si es porque algo se rompió de verdad o porque solo cambió un identificador interno |
| Se necesita evidencia de QA antes de aprobar el merge | El líder técnico de TechStore no quiere aprobar el PR "de palabra" — quiere un reporte que confirme que el carrito sigue funcionando |
| El PR agrega una interacción nueva que no existía | El campo de cupón de descuento es una funcionalidad nueva dentro del carrito y necesita una prueba propia, no solo revisar que lo viejo siga andando |
Importante
- Si el cambio parte de una historia de usuario en blanco, sin pantalla previa construida, este no es el playbook indicado — ahí se usa Feature New End to End.
- Este playbook necesita que el proyecto ya tenga el archivo con el stack tecnológico (
qa-stack.yaml) armado de antes. Si es la primera vez que se hace QA automatizado sobre esta aplicación, primero hay que ejecutar New Project Bootstrap. - Necesita que el cambio esté desplegado en un ambiente de pruebas (staging), accesible por una URL — no alcanza con el código sin desplegar.
3. Ejemplo guía: "TechStore", una tienda online con carrito de compras
Vamos a seguir el mismo caso de negocio de ejemplo que usan otras guías: TechStore, una tienda online de electrónica con las partes típicas de cualquier tienda que reconocerías por haber comprado online alguna vez: login, catálogo, carrito de compras y checkout.
Supongamos este escenario: el equipo de desarrollo de TechStore terminó de programar dos cambios en el carrito y los subió juntos como el Pull Request #142:
- Movieron el botón "Finalizar compra" desde el final de la página hacia arriba de todo.
- Agregaron un campo nuevo para aplicar un cupón de descuento.
El PR ya está desplegado en un ambiente de pruebas, esperando revisión antes de aprobar el merge a producción. Ese es exactamente el escenario para el que se usa este playbook.
A lo largo de los pasos siguientes vamos a ver qué le responderías al asistente en cada momento, usando este PR 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 |
|---|---|
| El número o nombre del Pull Request | PR #142 (el asistente lo usa como PR-142, sin espacios ni símbolos, para nombrar las carpetas y archivos de todos los pasos) |
| El ticket o la descripción de los cambios | Ticket TS-US-14 (o, si no hay ticket, la lista escrita: "botón movido" + "campo de cupón nuevo") |
| La URL del ambiente donde está desplegado el PR | https://techstore-staging.com/preview/142 |
| La suite de pruebas existente para esa pantalla (si la hay) | tests/playwright/carrito/ — vive dentro de la carpeta de tests del proyecto (paths.tests_dir en qa-stack.yaml, por defecto tests/playwright/). Si no existe todavía, no es un problema: se lo indicás al asistente en el Checkpoint 1 y directamente se generan pruebas nuevas para todo, sin pasar por el Paso 3 de reparación |
¿No sabés de dónde sacar alguno de estos datos?
Es normal, no hace falta ser una persona técnica para conseguirlos:
- El número del PR te lo pasa el desarrollador cuando avisa "ya está listo para probar", o lo ves vos misma/o entrando al repositorio (GitLab o GitHub) → sección "Merge requests" / "Pull requests" → aparece listado con un número al lado del título.
- El ticket normalmente te lo pasa el desarrollador como un link (Jira o Azure DevOps). Si no hay ticket, no pasa nada: alcanza con que el desarrollador te cuente en dos o tres frases qué cambió.
- La URL de staging casi siempre queda escrita como comentario automático dentro del mismo Pull Request ("Preview deployed at..."), o te la pasa el desarrollador directamente.
- La suite existente: esto no hace falta que lo sepas vos — si no tenés idea, escribí "no existe aún" y el asistente lo revisa solo en la configuración del proyecto.
Playbook original
El playbook general se encuentra en el repositorio NEO-releases.
3.2 Cómo arrancar
Antes de pedirle el primer paso, contale al asistente los datos del PR, todo junto en un solo mensaje. Siguiendo el ejemplo de TechStore:
Te brindo la información de los cambios implementados en el frontend, quiero
que solo lo tomes como contexto, no quiero que realices ninguna acción adicional.
Datos del trabajo:
- PR: PR #142 — usá como <PR-ID> el identificador PR-142, ya que se usa para
nombrar archivos y carpetas en todos los pasos
- Ticket / historia: TS-US-14
- URL del ambiente con el PR: https://techstore-staging.com/preview/142
- Suite existente: carrito (dentro de tests/playwright/)
Cambios UI declarados por el dev:
- Botón "Finalizar compra" movido arriba de todo
- Campo nuevo para aplicar un cupón de descuento
El asistente va a usar ese contexto durante todos los pasos siguientes — no hace falta repetirlo cada vez.
De dónde sale cada dato
- El ticket o los cambios declarados → los pasás vos en ese mensaje (los "Cambios UI" son opcionales si hay ticket).
- La URL de la app → el asistente la saca del ticket si está; si no, la mencionás vos en el mensaje.
- La carpeta de pruebas y el resto de la configuración → el asistente los lee solo de
qa-stack.yaml.
3.3 Paso a paso
Paso 1 de 6 — Leer el ticket o la descripción del cambio
Skill que se usa: lippia-neo-read-user-story
Qué pasa: si hay un ticket, el asistente lo lee con este comando y extrae qué cambió, en qué URL probarlo, y con qué credenciales. Si no hay ticket, este paso se saltea directamente — el asistente ya tiene todo lo que necesita de los datos que le diste en el mensaje de arranque (sección 3.2), no hace falta que le pidas nada extra: usa la lista de cambios declarados como lo que hay que revisar, y deja anotado en el reporte final que no hubo ticket de referencia. En ambos casos, si algo no coincide con lo que el desarrollador contó en el PR, te lo señala antes de seguir.
Checkpoint — ¿El resumen coincide con el PR?
El resumen que te muestra el asistente tiene que coincidir con lo que vos ya sabías del PR. Si menciona algo que no esperabas (funcionalidades no declaradas, un alcance más amplio), es momento de aclararlo con el desarrollador antes de continuar.
Paso 2 de 6 — Recorrer la pantalla nueva como lo haría un usuario real
Skill que se usa: lippia-neo-run-manual-testing
Qué pasa: el asistente entra realmente a TechStore desde el navegador, navega el carrito, hace clic en el botón "Finalizar compra" desde su nueva posición, prueba el campo de cupón — y va anotando todo lo que encuentra, junto con los identificadores reales de cada botón y campo que tocó y capturas de pantalla de cada componente modificado.
Como un PR no tiene un plan de pruebas armado, el asistente explora a partir de la lista de cambios del Paso 1. Para eso necesita sí o sí el identificador del PR (PR-142): sin él no arranca, porque lo usa para nombrar la carpeta donde guarda todo. Pegale este mensaje completo:
/lippia-neo-run-manual-testing
Usá us_id: PR-142 y free_exploration (description = cambios UI del Paso 1,
expected = ACs / cambios declarados, url = URL del Paso 1).
Foco en los cambios UI del PR.
Capturá los selectores actuales (data-test, aria-label), screenshots de los componentes
modificados y documentá cualquier flow de navegación nuevo.
En las notas de cada finding indicá si es selector-roto, flow-nuevo o comportamiento-inesperado.
Cada hallazgo queda clasificado en una de estas tres categorías (la clasificación la pide el mensaje de arriba y queda escrita en las notas de cada hallazgo):
| Categoría | Qué significa | Qué hace el asistente con eso |
|---|---|---|
| Selector roto | El botón sigue funcionando igual para el usuario, pero cambió su identificador interno | Lo repara en el Paso 3, sin necesitar tu intervención |
| Flujo nuevo | Una interacción que directamente no existía antes (el campo de cupón) | Se te pregunta en el Checkpoint 1 si hace falta cubrirlo con una prueba nueva |
| Comportamiento inesperado | La pantalla no responde como el ticket dice que debería | Queda documentado como un defecto real |
Lo que este paso NO hace
La exploración solo navega la pantalla, como lo haría una persona con el navegador. No llama directamente a servicios internos (APIs) ni revisa el código.
Cómo saber si salió bien: queda un reporte con capturas de pantalla de cada componente tocado, la lista de identificadores capturados, y los hallazgos ya clasificados en una de las tres categorías de arriba. Con TechStore, todo queda en la carpeta de exploraciones del proyecto (por defecto execution/):
| Archivo | Para qué sirve |
|---|---|
execution/PR-142/PR-142-scripted-execution-report.md |
El reporte legible, para que lo revises vos |
execution/PR-142/PR-142-scripted-execution-report.json |
La misma información en formato para el asistente, que se usa en el Paso 4 |
execution/PR-142/screenshots/ |
Las capturas de pantalla como evidencia |
⏸ Checkpoint 1 — ¿Hay algo nuevo que cubrir?
Pausa obligatoria antes del Paso 3
Este es el primer momento del playbook donde el asistente se detiene a esperar tu decisión antes de seguir — por eso conviene revisar bien el reporte del Paso 2 (execution/PR-142/PR-142-scripted-execution-report.md) antes de responder.
| Resultado de la exploración | Qué significa | Qué le respondés al asistente |
|---|---|---|
| Se encontró al menos un flujo nuevo (en TechStore: el cupón) | Hace falta generar una prueba específica para eso | "Hay flows nuevos: 'Aplicar cupón de descuento'. Continuar con healing y generar tests nuevos." |
| Solo se encontraron selectores rotos, nada nuevo (o es un cambio puramente visual, o lo nuevo ya tenía pruebas de antes) | Alcanza con reparar lo que ya existía | "Solo selectores rotos, no hay flows nuevos. Continuar solo con healing." |
| No existía suite previa para esta pantalla (dijiste "no existe aún" en la sección 3.2) | No hay nada que reparar — hay que tratarlo igual que si todo fuera nuevo, aunque no se haya detectado un flujo nuevo puntual | "No existe suite previa. Tratarlo como flujo nuevo y generar tests para todo desde cero." |
Paso 3 de 6 — Reparar la suite existente
Skill que se usa: lippia-neo-run-and-heal
Qué pasa: el asistente ejecuta las pruebas que ya existían del carrito contra la pantalla nueva. Antes de la primera ejecución, completa los datos pendientes que hayan quedado en las pruebas (valores marcados como TODO) y reemplaza credenciales escritas a mano por las del archivo de credenciales del proyecto. Después, por cada prueba que falla, averigua el motivo: lo que falla solo porque cambió un identificador interno (por ejemplo, el botón "Finalizar compra" ahora tiene otro nombre técnico por haberse movido), lo corrige buscándolo en la pantalla actual. Lo que falla porque el comportamiento cambió de verdad, no lo fuerza a pasar — lo deja marcado como un problema real que necesita que lo mire una persona.
Pegale este mensaje, indicando la carpeta de la suite existente (relativa a la carpeta de tests del proyecto):
/lippia-neo-run-and-heal
Ejecutá con max_iterations=3 e include_dirs=["carrito"]
En fix_applied de cada selector reparado indicá línea, selector anterior y selector nuevo.
Si el proyecto usa Lippia en vez de Playwright
Con Lippia no se puede acotar la ejecución a una carpeta: el asistente ejecuta todas las pruebas del proyecto y deja anotado que no pudo limitarlo.
Si no había suite previa
Si respondiste "no existe aún" y en el Checkpoint 1 lo marcaste como flujo nuevo, este paso se saltea directamente, no hay nada para reparar. Se pasa de largo al Paso 4, donde se genera todo desde cero.
Qué se puede reparar y qué no:
| Se puede reparar así | Nunca se repara así — se marca como defecto |
|---|---|
| Actualizar el identificador interno de un botón o campo que cambió de nombre | Cambiar lo que se esperaba que pasara para que coincida con un comportamiento incorrecto |
| Actualizar una URL o ruta de navegación que el PR modificó | Marcar una prueba como "saltear" sin dejar por escrito el motivo |
| Ajustar el tiempo de espera si la pantalla nueva tarda más en cargar | Borrar la verificación en lugar de corregir el identificador |
Ojo con las verificaciones cambiadas
Si una prueba falla porque el resultado esperado no coincide, el asistente puede actualizar esa verificación cuando cree que el cambio de pantalla fue intencional. Revisá esas correcciones en el Checkpoint 2 contra la columna de la derecha de la tabla: si alguna "acomoda" la prueba a un comportamiento incorrecto, es un defecto, no una reparación.
Cómo saber si salió bien: queda un resumen con cuántas pruebas fallaban al empezar, cuántas quedaron aprobadas al final, cuántos intentos hicieron falta (de un máximo de 3), cuántos identificadores se corrigieron y cuántas pruebas quedaron marcadas como defecto. El asistente para cuando todo queda aprobado, cuando un intento no mejora nada respecto del anterior, o cuando llega a los 3 intentos. El detalle de cada ejecución queda guardado en la carpeta de reportes del proyecto (archivo run-and-heal-<fecha>.json).
⏸ Checkpoint 2 — ¿Se reparó de más?
Pausa obligatoria antes de seguir
Corregir muchas cosas no es un problema de las pruebas — es una señal de que el cambio real del PR es más grande de lo que el desarrollador declaró.
| Señal de alerta | Qué implica |
|---|---|
| ⚠️ Más de 5 correcciones en un mismo archivo | El componente fue rehecho, no retocado |
| ⚠️ 30% o más de la suite necesitó corrección | El alcance real es mayor al declarado |
| ⚠️ Se corrigieron flujos que el ticket no menciona | El PR tocó más pantallas de las anunciadas |
| ⚠️ Hicieron falta más de 2 intentos y seguía sin aprobar | La pantalla nueva puede tener inconsistencias propias |
Si ves alguna señal de alerta, respondele al asistente:
Hay reparación excesiva en el módulo de carrito — [detalle de lo que te llamó la atención].
Pausar y consultar con el dev si el alcance del PR es correcto.
Si el número de correcciones te parece razonable para el cambio descripto:
Reparación dentro de lo esperado. Continuar con [generar tests nuevos / el reporte].
Paso 4 de 6 — Generar pruebas para lo nuevo (solo si en el Checkpoint 1 dijiste que había algo nuevo)
Skill que se usa: lippia-neo-generate-test-suite
Qué pasa: el asistente escribe pruebas puntuales para el cupón de descuento, usando los identificadores reales que capturó en el Paso 2 — sin tocar ni pisar las pruebas del carrito que ya existían. Para eso le indicás el archivo de resultados que dejó el Paso 2 (el .json, tal como lo devolvió el asistente — no hace falta armarlo a mano):
/lippia-neo-generate-test-suite
Usá manual_execution_report_path: execution/PR-142/PR-142-scripted-execution-report.json
Generá tests SOLO para los flows nuevos identificados en el Paso 2.
Usá los selectores capturados en la exploración. No regeneres tests existentes.
Si algo falló en la exploración
Si en el Paso 2 algún recorrido terminó con error, el asistente genera además una prueba específica para ese error (es obligatorio), así queda vigilado en el futuro.
Cómo saber si salió bien: aparece una carpeta de pruebas nueva, separada de la suite original, con al menos una prueba por cada flujo nuevo identificado. Con TechStore queda en tests/playwright/PR-142/ (por ejemplo, tc-001-aplicar-cupon.spec.js). El asistente te confirma la carpeta real en su respuesta — usá esa en el Paso 5.
Paso 5 de 6 — Ejecutar todo de nuevo hasta que quede aprobado (solo si ejecutó el Paso 4)
Skill que se usa: lippia-neo-run-and-heal
Qué pasa: el asistente ejecuta la suite reparada del Paso 3 junto con las pruebas nuevas del Paso 4, todas juntas, y repara lo que quede pendiente de las pruebas nuevas (hasta 2 intentos). Si algo sigue fallando de verdad, queda documentado como un defecto de la aplicación — no se esconde. La suite original ya debería estar aprobada desde el Paso 3: si acá vuelve a fallar, se documenta como un efecto colateral de las pruebas nuevas.
/lippia-neo-run-and-heal
Ejecutá con max_iterations=2 e include_dirs=["carrito", "PR-142"]
Siempre indicá las dos carpetas
No ejecutes la carpeta de tests completa: apuntá siempre a la suite del carrito y a la carpeta de las pruebas nuevas. Así no se arrastran pruebas de otros módulos o aplicaciones que puedan convivir en el mismo repositorio.
Paso 6 de 6 — Reporte final con evidencia
Skill que se usa: lippia-neo-write-test-report
Qué pasa: el asistente junta todo lo hecho en los pasos anteriores (la exploración del Paso 2 y las ejecuciones de los Pasos 3 y 5) y escribe un reporte final con capturas de pantalla, y un detalle línea por línea de cada identificador que se corrigió (de qué nombre a cuál), listo para adjuntar al PR como evidencia. Ese detalle se agrega porque se lo pedís en el mensaje:
/lippia-neo-write-test-report
Usá us_id: PR-142
Incluí el audit trail de selectores reparados en el reporte
Cómo saber si salió bien: el reporte incluye la suite base aprobada, el detalle de cada corrección, las pruebas nuevas (si las hubo), y queda guardado con fecha y hora sin pisar reportes anteriores. Con TechStore queda en la carpeta de reportes del proyecto (por defecto test-results/reports/), por ejemplo: PR-142-test-report-2026-07-17-1015.md.
¿Por qué el reporte dice que la cobertura \"no es evaluable\" o que falta la referencia al origen?
La cobertura se mide contra los criterios de aceptación del ticket. Si el PR no tenía ticket (o el ticket no traía criterios), el reporte no tiene contra qué medir y lo marca como "no evaluable"; y si no hubo ticket, lo indica en el encabezado como falta de referencia al origen. Es esperable y no indica ningún problema.
3.4 ¿Qué me queda al finalizar todos los pasos?
| Qué obtenés | Para qué te sirve |
|---|---|
| Un reporte de la exploración con capturas de pantalla | Evidencia de que alguien (el asistente) realmente probó la pantalla nueva del PR |
| La suite existente reparada y aprobada | Confirmación de que el cambio no rompió el carrito |
| El detalle de cada identificador corregido, de dónde a dónde | Trazabilidad para que el revisor del PR confirme que cada cambio de selector es correcto |
| Pruebas nuevas para lo que el PR agregó (si hubo algo nuevo) | Cobertura del cupón de descuento, lista para correrse en el futuro |
| Un reporte final con fecha y hora | El documento que adjuntás al PR como respaldo para aprobar — o frenar — el merge |
A partir de acá, el equipo de TechStore puede aprobar el merge del PR #142 con evidencia real de que el carrito sigue funcionando y que el cupón nuevo quedó probado.
4. ¿Y si lo ejecuta el pipeline solo? — Rama smoke o regresión completa
Más adelante, este playbook también va a poder ejecutar solo, dentro del pipeline, sin que nadie lo pida. En ese modo no hay pausas para que decidas vos: en su lugar, antes de arrancar, una herramienta clasificadora (lippia-neo-classify-ui-scope) lee el cambio de código del PR y su descripción, y decide qué tan grande es el cambio:
| Decisión del clasificador | Qué ejecuta |
|---|---|
| Smoke (cambio chico y aislado) | Solo una pasada rápida de la suite existente, reparando lo que se pueda (hasta 2 intentos). Sin exploración ni reporte |
| Regresión completa (cambio amplio o riesgoso) | Los 6 pasos de esta guía, uno detrás del otro, sin las pausas de los checkpoints |
Algunos criterios que usa para decidir:
| Señal en el cambio del PR | Alcance que elige |
|---|---|
| Cambio en un único componente aislado | Smoke |
| Cambio en estilos o colores | Smoke |
| Cambio en la estructura general de las pantallas o en la navegación | Regresión completa |
| Cambio en formularios o flujos de negocio | Regresión completa |
| Cambio en el login o en los permisos de acceso a pantallas | Regresión completa |
| Más de 10 archivos modificados | Regresión completa |
| Una página, ruta o componente nuevo, o un alcance que no queda claro | Regresión completa (ante la duda, elige siempre la completa) |
Mientras tanto
Hasta que este modo automático esté activo, el alcance lo decidís vos a mano en el Checkpoint 1.
5. Problemas comunes (y qué hacer)
| Lo que ves | Por qué puede pasar | Qué hacer |
|---|---|---|
| La exploración del Paso 2 no encuentra nada para hacer clic | El ambiente de staging del PR no terminó de desplegarse | Confirmar con el equipo técnico que la URL está activa antes de reintentar |
| La reparación del Paso 3 llega a los 3 intentos (o deja de mejorar) sin quedar aprobada | El componente fue rehecho desde cero, no retocado | Pausar, revisar las señales del Checkpoint 2 y consultar con el desarrollador el alcance real del PR |
| Las pruebas nuevas del Paso 4 usan identificadores incorrectos | La exploración del Paso 2 no capturó todos los elementos del flujo nuevo | Repetir el Paso 2 con foco explícito en los elementos de ese flujo |
| La suite base vuelve a fallar en el Paso 5 (estaba verde en el Paso 3) | Las pruebas nuevas dejaron datos que interfieren con las demás | Agregar una limpieza de estado entre pruebas y repetir el Paso 5 |
| El reporte final no muestra ninguna corrección | Es el mejor escenario posible: el PR no rompió ningún identificador existente | No es un error — seguir normalmente |
| El asistente frena diciendo que la herramienta de testing está "en estado STUB" | La herramienta de testing del proyecto todavía no tiene soporte completo | Es un tema para el equipo técnico, no algo que puedas resolver sola/o |
| Las pruebas fallan en el login | Las credenciales de prueba del proyecto (archivo .env.tests) están vacías o incompletas |
Avisarle a alguien del equipo técnico para que complete los valores reales — nunca se escriben a mano dentro de las pruebas — y repetir el Paso 3 o el 5 |
6. Resumen visual del flujo
flowchart TD
A([🔀 PR de frontend en staging<br/>ej: PR #142 en TechStore,<br/>botón movido + cupón nuevo]) --> M{¿Quién lo ejecuta?}
M -->|Vos, a mano| P1
M -->|El pipeline, solo| CL{¿Qué tan grande<br/>es el cambio?}
CL -->|Chico y aislado: smoke| SM["Pasada rápida de la suite<br/>existente, sin exploración<br/>ni reporte"]
CL -->|Amplio o riesgoso: completa| FU["Pasos 1 a 6<br/>sin pausas"]
SM --> Z
FU --> Z
P1["<b>Paso 1</b> — Leer el ticket<br/>o la descripción"] --> P2
P2["<b>Paso 2</b> — Recorrer la pantalla nueva<br/>y clasificar hallazgos"] --> C1{"⏸ Checkpoint 1<br/>¿Hay algo nuevo?"}
C1 -->|Sí, hay flujo nuevo| P3A
C1 -->|No existía suite previa| P4
C1 -->|No, solo selectores rotos| P3B
P3A["<b>Paso 3</b> — Reparar la suite<br/>existente"] --> C2A{"⏸ Checkpoint 2<br/>¿Se reparó de más?"}
P3B["<b>Paso 3</b> — Reparar la suite<br/>existente"] --> C2B{"⏸ Checkpoint 2<br/>¿Se reparó de más?"}
C2A -->|Sí| X([⚠️ Pausar y consultar<br/>con el desarrollador])
C2B -->|Sí| X
C2A -->|No, es proporcional| P4
C2B -->|No, es proporcional| P6
P4["<b>Paso 4</b> — Generar pruebas<br/>para lo nuevo"] --> P5
P5["<b>Paso 5</b> — Ejecutar todo de nuevo<br/>hasta aprobar"] --> P6
P6["<b>Paso 6</b> — Reporte final<br/>con evidencia"] --> Z
Z([✅ PR listo para aprobar<br/>o frenar el merge,<br/>con evidencia real])