Escrito originalmente en francés. Traducido por IA — se ha preservado el sentido, no la prosa.
Ángulo
El repositorio de código siempre ha dado fe de lo que el producto hace; y, sin embargo, ha sido la especificación la que ha hecho autoridad, porque solo ella se leía en reunión. Un artefacto no gobierna, pues, una cadena de producto por su fiabilidad, sino por la facilidad con que se extraen de él los demás — y esa facilidad es cuestión de acceso, nunca de naturaleza. Cuando leer un repositorio, cruzar sus merge requests y regenerar a partir de ahí una documentación de soporte deja de exigir un desarrollador, la especificación pierde lo que la sostenía en su sitio: nunca fue más verdadera, era más accesible. La autoridad pasa entonces al código, con sus dos condiciones —un repositorio legible y alguien que sepa interrogarlo— y con su agujero: dice lo que el producto hace, nunca por qué lo hace así.
Síntesis
Por separado, estas ideas parecen un retorno de experiencia sobre documentos de producto mal llevados. Puestas una tras otra, describen cómo se distribuye la autoridad entre los artefactos de un producto, y qué la desplaza.
El punto de partida es un desfase entre dos propiedades que se confunden. El código posee el estado real: un comportamiento presente en el repositorio existe, un comportamiento escrito en una especificación y ausente del repositorio no existe para nadie. Pero poseer el estado real nunca ha bastado para gobernar la cadena, porque quienes producen los documentos —Product Managers, soporte, comerciales— no leen el repositorio. La capa en lenguaje natural ocupó el sitio que quedaba vacante, no por su calidad de información, sino por su calidad de acceso.
Esa capa, una vez instalada, empezó a divergir, y la divergencia no es una relajación. Se le suman dos mecanismos: los arbitrajes emitidos durante el desarrollo no vuelven sistemáticamente, y resincronizar especificación, maqueta, changelog y documentación de soporte cuesta, en cada evolución, más que el tiempo disponible. La documentación caducada es el resultado acumulado de arbitrajes todos razonables tomados uno a uno.
Lo que cambia no es la fiabilidad del código, que ya estaba ahí. Es el precio de su acceso. En cuanto un repositorio se interroga sin saber escribir, la especificación, el changelog, la documentación de soporte y hasta el design system pueden regenerarse desde él en lugar de corregirse a partir de sí mismos — y un artefacto regenerado no caduca: se rehace o no se rehace. El vuelco alcanza incluso a la etapa que se creía más alejada del código: una maqueta compuesta de elementos que existen realmente deja de ser una representación.
Ese desplazamiento tiene un precio, y se paga en competencia. Supone un repositorio legible, lo que convierte la calidad del código en una variable de producto y no en una comodidad de equipo. Supone también alguien capaz de cruzar código, historial, merge requests y reglas de negocio — algo que ninguna herramienta vertical hace, porque cada una solo ve una cara. Y abre una trampa: producir deprisa bloques correctos tomados uno a uno y pagar después su articulación.
Lo que el conjunto deja ver: el rango de un artefacto sigue el coste de acceso a lo que contiene, y la jerarquía tenida por natural en una cadena de producto no era más que el mapa de los lectores disponibles.
Tensiones / contradicciones
La tensión principal opone dos notas de este lote. Una funda la posición del Product Manager en el hecho de que ninguna herramienta vertical ve varias caras del producto a la vez; la otra anuncia un protocolo que da precisamente a cada herramienta el acceso a los perímetros vecinos. Si el segundo movimiento prospera, la ventaja del primero se borra — y nada aquí permite decir en qué plazo.
Segunda tensión, con una idea escrita en otro lugar: la IA se presentó como aquello que vuelve por fin rentable una capa de conocimiento neutra entre las fuentes y los entregables. Aquí sirve más bien para prescindir de una capa intermedia regenerando desde la fuente. Ambas pueden sostenerse —la capa que se conserva lleva la intención, la que se tira llevaba el estado—, pero el criterio que separa los dos casos no está establecido.
Por último, el ángulo supone que la accesibilidad explica el rango. Cabe objetar que una especificación hacía autoridad también porque estaba firmada: comprometía a alguien, cosa que un artefacto regenerado no hace.
Preguntas
- ¿Dónde consignar la intención de una decisión de producto, que ni el repositorio ni una especificación regenerada llevan?
- ¿Qué sustituye al compromiso que llevaba un documento validado, cuando el artefacto se regenera bajo demanda?
- La demostración se sostiene sobre un producto de software: ¿qué ocurre con ella en una cadena de producto cuyo objeto real no es legible como un repositorio?