Saltar a contenido

Business Rule Change

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 el trabajo salga bien — sin necesidad de saber programar.

En resumen

  • Para qué sirve: actualizar solo las pruebas que afecta una regla de negocio que cambió a propósito, sin rehacer todo el módulo y sin perder los casos viejos.
  • Cuándo usarlo: cuando una regla ya documentada y probada cambió por una decisión del negocio y la historia de usuario ya está actualizada.
  • Qué necesitás: la historia actualizada, el plan y la suite de pruebas anteriores del módulo, qué regla cambió (antes y después) y alguien que pueda confirmar las decisiones.
  • Qué te llevás: el plan y la suite al día, los casos obsoletos archivados con su razón, la regresión del módulo y un reporte con el "antes" y el "después".
  • Pasos: 5 — detectar qué cambió, regenerar el plan, archivar lo obsoleto y regenerar la suite, ejecutar y reparar, y reportar (con dos pausas de revisión humana en el medio).

Nombre funcional

"Cambio de regla de negocio". Se usa cuando una regla que ya estaba documentada y probada cambia intencionalmente (no es un bug, es una decisión de negocio) y hace falta actualizar solo lo que ese cambio afecta.

¿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".

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.


1. Conceptos clave antes de arrancar

Si alguno de estos términos te resulta nuevo, abrilo para ver la explicación:

Regla de negocio y \"base de prueba\"

Una regla de negocio es una condición que la aplicación tiene que cumplir sí o sí porque así lo decidió el negocio (negocio = el área que solicita el requerimiento a crear) — no es una preferencia de diseño, es una norma. Ejemplos: "la contraseña debe tener mínimo 8 caracteres", "una transferencia de más de $50.000 pide un segundo factor de autenticación", "en roaming, los primeros 500MB son gratis".

El documento (o conjunto de documentos) donde esa regla queda escrita es una historia de usuario; en terminología de testing, la base de prueba: es el material contra el que se decide si la aplicación está bien o mal, el material que el tester/QA usaría como base de su análisis para generar todos los casos de prueba que luego ejecutaría (si no tuviera un agente). Cuando la regla cambia, lo primero que cambia es la base de prueba (se actualiza la historia y, por ende, los casos de prueba).

Historia de usuario y criterio de aceptación (AC)

Una historia de usuario describe una funcionalidad desde el punto de vista de quien la usa, sin entrar en detalles técnicos de cómo está construida. Dentro de una historia hay varias reglas puntuales: cada una de esas reglas es un criterio de aceptación (AC) — pensalo como una línea suelta de una lista de inspección de un auto ("el freno de mano sostiene en pendiente"). Cuando una regla de negocio cambia, en general lo que cambia puntualmente es uno o varios AC de la historia: se agregan, se reescriben o se eliminan.

Caso de prueba (Test Case)

Un caso de prueba es una prueba puntual y concreta: tiene pasos de entrada, una condición de partida, y un resultado esperado — está pensada para comprobar una sola cosa, por lo general un solo criterio de aceptación. Es como una única pregunta de examen: no evalúa toda la materia, evalúa un punto puntual del programa.

Cuando una regla cambia, los casos de prueba que validaban la regla vieja quedan desactualizados — no porque estén mal escritos, sino porque preguntan por algo que ya no es la norma vigente, por lo que siempre deberían actualizarse.

Prueba de regresión (Regression Testing)

Una prueba de regresión es volver a ejecutar las pruebas que ya existían, después de un cambio, para confirmar que ese cambio no rompió nada de lo que ya andaba bien (casos de prueba anteriores, ya existentes, no relacionados con esta historia de usuario actual). Es como cuando el mecánico, después de arreglarte los frenos, también prueba las luces y la dirección — no porque sospeche de ellas, sino para confirmar que tocar una parte del auto no desacomodó otra.

Este playbook ejecuta una regresión del módulo completo (no solo de los casos que tocan la regla que cambió), porque un cambio de regla puede tener efectos en flujos vecinos del mismo módulo que a simple vista no parecen relacionados. No ejecuta la aplicación entera — el alcance queda acotado al módulo de la historia de usuario que cambió.

Mantenimiento y retiro de casos de prueba (archivado)

El mantenimiento de pruebas es la tarea de mantener al día los casos de prueba existentes a medida que la aplicación (o la regla que describen) cambia — para que sigan detectando problemas reales y no queden hablando de un comportamiento que ya no existe.

Parte de ese mantenimiento es el retiro de casos de prueba que quedaron obsoletos: cuando un caso ya no corresponde a ninguna regla vigente, se archiva — se lo mueve a una carpeta aparte con la razón por la que quedó fuera de vigencia — pero no se borra. Guardarlo (en vez de borrarlo) preserva la trazabilidad: en el futuro, cualquiera puede abrir ese archivo y entender qué regla validaba y por qué dejó de aplicar, en vez de encontrarse con un vacío sin explicación.

Reparación automática de pruebas (\"self-healing\")

Es la capacidad de detectar cuándo un caso de prueba falló por un motivo menor y esperable (por ejemplo, el resultado correcto cambió de valor porque la regla cambió) y ajustarlo solo, sin que una persona tenga que reescribir el código de la prueba a mano. A esta capacidad se la llama reparación automática o "self-healing".

Es una ayuda real — ahorra horas de trabajo manual — pero no es infalible: por eso este playbook incluye un control humano específico para revisar lo que la reparación automática decidió (ver "Supervisión humana" más abajo).

Falso negativo (y por qué \"todo en verde\" no siempre alcanza en los reportes)

Un falso negativo es cuando una prueba da por buena una situación que en realidad está mal: la prueba "pasa" (queda en verde), pero no porque la aplicación esté correcta, sino porque la prueba dejó de exigir lo que debía exigir. Es como un detector de humo al que le sacaron la pila: no suena, pero no porque no haya humo — no suena porque no puede detectar nada.

Este es el riesgo concreto de la reparación automática: si ajusta una prueba para que pase, pero el valor nuevo que acepta no coincide con lo que en verdad pide la regla actualizada, la suite completa queda en verde tapando un problema real. Por eso, en este playbook, cada ajuste automático se revisa a mano antes de darlo por bueno.

Supervisión humana (por qué hay pasos que no se delegan)

No toda decisión de este proceso conviene dejarla en manos del asistente. Decidir qué caso de prueba archivar (¿es realmente obsoleto, o todavía sirve para otra cosa?) y validar que un ajuste automático es correcto (¿el nuevo valor realmente coincide con la regla nueva?) son juicios que requieren criterio de negocio — contexto que el asistente no siempre tiene completo. Por eso este playbook tiene dos puntos de control marcados como manuales, en los que el trabajo se detiene hasta que una persona confirma antes de seguir.


2. ¿Qué hace este playbook?

Es el playbook que usás cuando una regla de negocio que ya estaba documentada y probada cambió — a propósito, por una decisión del negocio — y la historia de usuario ya se actualizó para reflejar ese cambio.

En vez de rehacer todo el plan de pruebas del módulo desde cero, este playbook:

  1. Detecta exactamente qué cambió comparando la historia actualizada contra el plan de pruebas anterior (el "antes" contra el "después").
  2. Regenera solo los casos de prueba de las reglas nuevas o modificadas — deja intactos los que no se tocaron.
  3. Archiva (no borra) los casos de prueba que la nueva regla dejó sin sentido, con la razón documentada.
  4. Ejecuta la suite completa del módulo para confirmar que el cambio de regla no generó efectos colaterales en otras partes.
  5. Entrega un reporte que deja asentado, en un solo documento: qué regla cambió (antes → después), qué casos se archivaron y por qué, y qué quedó cubierto.

3. ¿Cuándo tengo que usar este playbook (y cuándo no)?

Situación ¿Este playbook?
Una regla de negocio cambió intencionalmente y la historia ya está actualizada ✅ Sí
Un criterio de aceptación fue reescrito, agregado o eliminado ✅ Sí
Necesitás actualizar solo los casos de prueba afectados, sin rehacer el módulo entero ✅ Sí
Necesitás que quede registro de qué casos quedaron obsoletos y por qué, sin perderlos ✅ Sí
Lo que cambió es un comportamiento no intencional (algo se rompió solo) ❌ No — es un bug: usá el playbook de reproducción de bugs o el de ciclo de corrección de bugs
El código se refactorizó pero la regla de negocio sigue siendo la misma ❌ No — alcanza con volver a ejecutar la suite existente de ese módulo con lippia-neo-run-and-heal
El módulo todavía no tiene ningún plan ni suite de pruebas ❌ No — usá primero el playbook de puesta en marcha del proyecto

Importante

  • Este playbook no arranca de cero: necesita que ya exista un plan de pruebas anterior y una suite previa del módulo. Si no existen, no hay nada contra qué comparar el cambio.
  • La decisión de qué casos de prueba archivar y la de validar los ajustes automáticos son manuales — el asistente prepara la información, pero la confirmación final la das vos (ver "Supervisión humana" en los conceptos clave).

4. Ejemplos reales de negocio

E-commerce — TechStore refuerza la seguridad de las contraseñas

Regla anterior La contraseña debía tener un mínimo de 8 caracteres.
Regla nueva La contraseña debe tener mínimo 12 caracteres, con al menos una mayúscula, un número y un símbolo.
Por qué cambió Una decisión de seguridad del área de producto, tras una auditoría.
Qué hace el playbook Archiva los casos que probaban el límite de 8 caracteres, genera casos nuevos para los 12 caracteres y los tres requisitos agregados, y confirma que el resto del formulario de registro sigue funcionando igual.

Telecomunicaciones — límite de datos gratis en roaming

Regla anterior Los primeros 500MB de datos en roaming eran gratuitos.
Regla nueva El límite gratuito sube a 1GB, y a partir de ahí se cobra por MB adicional.
Por qué cambió Una nueva promoción comercial vigente desde el mes siguiente.
Qué hace el playbook Archiva los casos que validaban el corte en 500MB, genera casos nuevos para el corte en 1GB (incluyendo el borde exacto: 999MB, 1000MB, 1001MB), y ejecuta la regresión del módulo de consumo para confirmar que el cobro por excedente sigue funcionando bien.

Banca — monto máximo de transferencia sin doble factor

Regla anterior Las transferencias de hasta $50.000 no pedían un segundo factor de autenticación.
Regla nueva El monto libre de segundo factor baja a $20.000, por una nueva política de prevención de fraude.
Por qué cambió Una decisión de riesgo del área de seguridad del banco.
Qué hace el playbook Archiva los casos que probaban el límite de $50.000, genera casos nuevos para el límite de $20.000 (incluyendo transferencias de exactamente $19.999, $20.000 y $20.001), y valida que las transferencias por debajo del nuevo límite y por encima sigan comportándose como corresponde.

4.1 Antes de arrancar: lo que necesitás tener a mano

Dato Ejemplo (TechStore)
Qué regla cambió, en palabras simples, antes y después "La contraseña pasó de pedir mínimo 8 caracteres a pedir mínimo 12, con mayúscula, número y símbolo"
La historia de usuario ya actualizada, con los criterios de aceptación nuevos user-stories/TS-US-14.md
Dónde está el plan de pruebas anterior de ese módulo test-plans/TS-US-14-test-plan.md (la carpeta de planes del proyecto)
Dónde está la suite de pruebas anterior de ese módulo tests/playwright/TS-US-14/ (una carpeta con el ID de la historia, dentro de la carpeta de tests del proyecto)
Un identificador de la historia (US-ID) TS-US-14
El proyecto ya inicializado para trabajar con el asistente de QA (existe una configuración base del stack, qa-stack.yaml) Si el proyecto todavía no la tiene, hay que ejecutar antes el playbook de puesta en marcha del proyecto
(Recomendado, no obligatorio) Los hallazgos de una exploración anterior de ese módulo Están en execution/TS-US-14/. Si existen, el asistente los reutiliza para no tener que volver a explorar la pantalla; si la regla nueva agregó o movió elementos en pantalla, va a hacer falta una exploración puntual de todos modos (ver el Paso 3)
Alguien que pueda confirmar qué casos de prueba archivar y validar los ajustes automáticos El referente de QA o de producto del módulo afectado

Si no tenés alguno de estos datos a mano (por ejemplo, no sabés la ruta exacta del plan anterior), no pasa nada — se lo podés preguntar al asistente y él te ayuda a ubicarlo.

Playbook original

El playbook general se encuentra en el repositorio NEO-releases.


4.2 Cómo arrancar

Antes del Paso 1, contale al asistente qué regla cambió y dónde está la historia actualizada:

💬 Prompt para el asistente
Reglas de negocio cambiaron en user-stories/TS-US-14.md.
Qué regla cambió: la contraseña pasó de mínimo 8 caracteres a mínimo 12,
con mayúscula, número y símbolo.
El plan y la suite previos del módulo ya están en test-plans/ y tests/playwright/TS-US-14/.
Solo registrá este contexto. No leas archivos, no ejecutes ningún paso, no llames ninguna skill,
no registres en memoria. Confirmame en una línea qué regla cambió y esperá mi próxima instrucción.

Con ese contexto, el asistente ya puede recorrer todos los pasos siguientes sin que se lo tengas que repetir cada vez.


4.3 Paso a paso

Paso 1 de 5 — Releer la historia y detectar qué cambió

Skill que se usa: lippia-neo-read-user-story

Qué pasa: el asistente relee la historia actualizada, extrae los criterios de aceptación vigentes, y los compara contra el plan de pruebas anterior. A cada criterio le asigna una etiqueta:

Etiqueta Qué significa
Nuevo No existía antes — hay que generar casos de prueba desde cero
Modificado Ya existía, pero la regla cambió — hay que regenerar los casos que lo cubrían
Sin cambios Sigue igual — no se toca
Eliminado / superado La nueva regla lo dejó sin sentido — candidato a archivar

Pedile la comparación de forma explícita

La skill lee la historia tal como está hoy — no compara versiones por sí sola. La comparación contra el plan anterior hay que pedírsela en el mismo mensaje; si no, el asistente extrae los criterios pero no etiqueta nada.

💬 Prompt — Paso 1
/lippia-neo-read-user-story

Luego leé test-plans/TS-US-14-test-plan.md, comparalo con los criterios recién extraídos
y clasificá cada uno: nuevo / modificado / sin cambios / eliminado.

Qué te queda al final de este paso: una lista clara de qué cambió y qué no. Con TechStore, por ejemplo: "el criterio de mínimo 8 caracteres queda ELIMINADO, y se agregan cuatro criterios NUEVOS: mínimo 12 caracteres, mayúscula obligatoria, número obligatorio y símbolo obligatorio".

Checkpoint — Criterios etiquetados

Tenés la lista de criterios etiquetados y, para cada uno, qué archivos de prueba lo cubren hoy (en tests/playwright/TS-US-14/). Sin esta lista, el archivado del Paso 3 sería a ciegas.


Paso 2 de 5 — Regenerar el plan de los flujos afectados

Skill que se usa: lippia-neo-create-test-plan

Qué pasa: con la lista del Paso 1, el asistente reescribe el plan de pruebas: agrega escenarios para los criterios nuevos y modificados, deja intactos los escenarios de los criterios que no cambiaron, y saca del plan los escenarios de los criterios eliminados.

Por defecto, la skill arma el plan desde cero para todos los criterios. Por eso hay que decirle explícitamente que lea el plan existente, que se limite a lo que cambió y que reescriba el mismo archivo:

💬 Prompt — Paso 2
/lippia-neo-create-test-plan
Leé el plan actual en test-plans/TS-US-14-test-plan.md, regenerá los escenarios de los
criterios nuevos y modificados (según el diff), conservá intactos los escenarios de los
criterios sin cambios (según el diff), y reescribí completamente el archivo leído.

Confirmá la reescritura

Como el plan ya existe, el asistente te va a avisar antes de sobrescribirlo (nunca lo pisa en silencio). Confirmale que sí.

Con TechStore, esto significa que el plan queda con escenarios nuevos para "contraseña de 11 caracteres" (debe rechazarse), "contraseña de 12 caracteres exactos" (debe aceptarse), "contraseña sin mayúscula", "sin número" y "sin símbolo" — y sin ningún escenario que hable del viejo límite de 8.

Checkpoint — Plan regenerado

El plan regenerado tiene al menos un escenario por cada criterio nuevo y modificado, cubre los casos límite de la regla nueva (por ejemplo, justo en el número exacto que separa "válido" de "inválido"), y ya no menciona los escenarios del criterio eliminado.


🔴 Checkpoint humano — Decidir qué se archiva (pausa, no delegable)

Qué pasa: primero le pedís al asistente la lista de candidatos a archivar — los casos de prueba que cubrían un criterio eliminado o superado — con la razón de cada uno:

💬 Prompt — Candidatos a archivar
Dado el diff de criterios del Paso 1, listá todos los archivos en tests/playwright/TS-US-14/
que cubren criterios clasificados como ELIMINADO o SUPERADO.
Para cada archivo: criterio que cubre, ruta completa del archivo,
y una frase con la razón por la que quedó obsoleto.

Pausa obligatoria — esta decisión no la toma el asistente solo

La lista del asistente es solo una sugerencia. Para cada candidato, alguien del equipo confirma una de estas tres opciones:

Decisión Qué significa
Archivar El caso valida una regla que ya no existe → se archiva, con su razón
Conservar El caso sigue siendo válido para otra cosa que la nueva regla no tocó → no se toca
Regenerar Es del mismo flujo, pero la regla nueva cambió lo que se espera → lo cubre el Paso 3, no se archiva

Con TechStore, el caso que probaba "contraseña de 8 caracteres es válida" se archiva — esa regla ya no existe —, mientras que un caso que probara, por ejemplo, "el campo contraseña no puede quedar vacío" se conserva, porque esa regla no cambió.

Qué te queda al final: una lista cerrada de los archivos a archivar, cada uno con su razón en una frase. Por ejemplo:

ARCHIVAR:
- tests/playwright/TS-US-14/tc-002-password-longitud-min-8.spec.js
  Razón: la regla de contraseña mínimo 8 caracteres fue reemplazada por requisitos
  múltiples (AC-02 eliminado, sprint 2026-06).

Por qué es manual

Distinguir "esto ya no sirve para nada" de "esto todavía sirve, aunque de otra forma" requiere conocer el negocio — no es algo que se pueda automatizar de forma confiable (ver "Supervisión humana" en los conceptos clave).


Paso 3 de 5 — Archivar lo obsoleto y regenerar la suite

Skill que se usa: lippia-neo-generate-test-suite (para regenerar la suite; el archivado lo hace el asistente directamente, sin una skill específica)

Qué pasa: con la decisión del checkpoint anterior ya tomada, el asistente:

  1. Mueve (no borra) los casos marcados como "archivar" a una carpeta aparte llamada _deprecated/, dentro de la misma carpeta de la suite (tests/playwright/TS-US-14/_deprecated/), dejando escrita en la primera línea del archivo movido la fecha y la razón.
  2. Genera los casos de prueba nuevos y regenerados según el plan del Paso 2.

Parte a — Archivar. Como la decisión del checkpoint la tomaste vos, el asistente no la conoce: tenés que pegar tu lista ARCHIVAR dentro del mensaje. Pegá solo esas entradas — las que decidiste conservar o regenerar no van acá, y el asistente no vuelve a decidir qué archivar.

💬 Prompt — Paso 3a: archivar
Archivá los tests de esta lista (mover, no borrar):

ARCHIVAR:
- tests/playwright/TS-US-14/tc-002-password-longitud-min-8.spec.js
  Razón: la regla de contraseña mínimo 8 caracteres fue reemplazada por requisitos
  múltiples (AC-02 eliminado, sprint 2026-06).

Para cada entrada:
1. Creá el directorio tests/playwright/TS-US-14/_deprecated/ si no existe.
2. Mové el archivo ahí con git mv.
3. Insertá al tope del archivo movido el encabezado:
   // [DEPRECATED <fecha de hoy YYYY-MM-DD>] <la razón de esa entrada>

Parte b — Regenerar la suite. La skill lee el plan regenerado del Paso 2, los hallazgos de la exploración anterior (en execution/) y qa-stack.yaml, y genera un archivo de prueba por cada caso del plan en tests/playwright/TS-US-14/, con nombres del tipo tc-<número>-<descripción>.spec.js (o .spec.ts, según el lenguaje del proyecto).

Pedile que se limite a lo que cambió

La skill no se limita sola a los criterios que cambiaron. Si no le pasás la lista de pruebas que ya existen en el módulo, indicale explícitamente que genere solo los escenarios de los criterios nuevos y modificados.

Con TechStore: el caso viejo de "8 caracteres" queda guardado en la carpeta de archivo, con una nota que dice cuándo y por qué se dejó de usar — y se crean los casos nuevos para los 12 caracteres y los tres requisitos agregados.

Por qué acá no se vuelve a explorar la aplicación

Un cambio de regla cambia la lógica, no las pantallas: el asistente reutiliza los botones y campos que ya había identificado en la exploración anterior. Excepción: si la regla nueva agregó o movió elementos en pantalla, esos datos van a faltar y las pruebas quedan con marcas TODO (pendientes). En ese caso, antes de regenerar, pedile al asistente una exploración guiada del flujo afectado con lippia-neo-run-manual-testing (como en el Paso 3 del playbook Feature - New End-to-End) y después regenerá.

Checkpoint — Archivado y suite regenerada

  • Cada archivo de la lista ARCHIVAR está en _deprecated/, con su encabezado, y los que decidiste conservar o regenerar no se tocaron.
  • Los archivos archivados están efectivamente fuera de la ejecución normal (no se van a ejecutar por error).
  • Los casos nuevos corresponden exactamente a los criterios nuevos y modificados del Paso 1.
  • Ninguna prueba activa quedó con marcas TODO. No lo dejes para el Paso 4: ahí el asistente las completaría "adivinando" antes de la primera ejecución.

Paso 4 de 5 — Ejecutar y reparar la suite completa del módulo

Skill que se usa: lippia-neo-run-and-heal

Qué pasa: el asistente ejecuta todos los casos de prueba del módulo (no solo los nuevos), porque un cambio de regla puede afectar flujos vecinos que a primera vista no parecen relacionados. Si algún caso falla por un motivo esperado — por ejemplo, un caso que comparaba contra el valor viejo de la regla —, el asistente intenta repararlo automáticamente (ver "Reparación automática" en los conceptos clave), ajustando el resultado esperado al valor que dicta la regla nueva.

💬 Prompt — Paso 4
/lippia-neo-run-and-heal
Ejecutá la suite completa del módulo con include_dirs=["TS-US-14"] y max_iterations=2

Por qué 2 intentos y no 3

En un cambio de regla, muchas fallas son esperables: la contraseña que antes era válida ahora se rechaza. En el primer intento el asistente actualiza esos valores esperados; en el segundo confirma que todo queda en verde. Dos intentos alcanzan para eso sin darle margen a disimular un problema real como si fuera un cambio intencional. Si después de 2 intentos no queda en verde, no subas la cantidad de intentos para "forzarlo": puede ser una regresión real o un criterio que el plan no cubrió.

Qué te queda al final de este paso: cuántos casos pasaron y cuántos fallaron al final, cuántos intentos se usaron de los 2, qué casos quedaron reparados y con qué valor nuevo, y el estado final de la suite:

Estado final Qué significa
✅ Todo en verde Todos los casos pasaron (algunos quizás después de un ajuste)
⚠️ Se frenó porque dejó de mejorar El segundo intento no arregló ningún caso más
❌ Se agotaron los 2 intentos Quedaron casos fallando — leé el detalle del motivo antes de seguir

🔴 Checkpoint humano — Validar los ajustes automáticos (pausa, no delegable)

Pausa obligatoria — antes de dar la suite por buena

Alguien del equipo revisa, uno por uno, cada ajuste que hizo la reparación automática del Paso 4. Para cada ajuste, las preguntas son siempre las mismas:

Pregunta Si la respuesta es "no"
¿El valor nuevo coincide con lo que pide la regla actualizada? Es un falso negativo — hay que revertir el ajuste y reportarlo como un problema real (un defecto)
¿El caso sigue probando lo mismo que decía probar? El ajuste automático se desvió — hay que corregirlo a mano
¿Los bordes de la regla nueva quedaron con el valor correcto? Falta un escenario de borde — hay que volver al Paso 2

Por qué importa

"Todo en verde" no alcanza si algún ajuste quedó mal hecho — sería un falso negativo tapando un problema real (ver "Falso negativo" en los conceptos clave). Verde con ajustes mal hechos es peor que rojo. Este control es la razón por la que el proceso completo no queda 100% automatizado.


Paso 5 de 5 — Reporte: cambio de regla + impacto en cobertura

Skill que se usa: lippia-neo-write-test-report

Qué pasa: el asistente arma un único reporte que deja asentado, en el mismo documento:

  • La regla que cambió, expresada como "antes" y "después".
  • Los casos de prueba que se archivaron, con su razón y su nueva ubicación.
  • Los ajustes automáticos que se hicieron durante la reparación, ya validados en el checkpoint anterior.
  • El resultado final de la regresión completa del módulo.

Por defecto, la skill arma las secciones estándar del reporte y no sabe qué regla cambió ni qué decidiste en los dos checkpoints (esas decisiones las tomaste vos, fuera del chat). Por eso hay que pegárselo en el mensaje:

💬 Prompt — Paso 5
/lippia-neo-write-test-report
Usá us_id: TS-US-14

Además de las secciones estándar, dejá asentado en el reporte:

- REGLAS ACTUALIZADAS (como "antes" y "después").
- TCs ARCHIVADOS (del checkpoint post-plan).
- ASSERTIONS VALIDADAS EN HEALING (del checkpoint post-heal):
  - <pegá acá los ajustes que confirmaste como correctos>

Repetí el cambio de regla aunque ya lo hayas dicho

Lo contaste al arrancar, pero pegalo de nuevo acá: si la conversación se resumió o se retomó en otra ventana, el asistente puede no tenerlo presente. Lo mismo con los criterios de aceptación del Paso 1: sin ellos, la sección de cobertura del reporte queda como "no evaluable". Como en este flujo no hubo exploración manual, el reporte lo indica como "sin pruebas exploratorias en esta ejecución" — es lo esperado.

Qué te queda al final de este paso: un documento único, con fecha y hora, en la carpeta de reportes del proyecto (por defecto test-results/reports/, por ejemplo TS-US-14-test-report-2026-06-25-1430.md), que sirve como evidencia formal de que el cambio de regla quedó cubierto y de que nada más se rompió en el proceso — ideal para adjuntar al ticket o mostrarle a un stakeholder. Nunca pisa un reporte anterior.

Estado general del reporte Qué significa
✅ Pasó El cambio de regla quedó cubierto y el resto del módulo sigue funcionando
❌ Falló Hay casos que fallan por un problema real de la aplicación
⚠️ Bloqueado Las fallas son del ambiente o de la configuración (por ejemplo, credenciales), no hay evidencia de un defecto de la aplicación

4.4 ¿Qué me queda al finalizar todos los pasos?

Qué obtenés Para qué te sirve
El plan de pruebas actualizado, con la regla nueva reflejada Documenta, de una vez, cuál es la regla vigente hoy
Los casos de prueba nuevos y regenerados Cubren exactamente la regla actualizada, con sus bordes incluidos
Los casos obsoletos archivados (no borrados), con su razón Trazabilidad completa de qué se probaba antes y por qué se dejó de probar
Confirmación de que el resto del módulo sigue funcionando El cambio de regla no generó efectos colaterales
Un reporte único con el "antes" y el "después" Evidencia formal para cerrar el ticket o informar al equipo

5. Problemas comunes (y qué hacer)

Lo que ves Por qué puede pasar Qué hacer
Un caso de la regla vieja se sigue ejecutando y fallando Quedó archivado, pero no se lo excluyó de la ejecución normal Confirmar con el equipo técnico que el archivo quedó fuera del grupo de pruebas que se ejecuta
La suite queda toda en verde, pero la regla nueva no parece bien cubierta La reparación automática ajustó un caso a un valor que no coincide con la regla nueva (falso negativo) Revisar ese ajuste puntual en el checkpoint post-reparación, revertirlo y regenerar el caso correctamente (por ejemplo, la prueba acepta una contraseña sin símbolo porque la reparación la dio por válida)
Al generar la suite, algunos casos quedan marcados como pendientes (TODO) La regla nueva movió o agregó elementos en la pantalla que todavía no se exploraron Pedir una exploración guiada del flujo afectado (lippia-neo-run-manual-testing) antes de volver a generar
Tras los 2 intentos de reparación, algo sigue sin pasar Puede ser una regresión real, o un criterio que el plan no cubrió — no solo un ajuste esperado Leer el detalle del motivo antes de forzar que quede en verde — no subas la cantidad de intentos, puede haber un problema genuino
No se detecta ningún criterio eliminado El plan anterior no está disponible o está desactualizado Recuperar el plan anterior (por ejemplo, desde el historial del repositorio) antes de arrancar, o reconstruir a mano qué cambió
El asistente avisa que no puede generar la suite porque la herramienta de pruebas está "en estado STUB" La herramienta de testing configurada en el proyecto todavía no está soportada por completo Avisarle al equipo técnico
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 4

6. Resumen visual del flujo

flowchart TD
    A([📝 Regla de negocio cambió<br/>ej: TechStore sube el<br/>requisito de contraseña]) --> B
    B["<b>Paso 1</b> — Releer la historia<br/>y detectar qué cambió"] --> C
    C["<b>Paso 2</b> — Regenerar el plan<br/>de los flujos afectados"] --> D
    D["🔴 <b>Checkpoint humano</b><br/>Decidir qué se archiva"] --> E
    E["<b>Paso 3</b> — Archivar lo obsoleto<br/>y regenerar la suite"] --> F
    F["<b>Paso 4</b> — Ejecutar y reparar<br/>la suite completa del módulo"] --> G{🔴 ¿Los ajustes automáticos<br/>son correctos?}
    G -->|No| H["Revertir el ajuste<br/>y reportarlo como defecto"]
    G -->|Sí| I
    H --> I["<b>Paso 5</b> — Reporte: cambio de<br/>regla e impacto en cobertura"]
    I --> J([✅ Regla nueva cubierta,<br/>obsoletos archivados<br/>con trazabilidad])