Acuerdos operativos en Jira para colaborar sin perder calidad
En equipos ágiles, la calidad se sostiene cuando el trabajo es visible, las decisiones quedan registradas y los cambios se gestionan con disciplina. Jira permite estandarizar esa colaboración mediante acuerdos operativos: cómo comentar, cómo pedir información, cómo usar menciones y cómo mover estados sin generar “trabajo oculto”.
Comentarios efectivos: qué escribir y cómo estructurarlo
Un comentario útil reduce idas y vueltas y deja evidencia de decisiones. Acordad un formato breve y repetible para que cualquiera entienda contexto, acción y resultado.
- Contexto: qué se está revisando (historia, criterio, caso, bug, build).
- Acción solicitada: qué necesitas del otro (confirmar, ajustar, responder, validar).
- Resultado/decisión: qué se acordó o qué se observó (con datos).
- Próximo paso: quién hace qué y para cuándo.
Ejemplo de comentario en un bug:
Contexto: BUG-214 en build 1.8.3 (staging) con datos del cliente ACME. Acción: @dev confirmar si el fix incluye validación server-side. Resultado: el campo “NIF” permite letras; esperado solo dígitos. Próximo paso: si el fix es parcial, crear subtarea para validación backend y avisar para re-test.Menciones y solicitudes de información (RFI) sin bloquear el flujo
Las menciones (@) deben usarse para asignar una acción concreta, no para “informar por informar”. Para solicitudes de información (RFI), acordad un patrón que permita rastrear la pregunta y su respuesta sin perderla en el chat.
- Cuándo mencionar: cuando hay una acción requerida o una decisión pendiente.
- Qué incluir: pregunta cerrada, impacto, y fecha objetivo.
- Dónde hacerlo: en el issue que representa el trabajo afectado (historia, bug o tarea de pruebas).
Ejemplo de RFI en una historia:
- Escuche el audio con la pantalla apagada.
- Obtenga un certificado al finalizar.
- ¡Más de 5000 cursos para que explores!
Descargar la aplicación
RFI: @po ¿El criterio “envío de email” aplica también a reintentos automáticos? Impacto: cambia casos de prueba y regresión de notificaciones. Necesito confirmación hoy 16:00 para cerrar diseño de pruebas.Uso correcto de estados para evitar trabajo oculto
Un estado en Jira no es “cómo me siento”, sino una señal operativa. Si el equipo mueve issues sin reglas, aparecen zonas grises: trabajo iniciado pero no visible, pruebas hechas sin evidencia, o bugs “resueltos” sin revalidación.
Definid reglas simples de transición (Definition of Ready/Done operativa) para historias, casos y bugs. Ejemplos de acuerdos:
- No pasar a “En pruebas” si no hay entorno/build indicado y criterios de aceptación actualizados.
- No pasar a “Listo” si no hay evidencia mínima adjunta y checklist de cierre completada.
- No pasar un bug a “Resuelto” si no se indica causa, fix version/build y pasos de verificación sugeridos.
Ejemplo de “regla de transición” documentada en el equipo:
| Issue | Transición | Condición mínima |
|---|---|---|
| Historia | En desarrollo → En pruebas | Build/entorno + criterios confirmados + notas de implementación |
| Bug | En progreso → Resuelto | Fix version + evidencia técnica breve + riesgo de regresión indicado |
| Bug | Resuelto → Cerrado | Evidencia de re-test + (si aplica) regresión ejecutada |
Control de cambios de requisito y su impacto en pruebas
Cuando cambia un requisito, el riesgo no es solo “hacer algo distinto”, sino dejar inconsistencias: criterios desactualizados, casos que ya no aplican, y regresiones incompletas. El objetivo es absorber el cambio manteniendo coherencia entre lo que se pide, lo que se prueba y lo que se libera, sin perder trazabilidad operativa dentro de Jira.
Tipos de cambio y cómo tratarlos en Jira
- Aclaración: no cambia comportamiento, solo precisión. Impacto: ajustar texto de criterios y/o pasos de casos.
- Cambio funcional: cambia reglas, flujos o validaciones. Impacto: actualizar criterios, casos, datos de prueba y plan de regresión.
- Cambio de alcance: agrega/quita funcionalidades. Impacto: crear/eliminar casos, revisar cobertura y dependencias.
- Cambio técnico con impacto en QA: refactor, librería, feature flag. Impacto: revalidación focalizada y regresión por riesgo.
Guía práctica paso a paso: gestionar un cambio sin perder control
Este flujo se puede ejecutar con issues estándar (Historia/Tarea/Bug) y subtareas, sin necesidad de repetir configuraciones avanzadas.
Registrar el cambio como evento visible: añade un comentario en la historia (o crea una subtarea “Cambio de requisito”) indicando qué cambió, desde cuándo aplica y quién lo aprobó.
Cambio aprobado (PO): el límite de transferencia pasa de 5.000 a 10.000. Aplica desde release 2.3. Impacto: validaciones, mensajes de error y casos de límites.Actualizar criterios de aceptación: edita los criterios para reflejar el nuevo comportamiento. Si el equipo usa formato Given/When/Then, actualiza el escenario afectado y marca el cambio con una nota breve.
Identificar impacto en pruebas: crea una lista de “áreas afectadas” en un comentario o subtarea (por ejemplo: límites, UI, API, notificaciones). Esto guía la regresión por riesgo.
Actualizar casos de prueba: ajusta pasos, datos y resultados esperados. Si el cambio invalida un caso, no lo borres sin más: márcalo como obsoleto (según convención del equipo) y crea el nuevo caso, dejando nota del motivo.
Definir regresión mínima: añade una subtarea “Regresión por cambio” con el set mínimo de pruebas a ejecutar (por riesgo), incluyendo dependencias.
Replanificar y comunicar: menciona a desarrollo y PO si el cambio altera esfuerzo o fecha. La comunicación queda en el issue, no solo en chat.
Ejecutar y adjuntar evidencia: al terminar, adjunta evidencia mínima (ver sección de evidencias) y registra el build/entorno.
Actualización de criterios, casos y regresión: ejemplo práctico
Escenario: una historia de “Transferencias” cambia el límite máximo.
- Criterio actualizado: “Dado un usuario validado, cuando ingresa un monto mayor a 10.000, entonces el sistema bloquea la operación y muestra el mensaje X”.
- Casos a actualizar: límite exacto (10.000), límite +1 (10.001), valores inválidos (texto), y formato/localización si aplica.
- Regresión por riesgo: validación de backend, cálculo de comisiones (si depende del monto), logs/auditoría, y notificaciones.
Revisiones cruzadas (peer review) de casos y de bugs
Las revisiones cruzadas reducen defectos de diseño de prueba y mejoran la calidad de los reportes de bugs. El objetivo no es “controlar”, sino detectar ambigüedades, duplicados, huecos de cobertura y riesgos de regresión antes de que cuesten más.
Peer review de casos de prueba: checklist rápido
- ¿El caso prueba un criterio específico y es reproducible?
- ¿Incluye datos de prueba claros (y límites relevantes)?
- ¿El resultado esperado es verificable (no subjetivo)?
- ¿Cubre negativos y bordes donde el riesgo lo justifica?
- ¿Indica precondiciones (roles, flags, configuración)?
Práctica recomendada: crear una subtarea “Revisión de casos” asignada a otro QA, con un comentario estándar para aprobar o pedir cambios.
Revisión casos: OK / Cambios requeridos. Observaciones: falta caso negativo para monto = 0; especificar rol requerido; ajustar expected message literal.Peer review de bugs: calidad del reporte y velocidad de resolución
Un bug bien reportado acelera el fix y reduce re-trabajo. Acordad que todo bug pase por una revisión rápida (otro QA o un dev) antes de escalarlo como bloqueante, especialmente si afecta release.
- Reproducibilidad: pasos numerados, datos, entorno, build.
- Esperado vs actual: explícito y medible.
- Severidad/prioridad: justificadas por impacto real.
- Evidencia: captura/video/log cuando aporte valor.
- Alcance: ¿es nuevo? ¿regresión? ¿intermitente?
Mecanismos para evitar regresiones: checklist de cierre, evidencias mínimas y revalidación coordinada
Checklist de cierre (para historias y bugs)
El checklist de cierre evita “terminado” sin validación suficiente. Puede implementarse como lista en la descripción, plantilla de comentario o subtarea obligatoria.
- Build/entorno probado indicado (ej. staging 1.8.3).
- Criterios verificados (referenciar cuáles).
- Casos ejecutados (IDs o lista breve) y resultado.
- Regresión por riesgo ejecutada o justificada si no aplica.
- Evidencia mínima adjunta (ver abajo).
- Dependencias revisadas (integraciones, permisos, flags).
Evidencias mínimas: qué adjuntar y cuándo
No todo requiere video largo. Definid evidencia mínima por tipo de trabajo para equilibrar velocidad y auditabilidad.
| Tipo | Evidencia mínima recomendada | Cuándo es obligatoria |
|---|---|---|
| Historia (UI) | 2–3 capturas: estado inicial, acción clave, resultado | Cuando hay cambios visibles o validaciones críticas |
| Historia (API) | Request/response (captura o texto) + código de estado | Cuando el criterio depende de reglas backend |
| Bug | Captura/video corto + pasos + build | Siempre que sea reproducible |
| Intermitente | Logs/telemetría + frecuencia + condiciones | Cuando no se puede reproducir a demanda |
Reglas de revalidación coordinadas con desarrollo
Para evitar regresiones, acordad reglas claras de re-test y revalidación que conecten QA y desarrollo en el mismo flujo de Jira.
- Regla 1: “Resuelto” no significa “Cerrado”. Un bug pasa a “Cerrado” solo tras re-test en el build indicado.
- Regla 2: re-test con contexto. El dev debe indicar en el bug: fix version/build, qué cambió y qué áreas podrían romperse.
- Regla 3: regresión por riesgo. Si el fix toca componentes compartidos (validadores, auth, pagos), se ejecuta un set mínimo acordado.
- Regla 4: reabrir con evidencia. Si falla el re-test, reabrir con evidencia nueva y aclarar si es el mismo síntoma o uno distinto.
Plantilla breve para que desarrollo deje lista la revalidación:
Fix listo en build 1.8.4. Cambios: validación server-side para NIF + sanitización en UI. Riesgo: formularios que reutilizan el componente de input. Sugerencia de re-test: casos NIF válido/ inválido + smoke de formulario “Alta cliente”.Cómo evitar trabajo oculto durante la revalidación
- Si QA está esperando build o datos, mover el issue a un estado explícito de espera (según el flujo del equipo) y comentar qué falta y quién lo provee.
- Si el cambio implica actualizar pruebas, crear subtareas visibles (“Actualizar casos”, “Regresión por cambio”) en lugar de hacerlo “por detrás”.
- Si hay desacuerdo sobre el requisito, registrar la decisión del PO en el issue antes de seguir probando.