QA Framework

Framework multiagente de testing automatizado para VS Code. Coordina un equipo de 15 agentes especializados y 10 skills para planificar, diseñar, ejecutar y documentar pruebas.

Estructura del proyecto

qa-framework/
├── .github/
│   ├── agents/                     # 15 agentes (.agent.md)
│   ├── skills/                     # 10 skills ({name}/SKILL.md)
│   ├── instructions/               # Instrucciones globales del framework
│   └── copilot-instructions.md     # Reglas del sistema QA
│
├── .vscode/
│   ├── mcp.json                    # Servidores MCP (Playwright, Selenium, Postman, Jira)
│   └── settings.json
│
├── qa/
│   ├── context/                    # Ambientes, apps, dispositivos, credenciales
│   ├── diagrams/                   # Diagramas de arquitectura y flujo de agentes
│   ├── docs/                       # Arquitectura, reglas del sistema, convenciones Jira
│   ├── domain/                     # Escenarios y casos de prueba del proyecto
│   ├── evidence/                   # Evidencia de ejecuciones (screenshots, logs, reportes)
│   ├── knowledge/                  # Changelog e historial de ejecuciones
│   ├── scripts/                    # Scripts de instalación
│   ├── templates/                  # Plantillas para outputs de agentes
│   └── tools/                      # Herramientas de testing (JMeter, jmeter-mcp-server)
│
├── .env                            # Variables de entorno (no commitear)
├── README.md
└── VERSION.md

Instalación

Requisitos: Node.js 18+ y Visual Studio Code.

npm install -g qa-framework-cli

Comandos disponibles

qa-framework install

Copia el framework en el workspace actual (o en el path indicado).

# Instalar en el directorio actual
qa-framework install

# Instalar en un workspace específico
qa-framework install --path "C:\mi-proyecto"

# Sobreescribir archivos existentes
qa-framework install --force

| Opción | Descripción | |--------|-------------| | --path | Directorio destino (default: .) | | --force | Sobreescribe archivos ya existentes |

qa-framework update

Actualiza todos los archivos del framework en el workspace. Equivale a install --force.

qa-framework update

qa-framework update --path "C:\mi-proyecto"

| Opción | Descripción | |--------|-------------| | --path | Directorio destino (default: .) |

qa-framework uninstall

Elimina todos los archivos del framework del workspace. Solicita confirmación antes de proceder.

qa-framework uninstall

qa-framework uninstall --path "C:\mi-proyecto"

| Opción | Descripción | |--------|-------------| | --path | Directorio destino (default: .) |

Workflow típico

# 1. Instalar el paquete globalmente
npm install -g qa-framework-cli

# 2. Ir al workspace de VS Code
cd C:\mi-proyecto

# 3. Desplegar el framework
qa-framework install

# 4. Cuando salga una nueva versión
npm update -g qa-framework-cli
qa-framework update

Nota: Al ejecutar qa-framework install, el CLI avisa automáticamente si hay una versión más nueva disponible en npm.

Solución de problemas en Windows

Si al ejecutar npm o qa-framework en PowerShell aparece el error "running scripts is disabled on this system", es porque la política de ejecución de PowerShell bloquea scripts .ps1.

Solución rápida (sin permisos de administrador, aplica solo a la sesión actual):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

Solución permanente (recomendado):

Abrí PowerShell como Administrador y ejecutá:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Configuración post-instalación

[!CAUTION] Completar .vscode/mcp.json con usuario, token de Jira y API key de Postman. Sin esto no se podrán utilizar los MCPs integrados al framework.

1. Abrir el proyecto en Visual Studio Code.
2. En el panel de chat de GitHub Copilot, seleccionar el agente qa-orchestrator.
3. Escribir: ¿Qué puedo hacer?

Inventario de agentes

| Agente | Rol | Nivel | |----------------------|-------------------------------------------------------|-------| | qa-orchestrator | Punto de entrada. Routea por tipo_tarea | N0 | | qa-analyst | Único que habla con el usuario. Clasifica y prepara | N1 | | qa-context-fetcher | Recopila contexto de Jira/SharePoint/local | N2 | | qa-feature | Genera escenarios y casos de prueba | N1 | | qa-regression | Ejecuta suites existentes, genera faltantes | N1 | | qa-exploratory | Testing heurístico con 25 heurísticas | N1 | | qa-performance | Pruebas de carga (k6, artillery) | N1 | | qa-data-generator | Genera datos de prueba por canal | N1 | | qa-data-provider | Resuelve datos dinámicos en runtime | N2 | | qa-visual | Consistencia visual y look & feel | N1 | | qa-mobile | Ejecutor canal mobile (Appium + UiAutomator2) | N2 | | qa-web | Ejecutor canal web (Playwright MCP) | N2 | | qa-api | Ejecutor canal API (HTTP/Newman) | N2 | | qa-reporter | Dashboard HTML + tickets Jira. Cierra todo run | N1 | | jira-atlassian | Operaciones directas en Jira vía MCP | N1 |

Inventario de skills

| Skill | Categoría | Agente principal | |------------------------|-------------|---------------------| | context-analysis | analysis | qa-analyst | | standards | standards | qa-feature | | test-design | design | qa-feature | | data-analysis | analysis | qa-feature | | mobile-automation | automation | qa-mobile | | web-automation | automation | qa-web | | api-testing | testing | qa-api | | observability | performance | qa-performance | | exploratory-testing | testing | qa-exploratory | | visual-consistency | visual | qa-visual |