Saltar al contenido principal

Workflow de ciclo completo

El ciclo completo es el pipeline automatizado de extremo a extremo: desde el escaneo de la base de código hasta la ejecución de tests y la ingestión de resultados, todo impulsado por una única conversación con un agente de IA.

Requisitos previos​

  • MCP Test Architect configurado y conectado
  • Aplicación objetivo ejecutándose localmente o en una URL accesible
  • Proyecto de QA Hub creado con token de API con scope write
  • Proveedor de IA configurado en QA Hub (Settings → AI Model)

Iniciar el ciclo​

En Claude Code o Desktop, escribe:

Use the QA Hub Architect to run a full test cycle for the app at http://localhost:3000.
Project ID: clxyz123
Focus on: authentication and checkout flows

El agente recorrerá cada etapa automáticamente.

Etapas​

Etapa 1 — Analizar arquitectura​

El agente escanea el árbol de archivos del proyecto, descubre rutas y funcionalidades, y construye architecture.json. Esto ancla toda la generación posterior en código real, evitando selectores alucinados o endpoints inexistentes.

Etapa 2 — Seleccionar estrategia​

Basándose en el alcance del proyecto y tu prompt, el agente selecciona una estrategia de testing:

EstrategiaCobertura
smokeSolo los flujos felices críticos
regressionCobertura completa de funcionalidades, positiva y negativa
securityBypass de autenticación, inyección, control de acceso
performanceGeneración de tests de carga con k6
fullTodo lo anterior

Etapa 3 — Generar plan de prueba​

El agente llama a /api/v1/architect/generate-plan con el catálogo de arquitectura. La IA devuelve escenarios BDD acotados a la estrategia y módulos seleccionados.

Etapa 4 — Rastrear la app​

Playwright navega la aplicación en ejecución y recopila localizadores DOM reales para las páginas y flujos cubiertos por el plan de prueba. Esto asegura que los specs generados usen selectores reales, no inventados.

Etapa 5 — Guardar sesión de autenticación​

El agente inicia sesión como usuario de prueba y guarda el estado del navegador en auth-state.json. Los fixtures de prueba cargan este estado para omitir el overhead del login en cada test.

Etapa 6 — Generar specs​

El agente llama a /api/v1/architect/generate-specs con los escenarios y los localizadores DOM. La IA devuelve archivos de spec TypeScript completos para Playwright con fixtures de autenticación con alcance de worker.

Etapa 7 — Ejecutar​

npx playwright test specs/ --reporter=json

Los resultados se capturan y se publican en /api/v1/ingest. Los casos de prueba etiquetados con @qa-hub('TC-NNN') se mapean a la biblioteca.

Etapa 8 — Revisar en QA Hub​

Abre el Dashboard de QA Hub:

  • Los nuevos casos de prueba aparecen en la Biblioteca de casos de prueba
  • Una ejecución de prueba completada muestra pass/fail por test
  • Las métricas de cobertura se actualizan automáticamente

Aprobar un plan generado​

Si el plan se envió para revisión (via write_plan), un QA Manager debe aprobarlo antes de que los casos de prueba se incorporen a la biblioteca:

  1. Ve a Plans en QA Hub
  2. Revisa los escenarios generados
  3. Haz clic en Approve o Reject

Los casos aprobados se mueven al estado READY.

Consejos para mejores resultados​

  • Usa prompts con --focus para acotar la generación a funcionalidades específicas
  • Ejecuta crawl_app en la versión autenticada de la app para obtener localizadores más ricos
  • Guarda auth-state.json en un gestor de secretos — contiene tokens de sesión activos
  • Programa el ciclo completo en CI para detectar regresiones automáticamente