AutoQA-Agent es una herramienta tipo Docs-as-Tests que permite escribir pruebas de aceptación en Markdown y ejecutarlas mediante un bucle ligero de agente IA junto con Playwright. La idea central es tratar las pruebas como documentación viva y usar un agente para observar, actuar y recuperarse ante fallos transitorios, reduciendo la fragilidad típica de los scripts de UI y dejando artefactos útiles para depuración.
Características principales: interacciones snapshot first y ref first para reducir roturas por refactorizaciones de interfaz, especificaciones en Markdown para facilitar la contribución de usuarios no desarrolladores, generación automática de logs, snapshots, capturas y trazas, y exportación de ejecuciones exitosas a tests compatibles con @playwright/test. Esto facilita que lo aprobado se convierta en pruebas reproducibles en CI y localmente.
Cómo funciona a alto nivel: el agente parsea el Markdown en precondiciones y pasos ordenados, ejecuta un bucle observar actuar recuperar usando un SDK de agente, utiliza snapshots accesibles con referencias estables para acciones ref first y en caso de errores devuelve errores estructurados para permitir reintentos controlados por guardrails.
Inicio rápido y requisitos: Node.js mayor o igual que 20, preferiblemente autorización Claude Code o bien la variable ANTHROPIC_API_KEY. Instalación y ejecución básica incluye clonar el repo, instalar dependencias, compilar e invocar comandos como autoqa init y autoqa run especificando la ruta del spec y la base URL. Las ejecuciones generan una carpeta de artefactos con logs, snapshots, capturas y trazas que facilitan el análisis de fallos en local y CI.
Ejemplo de especificación en Markdown: un spec puede incluir precondiciones como que exista una cuenta de prueba, pasos secuenciales para navegar, verificar la visibilidad de formularios, rellenar campos y pulsar botones y aserciones que empiezan con palabras como Verify o Assert. Las especificaciones sencillas permiten que PMs y QAs lean y mantengan las pruebas sin necesidad de manejar código complejo.
Artefactos generados tras la ejecución: .autoqa/runs/runId con run.log.jsonl, ir.jsonl, capturas en screenshots, snapshots y trazas. Además las especificaciones que pasan pueden exportarse a tests/autoqa con archivos .spec.ts compatibles con Playwright, permitiendo conservar lo que funcionó como pruebas automatizadas tradicionales.
En Q2BSTUDIO somos especialistas en desarrollo de software y aplicaciones a medida, ofreciendo soluciones de software a medida y aplicaciones a medida para empresas que necesitan productos adaptados a sus procesos. Integramos capacidades de inteligencia artificial e ia para empresas, desarrollamos agentes IA y soluciones de Business Intelligence y power bi, y ofrecemos servicios de ciberseguridad y pentesting para proteger sus activos. Si necesita potenciar sus plataformas con soluciones a medida puede consultar nuestra oferta de software a medida y aplicaciones a medida o descubrir nuestros servicios de inteligencia artificial para empresas. También cubrimos servicios cloud aws y azure, servicios inteligencia de negocio, automatización de procesos y más.
Roadmap y contribuciones: se planea enriquecer la exportación semántica, añadir más ejemplos y proyectos demo y mejorar la documentación y diagramas. Si desea contribuir o probar AutoQA-Agent busque el repositorio oficial y participe con issues y pull requests; para proyectos llave en mano y consultoría especializada contacte con Q2BSTUDIO para integrar pruebas automatizadas, agentes IA y soluciones de inteligencia de negocio adaptadas a su entorno.
