Escribir lo que hay que construir sin escribir cómo
Una historia de usuario no es un ticket con formato bonito: es un recordatorio de una conversación pendiente. Lo que la hace útil no es la plantilla «como usuario quiero», son los criterios de aceptación.
«Como usuario quiero poder exportar los datos para poder analizarlos.» Está bien escrita según la plantilla, y no alcanza para construir nada: ¿qué datos, en qué formato, con qué filtros, qué pasa con diez mil filas, quién puede exportar?
La plantilla es lo menos importante. Una historia sirve cuando alguien puede construirla sin volver a preguntar, y cuando hay una forma objetiva de decir si está terminada. Eso último son los criterios de aceptación, que es la parte que casi siempre falta.
Los criterios de aceptación
Son la lista de condiciones que tienen que cumplirse para que la historia esté terminada. Se escriben antes de construir, no después, y sirven para tres cosas a la vez: acordar el alcance, guiar los tests y evitar la discusión de si estaba incluido o no.
| Historia sin criterios | Con criterios |
|---|---|
| Exportar los datos a Excel | Se exporta la tabla visible con los filtros aplicados · Incluye encabezados · Hasta 10.000 filas; más que eso avisa y ofrece filtrar · Sólo pueden exportar los usuarios con rol de analista · El archivo se llama con la fecha del día |
| Recuperar la contraseña | Con un mail registrado llega un enlace que vence en una hora · Con uno no registrado se muestra el mismo mensaje, para no revelar quién está registrado · El enlace sirve una sola vez · Al cambiarla se cierran las otras sesiones |
La plantilla
Plantilla
Historia de usuario
Título
Una frase con el resultado desde el punto de vista de quien lo usa. Por ejemplo: exportar el listado filtrado a una planilla.
Si el título nombra una solución técnica —«agregar endpoint de exportación»— probablemente sea una tarea, no una historia.
Quién, qué y para qué
Quién lo necesita, qué quiere hacer y con qué fin. El «para qué» es el que más se saltea y el que permite proponer alternativas mejores.
Cuando el para qué está claro, el equipo puede sugerir formas más baratas de lograr lo mismo.
Criterios de aceptación
La lista de condiciones verificables. Incluí al menos un caso borde y un caso de error.
Es la parte que convierte la historia en algo construible. Si no se pueden escribir, falta conversación.
Qué queda afuera
Lo que alguien podría suponer incluido y no lo está.
Evita la discusión más frecuente al entregar: «yo pensé que también hacía…».
Notas y dependencias
Datos de contexto, diseños, si depende de otro equipo o de un dato que todavía no existe.
Las dependencias escritas antes son planificación; descubiertas después, son un atraso.
El tamaño y por qué importa
Una historia que lleva tres semanas no es una historia grande: es varias historias sin separar. Y ya sabemos qué le pasa al trabajo que tarda: engorda la cola y demora todo lo demás.
| Forma de cortar | Ejemplo | Cuándo usarla |
|---|---|---|
| Por caso de uso | Primero exportar la tabla completa; después con filtros | Casi siempre: entrega valor desde la primera |
| Por tipo de dato | Primero clientes; después facturas | Cuando cada tipo tiene reglas distintas |
| Por regla de negocio | Primero el caso general; después las excepciones | Cuando las excepciones son pocas y raras |
| Por camino feliz y errores | Primero que funcione; después los errores y avisos | Sólo si se puede usar de verdad mientras tanto |
| Por capa técnica | Primero el backend; después el frontend | Casi nunca: ninguna de las dos entrega nada sola |
Antes de seguir, predecí
La definición de terminado
Los criterios de aceptación son de cada historia. La definición de terminado es del equipo y vale para todas: es lo que evita que «listo» signifique cosas distintas para cada persona.
Una definición de terminado típica
- El código está revisado y fusionado.
- Los criterios de aceptación se verificaron, no sólo el camino feliz.
- Hay tests de la lógica central y pasan.
- Está desplegado en el entorno que corresponda.
- Funciona ahí, verificado por quien lo hizo.
- Quien lo pidió lo sabe.
Lo que preguntan sobre esto
Cierre
Autoevaluación
¿Lo entendiste?
Práctica