Boilerplate · Playwright · KATA · Jira/Xray
Un repo instalable con un comando que trae el oficio entero: desde refinar los acceptance criteria antes del sprint hasta la decisión de release en CI. Cada stage lo ejecuta un skill, y la trazabilidad hacia Jira y Xray viene cableada de fábrica.
package.json y
.agents/project.yaml
bun install y el installer interactivo
gh si se lo pedís
Requisitos duros: Bun y al menos uno de Claude Code, OpenCode o Codex.
01 · El pipeline
No son seis carpetas sueltas: es una secuencia. Cada stage recibe el artefacto del anterior y produce el que el siguiente necesita. Lo que empieza como un acceptance criterion ambiguo en el backlog termina siendo un test automatizado que vota en la decisión de release.
→ deslizá el diagrama
/sprint-testing cubre tres stages seguidos, el resto uno cada uno. Abajo,
lo que cada stage deja escrito. Los dos saltos anchos son los únicos handoffs con
condición: una Story sale del backlog cuando el shift-left la firma, y un test case
cruza a automatización solo con verdict Candidate.
Refina los acceptance criteria del backlog antes de que la Story entre al sprint: gaps, ambigüedades y el ATP a nivel outline escrito directo en el custom field de Jira. El defecto se previene en el requisito, no se detecta después.
QA manual por ticket, de punta a punta: planning con la familia ATP / ATS / ATR, ejecución explorando con la Trifuerza (UI · API · DB) y reporte final con los bugs clasificados y trazados a la Story.
Documenta los test cases en el TMS y los puntúa por ROI: qué se automatiza, qué queda manual y qué se difiere. El verdict Candidate es la única puerta hacia el Stage 5.
Plan → Code → Review sobre KATA + Playwright + TypeScript. Cada test case Candidate se convierte en un ATC con su ID de trazabilidad y viaja en un Pull Request revisable.
Corre las suites por CI/CD, clasifica cada fallo (bug real, test frágil o entorno) y emite la decisión de release. Es el único stage que le contesta al equipo con un veredicto, no con un artefacto.
Test management de Xray desde la terminal: tests, planes, ejecuciones e import de resultados. Es el brazo que escribe en el TMS lo que los stages deciden.
02 · Trazabilidad
Cada altitud de planificación tiene su artefacto, y cada artefacto tiene dueño y momento. Lo que parece burocracia de acrónimos es el mecanismo que hace que un test corriendo en CI se pueda rastrear hasta el acceptance criterion que lo originó.
→ deslizá el diagrama
El release de agosto reescribió esta parte: el árbol PBI dejó de commitearse en git, apareció el ATS y el modelo de coverage se verificó en vivo contra una instancia real de Xray. Leer el release de arquitectura →
Si lo que buscás es cómo se organiza la gestión de pruebas completa — la escalera MTP / FTP / STP / ATP, los cuatro epics de proceso en Jira, quién produce cada artefacto y cómo bajan al caché local — está todo en Test Management Architecture →
03 · Compatibilidad
El repo corre igual en Claude Code, OpenCode y Codex, en CLI y en Desktop. No hay tres copias de las instrucciones ni tres carpetas de skills: hay una sola fuente y adaptadores finos donde los hosts realmente difieren.
→ deslizá el diagrama
AGENTS.md nativo, Claude Code lo alcanza por un shim de una línea. Todo
lo generado se verifica en el pre-push.
AGENTS.md es el único cuerpo. CLAUDE.md es un shim generado
que solo lo importa: prosa operativa ahí adentro es drift y falla el check.
.agents/skills/. Claude Code las alcanza por
un alias generado y gitignoreado, nunca por una copia.
04 · Academia
Los decks que explican el porqué detrás de cada stage: cómo se nombra, cómo se explora, cómo se clasifica un defecto y cómo habla el agente.
Cómo se nombra todo en el pipeline: artefactos, tests, ramas, IDs.
TransversalQué lee y qué produce cada skill, con una pestaña por fase.
TransversalEl contrato de voz del agente: qué dice, con cuánto detalle y en qué registro.
Stage 0Prevenir, no detectar: los defectos que mueren en los requisitos.
Stage 2Lo que se ve, lo que viaja y lo que queda, probados por separado.
Stages 2-3Bug vs Defect vs Improvement, severidad, prioridad y traza a la Story.
Stage 4Del hallazgo suelto al test case que otro pueda ejecutar sin preguntarte.
05 · Currículum
Ruta pedagógica secuencial para testers que arrancan sin código. Se sigue en orden: fundamentos → Playwright → arquitectura KATA.
06 · CI/CD en vivo