Una lista de verificación de Definition of Done que se queda en el elemento de trabajo

¿Qué es una lista de verificación de Definition of Done?

Definition of Done es el listón de calidad que toda story debería superar antes de que alguien la mueva a Done. En Jira, una lista de verificación convierte ese listón en pasos marcables en el propio elemento de trabajo: peer review completo, CI en verde, docs actualizados. La lista es la misma para cada story; solo cambian las marcas.

Una lista de verificación de Definition of Done impone claridad y quita ambigüedad antes de mover el trabajo a Done. En lugar de preguntar “¿Ya está hecho?”, “¿Seguimos los mismos estándares que la última vez?” o “¿Cuál es nuestro listón de calidad para esta story?”, el equipo señala la lista en la incidencia. Todos ven los mismos pasos, marcan la misma evidencia y acuerdan qué significa “terminado”.

La brecha se ve en el lenguaje cotidiano. Un equipo dice que una story está done cuando desarrollo, pruebas y code review están completos — ¿eso incluye desplegado? Otro equipo entiende done solo después de que el cambio ha pasado todo el ciclo de entrega y está en producción. Una lista de verificación de Definition of Done obliga a esa conversación una vez, escribe la respuesta en la incidencia y evita que cada story reabra el mismo debate.

Por qué los equipos dejan Definition of Done en la incidencia

La mayoría de los equipos ya saben cómo se ve “lo bueno”. La fricción es repetirlo. Sin una lista compartida, “done” se convierte en debate en el stand-up, los comentarios de review viven en tres sitios y la siguiente persona hereda un traspaso incompleto. Una lista de verificación en la incidencia hace el listón explícito: todos ven los mismos pasos, el progreso es visible en el tablero y nada crítico se esconde en la cabeza de alguien.

En la entrega de software el beneficio aparece en cada story: abres el ticket, ves qué falta — review mergeado, tests en verde, docs actualizados —, marcas sobre la marcha y pasas a Done solo cuando la evidencia está en la incidencia. El mismo listón aplica tanto si envías una funcionalidad, corriges un bug o limpias deuda técnica.

Cuándo aplicarla

Usa una lista de verificación de Definition of Done en cada story, corrección de bug o task que deba dejar la misma calidad. Aplícala cuando el trabajo pasa a In Progress o cuando se crea la story, para que el listón esté desde el inicio. Exígela antes de la transición a Done cuando Done deba significar que el listón se cumplió.

Definition of Done vs. acceptance criteria vs. ready

Acceptance criteria describen el comportamiento prometido de este elemento de trabajo: los ejemplos que vas a demostrar. Definition of Ready pregunta si el elemento está lo bastante claro para entrar en el sprint. Definition of Done es el listón de salida compartido: tests, review, documentación y preparación de release que cada story debe a la siguiente persona. Los equipos que mantienen las tres como listas de verificación en la incidencia ven la diferencia en lugar de discutirla en el stand-up.

Definition of Done — un ejemplo para empezar

Si no tienes una lista de verificación de Definition of Done, empieza con el ejemplo de abajo. Copia la lista y pégala en el campo de Checklist for Jira en un elemento de trabajo. Lo ideal es guardarla como plantilla y aplicarla a cada story: reduce el trabajo manual cada vez que alguien arranca un ticket. Ajusta los encabezados a tu stack; deja la lista en el elemento de trabajo para que el progreso siga visible.

Guardar, proteger, automatizar, exigir

Convierte el ejemplo en un estándar que tu equipo ejecute en cada story, task y bug. Cuatro pasos en Checklist for Jira: guarda la plantilla, protege la estructura, aplícala automáticamente con la automatización integrada y exige la finalización antes de Done.

Guardar

Crea una plantilla de proyecto en Checklist settings de ese proyecto, o una plantilla global en la administración de Jira, y pega la lista del ejemplo. Ajusta los elementos a tu stack y añade una descripción breve para que el equipo — y el agente Rovo — sepan cuándo usarla. Una plantilla guardada es cómo reutilizas la misma Definition of Done en cada story sin volver a escribirla, y desbloquea el auto-apply y los validadores de workflow en los pasos siguientes.

Proteger

Marca la plantilla como Protected en la pestaña Advanced. La gente puede marcar elementos y cambiar estados de elemento en la incidencia, mientras la lista de pasos queda bloqueada: Definition of Done se mantiene igual en cada elemento de trabajo que toca la plantilla.

Automatizar

Usa la automatización integrada por plantilla para adjuntar esta Definition of Done cuando se crean tipos de incidencia seleccionados o cuando el trabajo pasa a un estado que eliges. Marca Story, Task y Bug (o los tipos que deban llevar el mismo listón) para que la lista esté en la incidencia antes de que alguien empiece a marcar. La buena noticia: estas automatizaciones están integradas en Checklist for Jira y se ejecutan sin créditos de Jira Automation.

Exigir

Añade un validador de finalización en la transición a Done de tu workflow de Jira. Limítalo a esta plantilla desde la lista de plantillas para que la transición espere hasta que todos los elementos estén completos: el elemento de trabajo permanece abierto hasta que la lista de verificación esté terminada. La guía de automatización recorre validadores, post functions y reglas entre proyectos más exigentes.

Combínala con el resto del set de entrega

Deja acceptance criteria en la misma incidencia para el ejemplo. Adjunta la lista de verificación de pruebas QA cuando el tipo de incidencia es Bug o cuando QA posee un pase dedicado. Usa la lista de verificación de release en el cambio que realmente se envía. Recorre el hub de plantillas para el conjunto completo.

Preguntas frecuentes