Saltar a contenido

Neo by Crowdar

Inicio

Bienvenido/a al manual de usuario de NEO. 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 compatible (Claude Code, Codex o GitHub Copilot) 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, ejecutarlos y repararlos si fallan, y escribir el reporte final. Ver la tabla de compatibilidad en Requisitos y puesta en marcha para los detalles de cada asistente.

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.
  • Cada skill disponible, en detalle: qué hace, qué datos necesita, cómo trabaja paso a paso y qué entrega.
  • Cada plan del engine: la versión automática de un flujo, que ejecuta el engine de NEO solo (por ejemplo, desde el pipeline), sin un asistente de IA ni una persona del otro lado.

2. Instrucción de uso de este manual (y su fundamento)

Instrucción — cómo leer este manual

  1. 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.
  2. 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.
  3. 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.
  4. 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é NEO 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
Tengo que configurar Playwright, Lippia, Cypress o Pytest para que NEO los use Configurar los adapters
Tengo que conectar los MCP (Playwright, Jira, Azure DevOps) a mi IDE o app de escritorio Configurar los MCP
Quiero ejecutar NEO sin asistente de IA, desde la terminal o un pipeline (Modelos 2 y 4) El engine de NEO
Quiero saber qué hace un plan del engine, o en qué se diferencia de un playbook Planes
Quiero escribir o modificar un plan del engine Anatomía de un plan y Patrones de composición
Quiero que NEO se ejecute solo en el pipeline (GitLab, GitHub o Bitbucket) Configurar el CI
Necesito ejecutar un playbook puntual Buscalo en el índice de instructivos más abajo
Necesito saber qué inputs necesita una skill puntual, o qué devuelve Skills — Índice y referencia técnica

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 NEO.
Primeros pasos La guía paso a paso, numerada, para dejar tu computadora lista para trabajar con NEO por primera vez.
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.
Configurar los adapters Cómo dejar configurado Playwright, Lippia, Cypress o Pytest para que NEO genere, ejecute y repare los tests.
Configurar los MCP Cómo conectar los servidores MCP de NEO en el IDE (Claude Code, Copilot, Codex, Cursor), en apps de escritorio (Claude Desktop, ChatGPT Desktop, Copilot app) y en la terminal.
El engine de NEO Qué es el engine, sus requisitos, cómo ejecutarlo, cómo funcionan los Modelos 2 y 4 por dentro, cómo se escribe un plan y los 7 patrones de composición.
Planes Qué es un plan, en qué se diferencia de un playbook (el plan lo ejecuta el engine; el playbook, el asistente de IA) y qué hace cada plan disponible.
Configurar el CI Cómo generar y configurar el pipeline de NEO en GitLab CI, GitHub Actions y Bitbucket Pipelines: archivos, variables, labels y limitaciones de cada plataforma.
Skills — Índice y referencia técnica El detalle de cada skill del proyecto agrupada por uso: cuándo se dispara, qué información necesita y qué devuelve.

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.
Exploratory Testing Portfolio Necesitás explorar una aplicación (o una parte amplia) sin guion fijo, con sesiones acotadas y un reporte consolidado.
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.

5.1 Catálogo de skills

Las skills están documentadas por categoría en el Catálogo de skills:

Categoría Skills
Configuración e infraestructura lippia-neo-bootstrap-stack, lippia-neo-ci-bootstrap
Lectura e ingesta lippia-neo-read-user-story, lippia-neo-fetch-user-story, lippia-neo-read-bug-report, lippia-neo-resolve-user-story-source, lippia-neo-read-test-plan
Clasificación y enrutamiento lippia-neo-classify-task, lippia-neo-build-plan-input, lippia-neo-classify-ui-scope
Planificación lippia-neo-create-test-plan, lippia-neo-discover-exploratory-areas, lippia-neo-create-exploratory-charters
Cobertura existente lippia-neo-find-existing-tests, lippia-neo-find-ui-tests-by-code-diff, lippia-neo-review-test-coverage
Exploración lippia-neo-run-manual-testing, lippia-neo-reproduce-bug, lippia-neo-run-exploratory-session
Ejecución automatizada lippia-neo-generate-test-suite, lippia-neo-run-and-heal, lippia-neo-repair-selectors-by-diff
Orquestación lippia-neo-meta-run-user-story-e2e, lippia-neo-meta-run-exploratory-testing
Reportes lippia-neo-write-test-report, lippia-neo-write-generation-report, lippia-neo-write-exploratory-testing-report
Gestión de bugs lippia-neo-generate-bug, lippia-neo-report-bug
Exportación de casos lippia-neo-meta-normalize-test-cases, lippia-neo-meta-export-test-cases, lippia-neo-export-test-cases-xray
Gobernanza lippia-neo-relay-human-approval

5.2 Índice de planes

Los planes son flujos que ejecuta el engine de NEO solo, normalmente desde el pipeline de CI. Muchos son la versión automática de un playbook. Ver Planes para la comparación completa.

Plan Cuándo se ejecuta Playbook relacionado
Feature - New End-to-End Se abre un MR con el label feature: hay que probar desde cero una funcionalidad nueva. Feature - New End-to-End
QA Bug Coverage Un bug pasa a QA: confirmar que se reproduce y dejar un test que lo capture. Bug Fix Cycle
QA Bug Fix Verification El developer aplicó el arreglo de un bug: verificar que sus tests ahora pasan. Bug Fix Cycle
UI Selector Repair Un cambio de frontend renombró selectores: corregir los tests afectados antes del deploy. Frontend UI Change PR

6. Repositorio del proyecto

El código y la documentación de NEO viven en GitLab:

https://gitlab.crowdaronline.com/lippia/products/neo/neo-releases

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.