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