Redacta criterios de aceptación claros con dictado por voz

«Permitir guardar un borrador» parece sencillo hasta que alguien pregunta qué ocurre si el título está vacío o si guardar también publica el artículo. Quizá puedas explicar el comportamiento de viva voz, pero la descripción de la tarea sigue sin escribir.

El dictado por voz permite empezar por esa explicación. Describe un escenario y edita el texto para obtener criterios de aceptación: los resultados observables necesarios para aceptar el trabajo. Puedes consultar el concepto en la guía de criterios de aceptación de Atlassian, en inglés. A continuación tienes un método práctico para pasar de la explicación oral a un documento que el equipo pueda revisar.

1. Abre la tarea antes de hablar

En tu Mac, coloca la descripción de la tarea junto al diseño o las notas ya acordadas. Elige un comportamiento pequeño, no toda la funcionalidad. Si vas a describir el guardado manual de borradores, deja la programación, la publicación y el guardado automático para otras conversaciones, salvo que ya formen parte del alcance.

Escribe primero el objetivo en una frase: «Una persona del equipo editorial puede guardar trabajo sin terminar y retomarlo después». Así mantendrás la explicación centrada en quien utiliza la función.

2. Dicta el recorrido con cinco preguntas

Imagina que estás enseñando el funcionamiento a un compañero. Haz una breve pausa entre los puntos.

• Quién: ¿qué persona o rol utiliza la función?
• Situación inicial: ¿qué condiciones se cumplen antes de actuar?
• Acción: ¿qué hace esa persona?
• Resultado: ¿qué puede observar después?
• Excepción: ¿qué debe ocurrir en un caso de fallo relevante?

Antes de un punto que el equipo no haya decidido, di «pregunta pendiente». Durante la edición podrás mover esos fragmentos a otra sección, sin convertir una posibilidad en un requisito por accidente.

3. Convierte el dictado en afirmaciones verificables

Este ejemplo es ficticio y no describe una función de TypeFree:

La persona que edita tiene abierto un artículo sin publicar, con título y texto. Guarda el borrador y ve una confirmación. Al abrirlo de nuevo, siguen ahí el título y el texto. El artículo no debe quedar visible para el público. Si el título está vacío, hay que pedir que lo complete y no guardar. El guardado automático no está decidido.

Después de dictar, organiza el contenido como una propuesta para revisar:

1. Al guardar correctamente un artículo sin publicar y con el título cumplimentado, se muestra una confirmación a la persona que lo edita.
2. Al volver a abrir el borrador guardado, se recuperan el título y el cuerpo del texto de ese guardado.
3. Guardar el borrador no hace que el artículo sea visible para el público.
4. Intentar guardar con el título vacío muestra un mensaje que solicita un título y no guarda los cambios.

Deja «¿Debe incluirse el guardado automático?» en Preguntas pendientes, fuera de los criterios acordados. Estas reglas son propuestas para una función imaginaria; tu equipo debe elegir el comportamiento de su propio producto.

4. Revisa el significado antes de pulir el estilo

Comprueba especialmente palabras como «no», «solo», «vacío» y «sin publicar». Omitir una negación puede invertir el requisito. Copia los nombres exactos de los botones desde el diseño en vez de confiar únicamente en la transcripción.

Después, lee cada punto como lo haría quien va a comprobarlo: ¿qué debo hacer y qué resultado demostraría que se cumple? Si escribiste «guarda rápido», pregunta qué tiempo y condiciones de medición necesita realmente el equipo. No inventes un límite para que la frase parezca precisa.

Separa los resultados visibles de las ideas de implementación. Si al hablar te desviaste hacia el almacenamiento o los nombres internos, mueve esos detalles a unas notas técnicas para debatirlos.

5. Resuelve las dudas con el equipo

Comparte los criterios como un borrador y deja visibles las decisiones pendientes. Antes de considerar la lista como alcance acordado, pide a quienes desarrollarán y revisarán la función que comprueben los escenarios. El dictado recoge tu explicación; no sustituye el acuerdo del equipo ni demuestra que la función ya funciona.

Para otras tareas de escritura, consulta cómo redactar briefs de proyecto por voz y escribir informes de errores más claros.

TypeFree es una forma sencilla de convertir la voz en texto editable y escribir más rápido. Elige un escenario, explica el comportamiento esperado y revisa el texto antes de añadirlo a la tarea.