Agentic QA Boilerplate
The QA workflow, but AI runs it. Playwright + KATA + TypeScript, con un principio simple: AI works, human decides.
bunx create-agentic-qa@latest mi-proyecto-qaUn comando: descarga el template, limpia el historial git, renombra el proyecto, corre bun install y lanza el instalador interactivo (memoria Engram, skills, MCPs, .env).
Vos decidís, el agente opera
El boilerplate convierte a tu asistente de IA en un QA que trabaja sobre tu stack real. Vos ponés el criterio; él pone las manos.
Vos
Escribís el ticket y tomás las decisiones
El agente
Ejecuta el ciclo QA completo con skills
Tu stack
- Checkpoints humanos: el agente frena y espera tu OK antes de cada decisión que importa.
- Opera Jira, Xray y GitHub de verdad: comenta, transiciona tickets y abre PRs, sin que copies nada a mano.
- Memoria entre sesiones con Engram: lo que decidiste hoy sigue vigente mañana.
Una corrida de /sprint-testing
Un ticket trabajado de punta a punta: plan de testing, tu OK, ejecución trifuerza (UI + API + DB), reporte y transición en Jira.
claude — mi-proyecto-qa
/sprint-testing SCRUM-123
Leo la story: "Descuento por código promocional en checkout". 3 criterios de aceptación, 2 flujos de borde. Armo el plan de testing (ATP).
bun run jira:sync-issues(get SCRUM-123)
ATP listo: 8 test cases (3 happy path, 5 de borde)
esperando tu OKdale, subilo y ejecutá
acli jira workitem update(SCRUM-123 · publica el ATP como comentario)
Ejecuto con exploración trifuerza sobre staging: UI, API y base de datos.
playwright-cli(open staging --persistent · flujo de descuento en checkout)
curl(POST /api/checkout · code=PROMO20 · 200 OK)
dbhub query(SELECT total, discount FROM orders ORDER BY created_at DESC)
8/8 test cases ejecutados · 1 observación menor · evidencia adjunta
Reporte de testing (ATR) redactado con evidencia y veredicto sugerido: aprobar.
Veredicto final de la story
esperando tu OKaprobada
acli jira workitem transition(SCRUM-123 → QA Approved)
SCRUM-123 en QA Approved · ATR publicado como comentario QA
Del backlog a la regresión, con checkpoints humanos
El pipeline cubre desde el shift-left pre-sprint hasta la regresión en CI/CD. Los pasos rosas son tuyos: ahí el agente frena y espera.
Onboarding
/project-discovery
Stage 0
Shift-Left QA
Estimación
PO + Dev
S1 Planning
ATP
OK al plan
decidís vos
S2 Execution
trifuerza
S3 Reporting
ATR
Veredicto
decidís vos
S4 Documentation
TMS
S5 Automation
KATA
PR review
decidís vos
S6 Regression
CI/CD
El agente toca Jira y GitHub de verdad
Workflow completo en Jira: Backlog → Shift-Left QA → Estimation → Ready For Dev → In Progress → In Review → Ready For QA → In Test → QA Approved. Y del lado de GitHub, la suite KATA entra por PR con checks verdes.
upex.atlassian.net/jira/software/projects/SCRUM/boards/1
Proyecto SCRUM
Sprint 14 · activoIn Progress
1Refactor del carrito
Ready For QA
1Login social con Google
In Test
1Descuento por código promocional
QA Approved
2Búsqueda por categoría
Checkout como invitado
github.com/tu-org/tu-proyecto/pull/87
test(checkout): KATA suite for discount flow #87
quiere mergear test/SCRUM-123-discount-flow en main
claude · pr-review-lead aprobó estos cambios
Suite alineada al ATP: 8 ATCs, selectores estables, retries: 0. Listo para merge.
Todos los checks pasaron
- TestBuild ChecksSuccessful
- typesSuccessful
- lintSuccessful
KATA: Komponent Action Test Architecture
Komponent Action Test Architecture es el nombre; las capas son otras. Los tests orquestan, los fixtures inyectan, los componentes de dominio implementan y la base habla con el mundo.
Test files
orquestan ATCs, no implementan
tests/Fixtures
inyección de dependencias
*Fixture.tsSteps
cadenas de precondición reutilizables (opcional)
Domain Components
métodos @atc por dominio: UsersApi, LoginPage
tests/components/Base
ApiBase / UiBase
TestContext
config, logger, faker, entorno
Transversal a todas las capas
Utilities
decoradores @atc y @step
Test data
factories, tipos y constantes
Variables
entorno y URLs por proyecto
la capa superior usa la inferior, nunca al revés · retries: 0
¿Querés ir a fondo en la arquitectura? Explorar KATA Academy
Todo incluido, nada que armar
El scaffolder deja el sistema entero listo: skills, commands, MCPs, integración con el TMS, reportes y memoria persistente.
15 skills
El ciclo QA entero (shift-left, sprint, docs, automation, regresión) más git, review adversarial, onboarding y CLIs de Atlassian.
9 commands
De /master-test-plan a /sync-ai-memory: business maps, adaptación del framework, trazabilidad y más.
6 MCPs
context7, tavily, playwright, dbhub, openapi y postman, preconfigurados en .mcp.json.
Xray / Jira nativo
Test cases, ATPs, ATRs y ejecuciones sincronizados con el TMS desde el repo.
Allure 3
Reportes de ejecución publicados por CI/CD en cada suite de regresión.
Memoria Engram
El agente guarda decisiones, bugs y convenciones que sobreviven entre sesiones.
El oficio, explicado
No son cursos: son decks explicativos por skill, directo del maestro. Abrí cualquiera y mirá 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 funcionaTest 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 funcionaSprint Testing
QA manual por ticket dentro del sprint: Planning → Execution → Reporting, con gates humanos en cada checkpoint.
Ver cómo funcionaShift-Left Testing
QA pre-sprint sobre un lote de Stories: refina Acceptance Criteria, saca a la luz gaps y ambigüedades, y deja el ATP redactado en el campo de la Story, en madurez outline.
Ver cómo funcionaRegression 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 funcionaXray 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¿Hacés dev además de QA?
Agentic Dev Boilerplate
El mismo sistema, para el lado dev. De PRD a staging deploy.
- Skills para el ciclo de desarrollo completo, con los mismos checkpoints humanos.
- La misma dupla Jira + GitHub, operada por el agente.
Probalo en tu próximo ticket
Un comando instala todo. Después, /project-discovery aprende tu proyecto y ya podés trabajar tickets con QA agéntico.
bunx create-agentic-qa@latest mi-proyecto-qa
cd mi-proyecto-qa
/project-discovery
/sprint-testing SCRUM-123Cuando /project-discovery genera el .context/ de tu proyecto, /sprint-testing ya puede trabajar tickets de punta a punta.
El repo es público y MIT: usalo, forkealo, mejoralo.