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.58+TypeScript 5.8+Bun 1.0+MIT License
Clonar BoilerplateVer getting-started
¿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 y regression listos para correr.

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

Foundation install: regenera AGENTS.md, .agents/, scripts y package.json.

1

Discovery

Escaneo del target app: PRD, SRS, business maps, master test plan.

2

Adapt

KATA wire: config/, api/schemas/ y tests/components/ adaptados a tu stack.

3

Daily QA

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

4

Maintenance

Drift fix: refresh-ai-memory para mantener AGENTS.md alineado al código.

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

In-sprint QA loop

Stages 1-3 por ticket: planning, execution, reporting.

/test-documentation

Test docs ROI-driven

Stage 4: documenta y prioriza tests en Jira/Xray con rúbrica ROI.

/test-automation

KATA automation pipeline

Stage 5: Plan → Code → Review sobre Playwright + KATA + TS.

/regression-testing

Regression GO/NO-GO

Stage 6: smoke, sanity y regression con clasificación de fallas.

/project-discovery

Reverse-engineering

Discovery 4-fases: Constitution, Architecture, Infrastructure, Specification.

/adapt-framework

KATA wire to your stack

Adapta config/, schemas y components al stack real del target.

/refresh-ai-memory

Doc drift fix

Regenera secciones específicas de AGENTS.md cuando el código cambia.

/framework-core

Foundation references

Bootstrap + briefing template + dispatch patterns + orchestration doctrine.

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

Cloná, instalá, configurá el contexto, y dejá que la IA descubra y adapte el framework por vos.

# Cloná el template oficial
git clone https://github.com/upex-galaxy/agentic-qa-boilerplate.git
cd agentic-qa-boilerplate

# Instalá dependencias y browsers de Playwright
bun install
bun run pw:install

# Configurá el contexto AI (interactivo)
bun run agents:setup

# En Claude Code, corré los workflows:
/project-discovery
/adapt-framework

Una vez que /project-discovery genera el .context/ y /adapt-framework wirea KATA al stack real, ya podés correr `bun run test:e2e` y empezar a automatizar tickets con /sprint-testing.

🚀

Cloná y empezá

El template oficial QA 2026 te espera en GitHub. MIT, gratis, listo para tu próximo proyecto.

Ir al repo en GitHub