Un documento útil no aparece al final para describir lo construido. Aparece antes, cuando todavía es barato descubrir que dos personas están imaginando productos diferentes.
La ambigüedad también es una decisión.
Cuando alcance, estados o responsabilidades permanecen implícitos, el desarrollo no queda libre para avanzar. Queda obligado a resolverlos tarde y dentro del código.
Un brief, un SOW o una especificación no necesitan predecirlo todo. Deben hacer visibles las condiciones que cambiarían el producto y nombrar quién puede decidir sobre ellas.
Lo que no puede explicarse de forma compartida todavía no está listo para convertirse en comportamiento.
Documentar crea continuidad.
Las personas cambian, las prioridades se mueven y el sistema aprende. Un registro de decisiones permite evolucionar sin reconstruir cada vez la intención original.
La documentación correcta no intenta reemplazar una conversación. Conserva su resultado y deja una puerta clara para revisarlo cuando cambie la realidad.
Para decidir
Documentar antes del código no ralentiza la construcción. Evita que la velocidad dependa de recordar conversaciones que nunca quedaron convertidas en decisiones.