Saltar al contenido principal

Referencia de herramientas

Referencia completa de las 16 herramientas expuestas por el MCP Test Architect.

Análisis de la base de código​

analyze_architecture​

Escanea el árbol de archivos de un proyecto objetivo y produce un catálogo estructurado de rutas, funcionalidades, interacciones de usuario y endpoints de API reales. La salida se guarda localmente como architecture.json.

Entrada: resumen del árbol de archivos, hint del framework, lista de módulos
Salida: routes[], features[], tech_stack[]

generate_plan​

Llama a la IA de QA Hub (via /api/v1/architect/generate-plan) con el catálogo de arquitectura y devuelve una lista de escenarios de prueba BDD.

Entrada: resumen de arquitectura, filtro de módulo, instrucciones adicionales
Salida: scenarios[] con title, suite, layer, is_e2e, tags, gherkin

enrich_plan​

Refina un plan de prueba existente añadiendo casos límite, flujos negativos y escenarios de accesibilidad que se omitieron en la generación inicial.

Entrada: scenarios[] existentes, instrucciones de enriquecimiento
Salida: scenarios[] enriquecidos

write_plan​

Guarda el plan de prueba en plan.md en el directorio del proyecto objetivo para revisión humana antes de la generación de specs.

Generación de specs​

generate_specs​

Genera archivos de spec TypeScript completos para Playwright a partir de los escenarios de prueba y el contexto de localizadores de UI (recopilados por crawl_app). Llama a /api/v1/architect/generate-specs.

Entrada: scenarios[], localizadores DOM, URL base, credenciales de usuario de prueba
Salida: contenido de archivos de spec + fixture de autenticación

write_specs​

Escribe los archivos de spec generados en disco en el directorio specs/ del proyecto objetivo.

crawl_app​

Lanza un navegador Playwright, navega la app en ejecución y recopila localizadores DOM, estructuras de formularios y patrones de navegación. Estos datos de base evitan que la IA genere selectores inválidos.

Entrada: URL base, páginas a visitar
Salida: snapshot DOM con selectores reales

save_auth_session​

Inicia sesión en la app y guarda el estado del navegador autenticado como un archivo JSON de estado de almacenamiento de Playwright. Lo usan los fixtures de prueba para omitir el login en cada test.

Entrada: URL de login, credenciales
Salida: auth-state.json

setup_playwright​

Instala Playwright y sus dependencias de navegador en el proyecto objetivo si aún no están instaladas.

execute_playwright​

Ejecuta los archivos de spec generados usando Playwright y captura los resultados. Publica los resultados automáticamente en /api/v1/ingest.

Entrada: rutas de archivos de spec, URL base, nombre de la ejecución
Salida: resumen de pass/fail + ID de ejecución en QA Hub

Tickets y estrategia​

load_tickets​

Obtiene tickets del conector activo del tenant (Linear, Jira o ADO) para usarlos como contexto en la generación del plan de prueba. Llama a /api/v1/architect/load-tickets.

Entrada: consulta, conector, filtros
Salida: tickets[] con title, description, priority

select_test_strategy​

Indica al agente que elija una estrategia de testing (smoke, regression, full, security, performance) basándose en el contexto del proyecto y los recursos disponibles.

Salida: nombre de la estrategia seleccionada

Sincronización y planes​

sync​

Publica los casos de prueba generados en la biblioteca de pruebas de QA Hub via /api/v1/cases. Los asocia con el proyecto configurado.

Entrada: scenarios[], project_id
Salida: códigos de casos de prueba creados (TC-001, …)

write_plan (aprobación del plan)​

Crea un ArchitectPlan en QA Hub via /api/v1/architect/plans para revisión del QA Manager. Devuelve una URL compartible. El plan empieza como PENDING_REVIEW.

Salida: plan ID, status, share_url

Pruebas de carga​

generate_k6_script​

Genera un script de prueba de carga JavaScript para k6 v0.49+ a partir del catálogo de arquitectura. Llama a /api/v1/architect/generate-k6.

Salida: script k6 con etapas ramp-up/steady/ramp-down, umbrales p95 < 500ms

Pipeline completo​

run_full_cycle​

Orquesta el pipeline completo en un único comando:

analyze_architecture → select_test_strategy → generate_plan →
crawl_app → generate_specs → write_specs → execute_playwright → sync

Entrada: ruta del proyecto objetivo, URL base, ID de proyecto en QA Hub
Salida: resumen final de pass/fail + casos de prueba creados en QA Hub

bootstrap​

Inicializa la configuración del Architect en un proyecto objetivo: crea architect.config.json, verifica la conectividad con QA Hub y confirma que Playwright está disponible.