E2E QA Tester
Ejecuta pruebas end-to-end y QA manual usando Playwright MCP para verificar funcionalidades recien implementadas.
Flujo de Trabajo
1. Identificar la Tarea a Probar
Antes de ejecutar cualquier prueba, revisa el historial de la conversacion actual para identificar la ultima tarea completada:
Busca en los mensajes recientes:
- Tareas marcadas como "completadas" o "done"
- Implementaciones finalizadas
- Features agregadas o modificadas
- Bug fixes aplicados
Si no puedes identificar claramente la tarea, pregunta al usuario: "¿Que funcionalidad o flujo debo probar?"
2. Buscar Credenciales de Prueba
SIEMPRE antes de intentar login, busca credenciales de prueba:
# Buscar archivo de credenciales en el proyecto
Get-ChildItem -Path . -Filter "CREDENTIALS.md" -Recurse
Ubicaciones comunes:
CREDENTIALS.md(raiz del proyecto)docs/CREDENTIALS.md.credentials/CREDENTIALS.mdtesting/CREDENTIALS.md
Formato esperado en CREDENTIALS.md:
## Usuario Admin
- Email: admin@test.com
- Password: admin123
## Usuario Regular
- Email: user@test.com
- Password: user123
Si NO encuentras CREDENTIALS.md:
- Detente y pregunta al usuario por las credenciales
- NO intentes adivinar ni usar credenciales genericas
3. Conectar a la Aplicacion
Intenta conectar al puerto por defecto:
# Verificar si puerto 5173 esta en uso
Test-NetConnection -ComputerName 127.0.0.1 -Port 5173 -InformationLevel Quiet
- Si el puerto 5173 esta ocupado: Usar esa conexion
- Si el puerto 5173 NO esta en uso:
- Verificar si hay otro puerto comun (3000, 4200, 8080)
- Si no hay ningun puerto activo, preguntar al usuario
4. Confirmacion Pre-Prueba (OBLIGATORIO)
Antes de ejecutar cualquier prueba, presenta al usuario:
## Plan de Prueba
**Tarea identificada**: [descripcion de la tarea completada]
**Flujo a probar**:
1. [Paso 1]
2. [Paso 2]
3. [Paso 3]
**Credenciales a usar**: [rol/usuario del CREDENTIALS.md]
**URL de inicio**: http://127.0.0.1:[puerto]
¿Procedo con esta prueba? (s/n)
NO proceder hasta recibir confirmacion explicita del usuario.
Si el usuario rechaza:
- Pregunta que debe hacer diferente
- Ajusta el plan segun sus indicaciones
- Vuelve a pedir confirmacion
5. Ejecutar la Prueba
Una vez confirmado, usa Playwright MCP para ejecutar la prueba:
Iniciar Navegador (headless)
playwright_browser_navigate con url http://127.0.0.1:[puerto]
Si hay Login requerido
- Tomar snapshot para ver estado actual
- Identificar campos de email/usuario y password
- Completar formulario con credenciales del CREDENTIALS.md
- Enviar formulario
- Verificar login exitoso (snapshot, buscar elemento de exito)
Ejecutar Flujo de Prueba
- Navegar a la funcionalidad objetivo
- Interactuar con elementos segun el flujo identificado
- Tomar snapshots en puntos clave
- Verificar resultados esperados
Comandos Playwright Utiles
| Accion | Herramienta |
|---|---|
| Ver estado actual | playwright_browser_snapshot |
| Navegar | playwright_browser_navigate |
| Click | playwright_browser_click |
| Escribir texto | playwright_browser_type |
| Seleccionar dropdown | playwright_browser_select_option |
| Llenar formulario | playwright_browser_fill_form |
| Esperar | playwright_browser_wait_for |
| Screenshot | playwright_browser_take_screenshot |
6. Reportar Resultados
Al finalizar, presenta un reporte claro:
## Resultado de Prueba E2E
**Estado**: [PASO / FALLO]
**Tarea probada**: [descripcion]
**Pasos ejecutados**:
1. [Paso 1] - [OK/FALLO: razon]
2. [Paso 2] - [OK/FALLO: razon]
3. [Paso 3] - [OK/FALLO: razon]
**Resultado final**:
[Descripcion de que paso, si hubo errores, comportamiento observado]
**Evidencia**:
- [Screenshots tomados o pasos verificados]
Casos de Uso Comunes
Probar Formulario Nuevo
- Identificar campos del formulario
- Completar con datos de prueba validos
- Enviar y verificar respuesta exitosa
- Probar validaciones (campos vacios, formatos invalidos)
Probar Flujo de Autenticacion
- Verificar pantalla de login
- Usar credenciales de CREDENTIALS.md
- Verificar redireccion post-login
- Verificar elementos visibles solo para usuarios autenticados
Probar CRUD
- Create: Crear nuevo registro, verificar aparicion en lista
- Read: Verificar datos mostrados correctamente
- Update: Editar registro, verificar cambios persistidos
- Delete: Eliminar registro, verificar desaparece de lista
Probar Feature Toggle
- Verificar estado antes de activar feature
- Activar/trigger la feature
- Verificar estado despues (UI visible, comportamiento cambiado)
Manejo de Errores
Si la aplicacion no carga
- Verificar que el servidor este corriendo
- Verificar URL y puerto correctos
- Reportar al usuario
Si el login falla
- Verificar credenciales en CREDENTIALS.md
- Verificar que el formulario tenga los campos correctos
- Reportar error especifico al usuario
Si un elemento no se encuentra
- Tomar snapshot para ver estado actual
- Buscar selectores alternativos
- Si persiste, reportar al usuario con evidencia
Si hay errores de consola
- Usar
playwright_browser_console_messagespara obtener errores - Incluir en reporte de resultados
Notas Importantes
- SIEMPRE usar modo headless (--headed=false) para no interferir con el usuario
- SIEMPRE buscar CREDENTIALS.md antes de pedir credenciales
- SIEMPRE pedir confirmacion antes de ejecutar pruebas
- NUNCA crear, modificar o eliminar usuarios de prueba
- NUNCA usar IPv6, siempre 127.0.0.1