Volver a Setup
Template oficial QA 2026

Agentic QA Boilerplate

Skills-based AI workflows para todo el ciclo QA, sobre Playwright + KATA + TypeScript.

Playwright 1.60+TypeScript 5.8+Bun 1.0+MIT License
bunx create-agentic-qa@latest mi-proyecto-qa

Un comando: descarga el template, limpia el historial git, renombra el proyecto, corre bun install y lanza el instalador interactivo (memoria Engram, skills, MCPs, .env).

Ver repo en GitHubGetting-startedTour completo (30 min)
¿Por qué este boilerplate?

5 pilares de un framework moderno

Resuelve los problemas crónicos del test automation: contexto, escalabilidad, integración, CI/CD y type safety.

AI-Ready

Sistema de context engineering que permite a la IA escribir tests con conocimiento real del proyecto.

KATA Architecture

Component Action Test Architecture: 4 capas que separan responsabilidades y maximizan reutilización.

TMS Integration

Sync nativo con Jira y Xray para administrar Test Cases, ATPs, ATRs y resultados desde el repo.

CI/CD Ready

Workflows de GitHub Actions preconfigurados: build, smoke, sanity, regression y publicación de reportes Allure.

Type-Safe

TypeScript con strict mode habilitado. Cero ambigüedad: el compilador atrapa los errores antes de runtime.

Lifecycle

Las 5 fases QA

Desde bootstrap hasta maintenance: un pipeline mental claro para llevar el proyecto de cero a producción.

0

Bootstrap

El magic command descarga, limpia historial git, renombra el proyecto y corre el instalador.

1

Discovery

/project-discovery escanea tu proyecto real: contexto, business maps, master test plan.

2

Adapt

/framework-development wirea KATA a tu stack: config/, api/schemas/, tests/components/.

3

Daily QA

Sprint loop: planning, execution, reporting, documentación y automation por ticket.

4

Maintenance

/sync-ai-memory mantiene el contexto de IA alineado cuando el código cambia.

13 skills incluidos

Workflows agénticos listos para usar

Cada skill es un workflow autónomo que la IA invoca según contexto. Activación por slash command o por descripción.

/sprint-testing

QA in-sprint

QA manual por ticket en 3 stages: Planning, Execution, Reporting.

/test-documentation

Test docs & ROI

Documenta y prioriza test cases en el TMS — puente manual↔automatización.

/test-automation

KATA automation

Plan → Code → Review de tests automatizados sobre Playwright + KATA + TS.

/regression-testing

Regression GO/NO-GO

Suites de regresión vía CI/CD, clasifica fallas, decide GO/NO-GO.

/shift-left-testing

Shift-Left

QA shift-left pre-sprint sobre un batch de stories del backlog.

/project-discovery

Reverse-engineering

Onboardea tu proyecto real y genera los archivos de contexto que necesita cada sesión.

/framework-development

Framework evolution

Evoluciona el boilerplate mismo — KATA, fixtures, cli/, scripts/, schemas.

/agentic-qa-onboard

Onboarding guiado

Recorrido de primera vez: stack, flujo Jira QA, MCPs disponibles.

/agentic-qa-core

Foundation references

Skill fundacional: briefing template, dispatch patterns, doctrina de orquestación.

/git-flow-master

Git operator

Operador Git integral para cualquier estrategia de branching.

/judgment-day

Dual review

Review adversarial: juzga el trabajo antes de mergear.

/acli

Atlassian CLI

Jira Cloud, Confluence y tareas admin desde terminal.

/xray-cli

Xray test management

CLI de Xray Cloud: tests, ejecuciones, planes, importes JUnit/Cucumber.

Cómo funciona cada skill

El oficio, explicado

No son cursos: son decks explicativos por skill, directo del maestro. Abre cualquiera y mira el skill en acción.

Test Automation (KATA)

Planifica, escribe y revisa tests automatizados KATA sobre Playwright + TypeScript — Plan → Code → Review, nunca directo al código.

Ver cómo funciona

Test Documentation & ROI

El puente entre QA manual y automatización: analiza, prioriza con ROI y documenta test cases en el TMS con trazabilidad completa.

Ver cómo funciona

Sprint Testing

QA manual por ticket dentro del sprint: Planning → Execution → Reporting, con gates humanos en cada checkpoint.

Ver cómo funciona

Shift-Left Testing

QA pre-sprint sobre un lote de Stories: refina Acceptance Criteria, saca a la luz gaps y ambigüedades, entrega un ATP DRAFT.

Ver cómo funciona

Regression Testing & GO/NO-GO

Ejecuta la suite en CI, clasifica cada fallo con evidencia y convierte el resultado en un veredicto de release: GO / CAUTION / NO-GO.

Ver cómo funciona

Xray para Jira

Gestión de pruebas en Xray Cloud desde la terminal: Tests, Test Plans, Executions, import de resultados, evidencia y defectos — todo vía bun xray.

Ver cómo funciona
Configuración dual

Dos sistemas, dos consumidores

No los confundas: uno alimenta a Playwright en runtime, el otro al agente de IA en bootstrap.

Runtime config

.env + config/variables.ts
  • Consumidor: Playwright runner, KATA components, scripts (jiraSync, env validate).
  • Cuándo se carga: al ejecutar tests.
  • Credenciales por entorno (local / staging), TMS, browser flags.

AI context engineering

.agents/project.yaml
  • Consumidor: Claude Code, Codex, Cursor, Copilot, OpenCode.
  • Cuándo se carga: al iniciar la sesión de IA.
  • Resuelve {{VAR}} en skills, templates y commands.
Quick Start

De cero a primer test en minutos

Un comando instala todo. Después dejas que la IA descubra tu proyecto y adapte el framework por ti.

bunx create-agentic-qa@latest mi-proyecto-qa
cd mi-proyecto-qa

# Claude Code / Codex / Cursor / Copilot / OpenCode ya quedan listos
/project-discovery
/sprint-testing

Una vez que /project-discovery genera el .context/ real de tu proyecto, ya puedes correr /sprint-testing y empezar a trabajar tickets con QA agéntico end-to-end.

Tour completo · 30 min

16 slides: mental model, magic command, pipeline, Engram, catálogo completo de skills y diferenciadores clave.

Ver la presentación

KATA Academy

Documentación interactiva de la arquitectura KATA, en el sitio del propio repo — para quien quiere ir a fondo en automatización. También ahí: los 26 decks y la home del proyecto.

Explorar KATA Academy
🚀

Instala y empieza

El template oficial QA 2026, un comando. MIT, gratis, listo para tu próximo proyecto.

bunx create-agentic-qa@latest mi-proyecto-qa
o mira el repo primero