Acceptance criteria vs. Definition of Done vs. ready
Definition of Done es igual en cada story: tests, review, docs. Los acceptance criteria cambian con el trabajo — “el account owner puede exportar CSV en menos de cinco segundos”. Definition of Ready pregunta si esos ejemplos existen antes de empezar. La lista de verificación de pruebas QA es cómo los demuestras. Usar las tres como listas de verificación en el elemento de trabajo mejora la claridad y reduce la ambigüedad: el estado y los siguientes pasos se ven sin una búsqueda del tesoro.
Un ejemplo: una API que lista incidencias de Jira
Los acceptance criteria suelen diferir de una story a otra: cada lista describe lo que este elemento de trabajo debe entregar. Imagina un ítem de backlog que tu equipo podría tomar de verdad: construir un endpoint GET que devuelva una lista paginada de incidencias de Jira de un proyecto. Producto quiere campos y permisos claros. Engineering quiere paginación y formas de error acordadas. QA quiere algo que pueda demostrar con curl en una demo rápida.
La lista de verificación de abajo es lo que esa story podría llevar en el elemento de trabajo: no una plantilla para cada API, sino un patrón: quién puede llamarla, cómo se ve el éxito, cómo se ve el fallo y cómo mostrarías que funciona.
La mejor prueba de cada fila: ¿alguien puede demostrarlo sin adivinar? La siguiente story tiene su propia lista: la misma idea, ejemplos distintos.
Acceptance criteria — API para listar incidencias de Jira
- Alcance
- Un usuario autenticado con permiso de browse en el proyecto puede llamar GET /issues
- La respuesta es JSON; el trabajo de UI queda fuera de esta story
- Solo se devuelven incidencias en Open, In Progress y Done, salvo que el elemento de trabajo diga otra cosa
- Camino feliz
- GET /issues?project=ENG devuelve 200 con clave, resumen y estado de cada fila
- Los query params page y pageSize funcionan; los valores por defecto están documentados en el elemento de trabajo
- La respuesta incluye el recuento total para que el cliente pueda paginar
- Errores
- Un proyecto desconocido devuelve 404; un usuario sin permiso de browse recibe 403
- Un proyecto sin incidencias devuelve 200 con una lista vacía
- page o pageSize inválidos devuelven 400 con un cuerpo de error claro
- Demo
- Hay un ejemplo curl adjunto: cada fila de arriba se puede demostrar desde él
- Las preguntas abiertas están resueltas o aparcadas antes de que empiece el desarrollo
Esa lista pertenece solo a esta story. En Checklist for Jira añades elementos así directamente en el elemento de trabajo, los marcas cuando aterriza el comportamiento y guardas una plantilla inicial breve cuando se repite la forma de las stories de tu equipo — con ejemplos nuevos escritos cada vez.
Deje la checklist en el elemento de trabajo, no en la descripción
Checklist for Jira aporta plantillas, automatización, validadores de flujo y un agente Rovo. Gratis para equipos de hasta 10 usuarios.
Guarda un arranque, edita por story
- Checklist for Jira añade un panel Checklist en la vista de la incidencia. Añade ahí los acceptance criteria de tu escenario: usa el ejemplo de arriba como patrón y rellena filas para tu trabajo.
- Si quieres un andamiaje reutilizable, guarda los encabezados (alcance, camino feliz, errores, listo para demo) como plantilla de proyecto o global y reescribe cada fila cuando empiece la siguiente story.
- Puedes configurar automatización por plantilla para añadir ese andamiaje cuando se crea una Story o cuando el trabajo pasa a In Progress — o aplicarlo a mano desde Add → Add from template cuando lo necesites.
- Si tu equipo quiere puertas estrictas en el proceso, añade un validador de finalización en una transición de workflow.
- Resetea o actualiza elementos cuando cambie el alcance; combina con Definition of Done al final y la lista de verificación de pruebas QA cuando los testers posean un pase — véase la guía de automatización.
Combínala con el resto del set de entrega
Deja Definition of Done en la misma incidencia para el listón de envío. Adjunta la lista de verificación de pruebas QA cuando alguien necesite un pase de pruebas estructurado. Usa Definition of Ready en el refinement si la calidad de intake ayuda a tu equipo. Recorre el hub de plantillas para el conjunto completo.
Preguntas frecuentes
¿Quién es dueño de los acceptance criteria?
Producto suele redactarlos; engineering y QA los afilan. Una lista de verificación en la incidencia hace visible ese ida y vuelta en lugar de enterrarlo en comentarios.
¿Por qué engineering y QA prefieren los acceptance criteria en la incidencia?
Porque la lista de verificación es donde reciben y entienden los requisitos: ejemplos concretos contra los que construir y probar, visibles junto al trabajo en lugar de enterrados en una descripción o una presentación.
¿Los acceptance criteria pueden cambiar después de empezar el desarrollo?
A menudo lo hacen. Marca o actualiza elementos en el elemento de trabajo cuando cambie el alcance y vincula la discusión ahí para que la lista siga siendo la fuente de verdad.
¿Cómo sé si un criterio es suficientemente bueno?
Pregunta cómo lo demostrarías. Si nadie puede mostrar el comportamiento en un recorrido corto, la fila todavía necesita detalle.
Deje la checklist en el elemento de trabajo, no en la descripción
Checklist for Jira aporta plantillas, automatización, validadores de flujo y un agente Rovo. Gratis para equipos de hasta 10 usuarios.