Saltar a contenido

Planificación de pruebas

Estas tres skills convierten una fuente ya leída (una historia, o un pedido de exploración amplio) en un plan concreto de qué probar — ya sea un plan de pruebas paso a paso, o un portfolio de charters exploratorios seleccionados según el contexto disponible del producto. Ninguna de las tres ejecuta pruebas: solo planifican (el discovery de áreas, a lo sumo, hace una inspección superficial del producto para mapearlo).


lippia-neo-create-test-plan

Cuándo usarla

Cuando una historia de usuario ya analizada necesita un plan de pruebas exhaustivo que cubra todos sus criterios de aceptación (flujos de navegación + validación de UI). Se dispara cuando alguien pide crear un plan de test a partir de una historia, o cuando hay que convertir criterios de aceptación en escenarios paso a paso. Además de los pasos, diseña los datos de cada escenario: particiones de equivalencia y valores límite sin repetir, casos negativos y de borde, datos de referencia declarados una sola vez, datos derivados y casos bloqueados por falta de datos (ver Data-driven testing). No genera tests ni ejecuta nada.

Ejemplo de invocación
{
  "input": {
    "us_id": "PA-US-02",
    "user_story": {
      "summary": "Como usuario quiero aplicar un cupón de descuento en el carrito"
    }
  }
}
Input Tipo Descripción
input.us_id Requerido identificador corto de la historia (viene de lippia-neo-read-user-story); nombra el archivo de salida.
input.user_story Requerido la historia ya leída (asume que lippia-neo-read-user-story ejecutó antes).
input.app_urls Requerido puede venir vacío; si falta, usa como fallback environment.base_url de qa-stack.yaml.
input.credentials Requerido puede traer valores literales extraídos de la historia, pero el plan solo los referencia por el nombre de la variable del env_file, nunca por su valor.
input.findings Opcional hallazgos de una ejecución exploratoria previa de la historia (ui_selectors, executed_scenarios, findings). Completan los escenarios y, si contradicen a la historia en un dato de referencia, mandan los hallazgos (y se agrega una pregunta abierta).

Salida

Campo Descripción
test_plan el plan de pruebas completo, en Markdown. Se guarda en <paths.test_plans_dir>/<US-ID>-test-plan.md; si ya existe, nunca se pisa en silencio.
scenarios array de escenarios, cada uno con id (ej. TC-01), title, acceptance_criteria, scope (required / suggested), state (ready / blocked / needs_confirmation), state_reason, steps, expected_results, test_data (la lista tal cual) y data_records (los datos tipados, ver abajo).
test_data los datos de la sección "Datos de prueba" del plan, tipados: reference_data (un dominio con sus registros; un valor desconocido queda en null), variables (dominio, variable de entorno y uso) y partitions (entrada, criterio, partición, tipo, valor y escenario).
warnings avisos (datos que faltan, conflictos entre la historia y los hallazgos, etc.).

Cómo diseña los datos

Qué Cómo queda en el plan
Particiones y valores límite Por cada entrada, una partición por clase de equivalencia y por límite (mínimo (1), por encima del máximo…), con un valor por partición y su tipo: válido, inválido o borde. Nunca dos valores para la misma partición
Negativos y de borde Siempre propuestos para formularios y campos de texto (vacío, solo uno completo, inválido, espacios, acentos, caracteres especiales, largo máximo). Si exceden el criterio de aceptación, van con **Alcance:** sugerido en "Casos sugeridos fuera de CA"
Datos de referencia Declarados una sola vez por dominio en "Datos de prueba", en una tabla cuya primera columna es Dominio. Los escenarios los nombran sin copiar valores. Nunca se inventan: un campo que nadie aporta queda vacío y genera una pregunta abierta
Datos derivados Como referencia a su origen (el stock del producto + 1), nunca el valor calculado
Credenciales y datos de identidad Solo por el nombre de la variable de entorno (APP_USER, APP_USER_DISPLAY_NAME). Una credencial inválida para un caso negativo se describe como derivación (APP_PASSWORD con un carácter de más)
Un comportamiento por escenario Las variantes que solo cambian datos son un escenario con varios datos; una matriz, un escenario con un dato por combinación

Cada escenario lleva una línea de atributos con alcance y estado:

**Tipo:** Funcional · **Prioridad:** Alta · **Alcance:** CA · **Estado:** bloqueado — no hay un producto sin stock en el catálogo (ver pregunta abierta 4)
**Datos de prueba:**
- pendiente (ver pregunta abierta 4) — partición: sin stock — tipo: válido
**Estado:** en el plan state Significa Qué pasa después
(sin línea de estado) ready Tiene pasos, resultados esperados y datos Se explora, se automatiza y se exporta
bloqueado — <motivo> blocked Le falta un dato que ninguna fuente aporta Se automatiza marcado como bloqueado (o no se escribe, según el runner); no se explora ni se exporta
sin resultado esperado — <qué falta> needs_confirmation Algún paso no tiene resultado esperado conocido (⚠️ sin resultado esperado) No se automatiza ni se exporta hasta que alguien lo confirme

Cada ítem de **Datos de prueba:** usa una de cinco formas, que se reflejan en data_records[].source:

Forma en el plan source
`teclado` — partición: coincide por nombre — tipo: válido literal
el stock del producto + 1 — partición: por encima del máximo — tipo: inválido derived
pendiente (ver pregunta abierta N) — … pending
referencia: precio del dominio `catalogo` reference
usuario: `APP_USER` variable

Cualquier ítem puede agregar — esperado: … con el resultado esperado de ese dato.

Se encadena con

Se ejecuta después de lippia-neo-read-user-story (y opcionalmente después de lippia-neo-run-manual-testing, cuyos findings puede consumir); su salida alimenta a lippia-neo-generate-test-suite.


lippia-neo-discover-exploratory-areas

Cuándo usarla

Cuando un pedido de testing exploratorio tiene alcance amplio o incompleto, y hace falta identificar las áreas reales del producto que se pueden explorar antes de crear charters. Combina la documentación disponible (historias), los activos de prueba existentes y, cuando aplica, una inspección superficial en vivo del target. Cada área queda respaldada por evidencia; si las fuentes no alcanzan, bloquea en vez de inventar. No prioriza con un modelo de riesgo fijo, no ejecuta exploración profunda ni reporta defectos de la aplicación.

Ejemplo de invocación
{
  "input": {
    "request": "Explorar el módulo de checkout y pagos"
  },
  "config": {
    "environment": { "base_url": "https://staging.miapp.com" },
    "paths": { "exploratory_dir": "exploration/" }
  }
}
Input Tipo Descripción
input.request Requerido el pedido original de exploración.
config.paths.exploratory_dir Requerido directorio donde se guardan los artefactos de descubrimiento (default recomendado exploration/).
input.artifact_scope_id Opcional si viene, se usa tal cual; si no, se genera uno nuevo (EXP-<YYYYMMDD>-<HHMMSS>).
input.max_areas Opcional límite de áreas a descubrir.
config.environment.base_url / config.environment.entry_point Opcional punto de entrada del target para la inspección en vivo; su ausencia no bloquea si hay otras fuentes suficientes.
config.environment.app_version / config.environment.os Opcional contexto del ambiente.
config.paths.user_stories_storage.local_path Opcional fuente de descubrimiento vía historias locales.
config.paths.test_plans_dir Opcional fuente de descubrimiento vía planes existentes (marca existing_test_coverage).
config.paths.env_file / config.auth Opcional para la inspección en vivo, si requiere autenticación.

Salida

Campo Descripción
artifact_scope_id, discovery_path, discovery_markdown_path, target_context rutas a portfolio/discovery.json y portfolio/discovery.md, más el contexto del target.
areas con area_id, name, description, entry_points, existing_test_coverage (none/partial/strong/unknown, solo informativo), evidence, source, notes.
areas_count, can_continue, blocking_reason none/insufficient_sources/target_unavailable/interaction_capability_unavailable/no_areas_discovered.
Se encadena con

Paso 1 de lippia-neo-meta-run-exploratory-testing; su salida (discovery) alimenta a lippia-neo-create-exploratory-charters.


lippia-neo-create-exploratory-charters

Cuándo usarla

Cuando ya existe un inventario de áreas descubiertas (producido por lippia-neo-discover-exploratory-areas) y hay que convertirlo en un portfolio acotado de charters exploratorios (SBTM). No aplica un scoring de riesgo fijo: elige y ordena las áreas según el contexto realmente disponible (pedido del usuario, prioridades explícitas, cambios conocidos, cobertura existente, etc.), sin inventar criticidad, y deja explícito el motivo de selección de cada charter y por qué quedó afuera cada área no seleccionada. No navega la aplicación ni ejecuta tests.

Ejemplo de invocación
{
  "input": {
    "discovery": { "areas": [{ "area_id": "AREA-01", "name": "Checkout" }] },
    "artifact_scope_id": "EXP-20260101-100000",
    "business_priorities": ["El checkout es crítico para el release"]
  },
  "config": {
    "paths": { "exploratory_dir": "exploration/" }
  }
}
Input Tipo Descripción
input.discovery Requerido el inventario de áreas producido por lippia-neo-discover-exploratory-areas.
input.artifact_scope_id Requerido scope funcional de artefactos a preservar.
config.paths.exploratory_dir Requerido directorio donde se escriben el portfolio y los charters.
input.max_charters Opcional por defecto 5.
input.time_box_minutes Opcional por defecto 60 (rango válido 15–90).
input.report_language Opcional por defecto es.
input.selection_context / input.business_priorities / input.changed_areas / input.known_constraints Opcional contexto explícito para seleccionar y ordenar áreas (prioridades, cambios recientes, restricciones); las instrucciones del usuario pesan más que cualquier heurística interna.

Salida

Campo Descripción
artifact_scope_id, portfolio_manifest_path, portfolio_markdown_path rutas a portfolio/portfolio.json y portfolio/portfolio.md.
charters CHARTER-001, CHARTER-002…, cada uno con id, mission, area, exploration_focus, selection_reason, time_box_minutes, target_context, heuristics (opcionales), notes, charter_path.
areas_not_selected cada área que quedó fuera, con area y reason.
total_planned_minutes, can_continue
Se encadena con

Recibe el discovery de lippia-neo-discover-exploratory-areas; sus charters se consumen uno por uno en lippia-neo-run-exploratory-session. Es el paso 2 de lippia-neo-meta-run-exploratory-testing.