Inicio
Bienvenido/a al manual de usuario de "crowdar-qa-skills". Este manual reúne, en un solo lugar, todo lo que necesitás para entender cómo funciona, ponerlo en marcha y usarlo en el día a día — sin necesidad de saber programar o tener un conocimiento técnico previo.
1. Presentación
NEO es un conjunto de "skills" (herramientas) que un asistente de IA (Claude) usa para automatizar el trabajo de QA de punta a punta: leer una historia de usuario, armar un plan de pruebas, explorar la aplicación, generar tests automatizados, correrlos y repararlos si fallan, y escribir el reporte final.
Ese trabajo se puede disparar de 4 formas distintas (ver Los 4 modelos de orquestación), y para los flujos que se repiten seguido existen playbooks — recetas ya escritas paso a paso que garantizan que el resultado sea siempre el mismo, sin importar quién se lo pida al asistente.
Este manual documenta:
- Los conceptos generales del sistema (cómo se orquesta el trabajo, qué es un playbook vs. una skill, cómo instalarlo y actualizarlo).
- Cada playbook disponible, explicado en lenguaje simple: qué hace, cuándo usarlo y qué información hay que darle al asistente.
2. Instrucción de uso de este manual (y su fundamento)
Instrucción — cómo leer este manual
- Si es tu primera vez, empezá por Requisitos y puesta en marcha y después Playbooks vs. Skills. Esos dos documentos te dan el vocabulario mínimo para entender todo lo demás.
- Seguí con Los 4 modelos de orquestación para entender quién decide el flujo de trabajo y quién lo ejecuta en cada caso.
- Andá a la sección "Instructivos" solo cuando necesites ejecutar un playbook puntual (por ejemplo, vas a hacer un smoke test post-deploy, o vas a corregir un bug). No hace falta leerlos todos de antemano — están pensados para consultarse al momento de usarlos, como una receta.
- Si algo no arranca (conexión del MCP, versión desactualizada del repo), consultá primero Configuración del MCP de Playwright o Cómo traer la última versión antes de asumir que es un bug del sistema.
No hace falta leer el manual de punta a punta: cada guía está escrita para poder leerse de forma independiente, sin conocimientos técnicos previos.
Fundamento — por qué existe este manual
Este manual existe porque el trabajo de QA con IA solo es confiable si cualquier persona del equipo, tenga o no perfil técnico, puede entender qué va a hacer el asistente antes de pedírselo, y verificar después que hizo lo que decía que iba a hacer. Sin esa transparencia, un playbook deja de ser una "receta reproducible" y pasa a ser una caja negra.
Por eso cada guía de este manual:
- Usa lenguaje simple, sin jerga de programación, incluso cuando describe algo técnico por dentro.
- Explica qué información tenés que darle al asistente para que el resultado salga bien, no solo qué hace el asistente.
- Documenta el fundamento de cada decisión de diseño (por qué existen 4 modelos y no uno solo, por qué un playbook es distinto de pedirle algo suelto al asistente) para que las decisiones futuras del equipo se apoyen en ese mismo criterio, no se reinventen cada vez.
3. ¿Por dónde empiezo según mi situación?
| Tu situación | Documento a leer |
|---|---|
Nunca usé "crowdar-qa-skills" y necesito instalarlo |
Requisitos y puesta en marcha |
| No entiendo la diferencia entre "skill" y "playbook" | Playbooks vs. Skills |
| Quiero entender quién decide el flujo de trabajo (IA, persona, regla fija) | Los 4 modelos de orquestación |
| Mi copia del repo está desactualizada | Cómo traer la última versión |
| El MCP de Playwright no conecta / falla la exploración | Configuración del MCP de Playwright |
| Necesito ejecutar un playbook puntual | Buscalo en el índice de instructivos más abajo |
4. Índice — Conceptos generales
| Guía | Qué vas a aprender |
|---|---|
| Requisitos y puesta en marcha | Qué necesitás instalado en tu computadora para trabajar con "crowdar-qa-skills". |
| Playbooks vs. Skills | La diferencia entre pedirle algo suelto al asistente y seguir una receta ya escrita. |
| Los 4 modelos de orquestación | Las 4 formas en que el trabajo de QA puede arrancar y ejecutarse, con ejemplos de código en Playwright y Lippia. |
| Cómo traer la última versión | Cómo actualizar tu copia local del repositorio cuando el equipo sube cambios. |
| Configuración del MCP de Playwright | Cómo resolver los incidentes de conexión más comunes al configurar el MCP de Playwright. |
5. Índice de instructivos (por playbook)
| Playbook | Cuándo usarlo |
|---|---|
| New Project Bootstrap | Vas a preparar un proyecto nuevo para empezar a hacer QA sobre él. |
| Feature - New End-to-End | Hay una funcionalidad nueva y necesitás cubrirla con pruebas desde cero. |
| Bug Reproduction | Necesitás confirmar y documentar que un bug reportado realmente ocurre. |
| Bug Fix Cycle | Necesitás corregir un bug y dejar comprobado, con pruebas, que quedó arreglado. |
| Business Rule Change | Una regla de negocio ya documentada cambió a propósito (no es un bug) y hay que actualizar lo que ese cambio afecta. |
| Frontend UI Change PR | Hay un PR de frontend y necesitás decidir si amerita un smoke test o una regresión completa de UI. |
| Regression on Module | Necesitás re-probar un módulo puntual porque algo cambió cerca de él. |
| Smoke Test Post-Deploy | Se acaba de hacer un deploy y necesitás confirmar rápido que nada se rompió. |
| Hotfix Fast Track | Hay que validar un arreglo urgente antes de liberarlo, con el menor tiempo posible. |
| Demo Walkthrough | Necesitás mostrarle a un cliente o stakeholder cómo se probó una funcionalidad. |
6. Repositorio del proyecto
El código y la documentación de "crowdar-qa-skills" viven en GitLab:
https://gitlab.crowdaronline.com/lippia/products/neo/crowdar-qa-skills
Si necesitás clonarlo por primera vez o traer los últimos cambios, mirá Cómo traer la última versión.
Versión actual de este manual: v1.0.0
Si no encontrás el playbook que necesitás, o el flujo que buscás todavía no tiene una receta escrita, podés pedírselo al asistente directamente en lenguaje natural — es el Modelo 1 (Improvisado) descripto en Los 4 modelos de orquestación.