Alineación entre demo y especificación
La alineación entre la demo y la especificación es la práctica de mantener el comportamiento del prototipo o de la demo coherente con la intención de producto documentada, al mismo tiempo que se actualiza explícitamente la especificación cuando una demo revela un mejor flujo de trabajo.
Por qué es importante
Las demos son útiles porque hacen concretos los flujos de trabajo. Son arriesgadas porque el comportamiento visible suele empezar a tratarse como verdad de producto aprobada incluso cuando la documentación subyacente nunca se actualizó.
Orden recomendado de autoridad
- especificación del producto
- directrices de implementación
- documentación del estado actual
- demo o comportamiento de la implementación
- validación y pruebas
Este orden no significa que las demos no importen. Significa que deben interpretarse dentro de un marco de decisión documentado.
Uso saludable de las demos
Usa las demos para:
- exponer problemas en los flujos de trabajo
- revelar problemas de usabilidad
- probar supuestos con usuarios
- apoyar explicaciones para las partes interesadas
No uses las demos como reemplazos silenciosos de las decisiones de producto.
Cuándo la demo debe liderar
Si la demo revela un flujo de trabajo claramente mejor, el equipo debería:
- revisar el cambio de forma intencional
- actualizar la especificación y la documentación pertinente
- ajustar las expectativas de validación o revisión
En otras palabras, la demo puede inspirar la siguiente decisión, pero la decisión actualizada debe seguir documentándose.
Contexto de Let Books
El repositorio de Let Books ya distingue entre evidencia documental canónica y estado de implementación para la escritura pública. Esa es una protección útil porque evita que los prototipos se conviertan por accidente en una autoridad editorial.