QAFusionX

Agente de control de calidad (QA) MCP secuencial. Cuando este servidor está conectado en Cursor, bloquea el modo Ask, hace dos preguntas obligatorias y luego recorre un flujo de trabajo de 15 pasos que no se puede omitir. Completar el paso N escribe una marca en step-by-step/; esa marca es la única forma de desbloquear el paso N+1.

La consola de control es una interfaz gráfica en vivo para el mismo motor: pipeline numerado, banner de modo Ask, explorador de artefactos y una consola de ejecución de pruebas que puedes ver.

BLOQUEADO: navegador visible en el dispositivo de cada usuario. El flujo de trabajo es un pipeline, pero los rastreos y las pruebas de interfaz gráfica nunca se ejecutan como un trabajo silencioso dentro de él. Cuando cualquier usuario ejecuta QAFusionX en su máquina, se abre una ventana de navegador separada en ese dispositivo y muestra cada pantalla, ventana emergente y clic. El modo headless está rechazado. No existe el modo silencioso.

Qué hace

1. Preguntar: proyecto y objetivo (modo Ask): nombre del producto, qué probar, URL en vivo, captura de pantalla.

2. Preguntar: historias de usuario (modo Ask, obligatorio): zip / archivos, enlace de Jira o generar desde el sistema.

3. Persistir User stories/ y General/01-target.md.

4. Rastreo de la ronda 1: cada pantalla y ventana emergente: capturar → razonar → MD de referencia → plan vivo → siguiente clic.

5. Congelar el plan / lista de tareas de la ronda 1.

6. Rastreo de la ronda 2: misma estructura de directorios, buscando lo que la ronda 1 no encontró.

7. Generar historias de usuario: solo si la pregunta 2 fue generar desde el sistema. Después de la ronda 2, crear GeneratedUser stories/ a partir de cada flujo capturado. Las pruebas posteriores usan solo ese conjunto. Los ejecuciones con zip/Jira marcan este paso como N/A.

8. Completar el mapa del sistema: markdown largo y exhaustivo (los archivos cortos son rechazados).

9. Casos de prueba humanos en formato funcional de Jira en testCase Human/.

10. Subir esos casos a Jira (o escribir payloads locales).

11. Convertir 1:1 a YAML en testc2ai/.

12. Generar scripts de Playwright de GUI y API en AutomatedScripts/.

13. Ejecutar la suite en un navegador visible con ventana (ves cada clic) con resultados también transmitidos a la interfaz gráfica.

14. Exportar fallos a reports/QAFusionX-Issues.xlsx + .csv con evidencia.

15. Registrar tickets de error en Jira: asunto, prerequisitos, pasos, esperado, real, evidencia.

Related MCP server: mcp-playwright-test

Ejecutar localmente

npm install
npx playwright install chromium
cd console && npm install && cd ..
cp .env.example .env   # optional Jira credentials
npm run dev

• Consola de control: http://127.0.0.1:43181

• API del motor: http://127.0.0.1:43180

• Aplicación de ejemplo bajo prueba: http://127.0.0.1:43181/sample/login
  Inicio de sesión de demostración: qa.analyst / FusionX@2026

Haz clic en Ejecutar demostración guiada en la consola para ejecutar cada paso contra el ejemplo de Gestión de Intermediarios incluido (campos de Detalles de Emergencia que coinciden con un caso funcional de Jira).

Solo MCP:

npx tsx src/index.ts

Adjuntar QAFusionX a Cursor (cada proyecto, cada chat)

Windows: instalación completa de TBB + malla (recomendada):

git clone https://github.com/thejanaloit/QAFusionX.git $env:USERPROFILE\QAFusionX
cd $env:USERPROFILE\QAFusionX
npm run install:mesh
# or: powershell -ExecutionPolicy Bypass -File .\scripts\install-full-mesh.ps1

Esto vincula automáticamente e inicializa (clona + npm install si falta):

La configuración vive en config/tbb-mesh.json. Sobrescribe las raíces con variables de entorno (THEJA_BACKBONE_ROOT, etc.) antes de instalar.

macOS / Linux:

git clone https://github.com/thejanaloit/QAFusionX.git ~/QAFusionX
cd ~/QAFusionX
npm install --omit=dev
python3 scripts/link-tbb-mesh.py
bash scripts/install-global-cursor.sh

Eso escribe una configuración a nivel de usuario (~/.cursor/mcp.json) y reglas de usuario (~/.cursor/rules/qafusionx.mdc, qafusionx-visible-browser.mdc). Cursor las fusiona en cada espacio de trabajo y en cada chat de Agente/Ask. Luego:

1. Paleta de comandos → Developer: Reload Window

2. Configuración → Tools & MCP → activa QAFusionX (en verde)

Este repositorio también tiene .cursor/mcp.json, por lo que abrir la carpeta de QAFusionX es suficiente. El instalador es lo que lo hace global.

En el primer uso, el agente debe:

1. Cambiar al modo Ask.

2. Preguntar cuál es el proyecto y qué probar (URL + captura de pantalla).

3. Preguntar por las historias de usuario (zip, Jira o generar). Esta segunda pregunta es obligatoria.

Hasta que ambas respuestas estén guardadas, cada herramienta posterior devuelve BLOQUEADO.

Publicar en GitHub

El agente en la nube que construyó este proyecto no tiene inicio de sesión en GitHub, por lo que no puede crear github.com/<tú>/QAFusionX desde aquí. El código fuente ya está en el remoto de Cursor Origin. En tu máquina, después de gh auth login:

bash scripts/publish-github.sh QAFusionX public

Eso crea el repositorio de GitHub, añade un remoto github y hace push de main.

Fuentes de historias de usuario

Estructura de artefactos

artifacts/
  step-by-step/                 ticks — the only unlock
  User stories/                 zip / Jira stories
  GeneratedUser stories/        method 3 only, after Round 2
  General/                      01-target.md, human-qa-research.md
  Screens/
    round one/screenshots|references|plan/
    round two/screenshots|references|plan/
    complete-system-map.md
  testCase Human/               Jira-shaped markdown + json
  testc2ai/                     YAML for the AI runner
  AutomatedScripts/gui|api
  reports/                      suite results, XLSX/CSV, proof
  jira/                         upload log, payloads, created keys
  bugs/                         bug tickets with proof

Forma de los casos de prueba humanos

Los títulos siguen el patrón funcional de Jira:

[Sales & Marketing Module] [Intermediary Management][Add/Manage][FP] - Validate that the Emergency Details section displays all required fields.

Secciones obligatorias: Affects versions, Labels, Test Case Type, Priority, Parent, Linked work items, Preconditions, Test Steps, Test Comments, Expected Result, Actual Result.

Jira

Configura JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY. Sin ellos, QAFusionX igualmente completa los pasos escribiendo jira/payloads/*.json; nunca se salta el nodo.

Navegador visible (BLOQUEADO)

Esta regla está bloqueada en el motor, el protocolo MCP y las reglas de Cursor. No puedes desactivarla.

El pipeline igualmente se ejecuta paso a paso. Eso no significa que la ronda 1, la ronda 2 o las pruebas de GUI se ejecuten en segundo plano.

Cuando QAFusionX se ejecuta en el dispositivo de un usuario:

1. Se abre una ventana de navegador real separada en ese dispositivo.

2. Los rastreos y las pruebas de GUI ocurren en esa ventana.

3. El usuario observa cada navegación y cada clic.

QAFUSIONX_HEADED=0 es rechazado. Si la máquina no tiene pantalla, QAFusionX se detiene y te dice que lo ejecutes en el ordenador del propio usuario. No continuará en modo headless.

Sinhala — මෙය කොහොමද පාවිච්චි කරන්නේ

Cursor එකේ QAFusionX MCP එක connect කළාම Ask mode එකට යන්න. මුලින්ම project එක සහ test කරන්න ඕන දේ, URL එක, screenshot එක අහනවා. ඊට පස්සේ අනිවාර්යයෙන් user stories අහනවා — zip, Jira link, හෝ system එකෙන් generate. මේ දෙකම උත්තර දුන්නට පස්සේ විතරක් crawl / test generation පටන් ගන්න පුළුවන්. කිසිම step එකක් skip කරලා ඊළඟ එකට යන්න බෑ; step-by-step/ තියෙන tick එක තමයි ඊළඟ unlock එක.

මේක කිසිම සෙත්ම pipeline එකක් ඇතුළේ කරනවා වගේ කරන්න එපා. හැම user කෙනෙක්ගේමම device එකේ වෙනම browser එකක් open වෙලා ඒකෙන් පේන්න ඕන. Headless lock කරලා තියෙනවා.