Saltar a contenido

Configuración e infraestructura de QA

Estas dos skills preparan un proyecto para trabajar con NEO. Se usan una sola vez al arrancar (o cuando falta algo de esa configuración), y son el paso 1 y 2 del playbook New Project Bootstrap.


lippia-neo-bootstrap-stack

Cuándo usarla

Al configurar por primera vez un proyecto para el flujo QA: auto-detecta el framework de testing, el lenguaje, el tipo de app y el proveedor de CI a partir del repo, y escribe qa-stack.yaml. Además pregunta a qué herramienta de gestión de tests se exportan los test cases (Xray, QMetry o ninguna) y dónde se reportan los bugs. También se dispara automáticamente como pre-chequeo cuando lippia-neo-workflow-e2e no encuentra ese archivo, o cuando cualquier skill agnóstica falla por su ausencia.

Ejemplo de invocación
{
  "output": {
    "qa_stack_path": "qa-stack.yaml"
  }
}
Input Tipo Descripción
output.qa_stack_path Requerido ruta donde se va a escribir el qa-stack.yaml generado (es el único campo formalmente requerido; el resto se resuelve por detección automática o preguntando).

No tiene una lista formal de opcionales. En cambio, exige resolver siempre por interacción con la persona (nunca se infieren ni se dejan vacíos):

  • los campos de environment (base_url, app_version, os) y auth;
  • de dónde salen las historias (paths.user_stories_storage): local (directorio de .md) o cloud vía MCP (jira o azure-devops);
  • dónde se reportan los bugs (paths.bug_reports_storage): local o cloud vía MCP (jira, azure-devops, github o gitlab). Con cloud pregunta además el destino según la herramienta: jira_project_key/jira_issue_type, azure_devops_project/azure_devops_work_item_type, github_repo/github_issue_label o gitlab_project/gitlab_issue_type. Los BUG-*.json siempre se escriben primero en local_path (default bug-reports/);
  • los directorios de artefactos (test_plans_dir, tests_dir, reports_dir, scripted_dir, exploratory_dir), de a uno por pregunta, aunque el default parezca obvio;
  • la ruta del env_file (default .env.tests, gitignored);
  • la herramienta de gestión de tests (test_management.tool: xray, qmetry o ninguna), su project_key y sus credenciales (XRAY_CLIENT_ID/XRAY_CLIENT_SECRET o QMETRY_API_KEY), que van solo al env_file, nunca a qa-stack.yaml. Se puede responder "después" y quedan pendientes;
  • si aplica, api_contract (app api/hybrid) y lippia_config_path (framework lippia).

Además, en toda ejecución asegura que .mcp.json tenga el server playwright (lo necesita la exploración, sea cual sea el framework), ofrece cargar ahí las credenciales de los proveedores cloud elegidos (gitignored, nunca se muestran) y agrega .claude, .playwright-mcp y execution/evidence.txt al .gitignore.

Salida

Campo Descripción
qa_stack_path ruta del qa-stack.yaml escrito.
detection_mode auto / interactive / mixed, según cuánto se infirió vs. se preguntó.
stack test_framework (playwright/cypress/lippia/pytest), language (javascript/typescript/java/python), app_type (web/api/hybrid), auth (google_sso/basic_auth/api_token/none), pipeline_provider (github/gitlab/bitbucket).
environment base_url, app_version, os.
api_contract solo si app_type es api/hybrid: spec_path, spec_url y snapshot_path (snapshot inicial del contrato cuando se resolvió spec_url).
mcp_json path, framework_server (siempre playwright) y cloud_provider_server (server(es) cloud agregados para historias y/o bugs, o null si todo es local).
test_management tool (xray/qmetry/null), project_key, credentials_loaded y credentials_pending (solo nombres de claves, nunca valores).
Se encadena con

Paso 1 del playbook de bootstrap; el paso 2 es lippia-neo-ci-bootstrap, que lee pipeline_provider de este qa-stack.yaml. También es el prerequisito para lippia-neo-workflow-e2e y para el resto de las skills agnósticas (por ejemplo, lippia-neo-report-bug lee bug_reports_storage para saber dónde publicar).


lippia-neo-ci-bootstrap

Cuándo usarla

Cuando hace falta un workflow de CI/CD que ejecute las skills de QA en cada commit, PR o schedule. Lee pipeline_provider de qa-stack.yaml y emite el archivo de workflow correspondiente (GitHub, GitLab o Bitbucket). Siempre se ejecuta después de lippia-neo-bootstrap-stack — aborta si qa-stack.yaml todavía no existe.

Ejemplo de invocación
{
  "config": {
    "pipeline_provider": "github",
    "test_framework": "playwright"
  }
}
Input Tipo Descripción
config.pipeline_provider Requerido proveedor de CI ya resuelto en qa-stack.yaml; determina qué adaptador cargar.
config.test_framework Requerido framework de testing ya resuelto en qa-stack.yaml; se sustituye como placeholder en el template del workflow.

Los jobs propios siempre se escriben encapsulados en una subcarpeta neo-ci-jobs/ dentro de la carpeta de jobs del proveedor (.github/workflows/, .gitlab/ o .bitbucket/), con un neo-ci-manager.yml como punto de entrada. Si el archivo de entrada de CI del repo ya existe, no se pisa: en GitLab se agrega solo una línea include:, en GitHub se escribe un workflow aparte (.github/workflows/neo-ci-jobs.yml) y en Bitbucket —que no admite repartir el pipeline en varios archivos— se propone un merge y se pide confirmación antes de escribir. Si el framework es playwright, el repo tiene que tener @playwright/test declarado en su package.json.

Los jobs activos (modelo M4) son initial-setup → feature-e2e (plan feature-new-end-to-end) → publish-report, y se ejecutan solo en PR/MR con el label feature. En Bitbucket el filtro por label no se puede expresar en el YAML: el plan queda como pipeline custom qa-feature-e2e, que tiene que dispararse desde afuera (el handler de webhooks para Bitbucket todavía no está implementado en el engine). En GitLab el template trae además ui-selector-repair (plan ui-selector-repair) y qa-read-stack, que se disparan con un push a develop que toca src/components/ o src/pages/.

Salida

Campo Descripción
provider github/gitlab/bitbucket.
generated_file ruta del archivo de workflow generado o actualizado.
phase siempre scaffolding: el YAML se genera una vez desde el template y queda commiteado. Los jobs M4 que incluye ya invocan al engine real (crowdar-engine-mvp), no son placeholders.
warnings advertencias.
Se encadena con

Siempre se ejecuta después de lippia-neo-bootstrap-stack, como paso 2 del playbook de bootstrap. Después hay que configurar los secrets/variables que pide el README del adapter y commitear los archivos generados.