Angle
Le dépôt de code a toujours fait foi sur ce que le produit fait ; c'est pourtant la spécification qui a fait autorité, parce qu'elle seule se lisait en réunion. Un artefact ne gouverne donc pas une chaîne produit par sa fiabilité, mais par la facilité qu'on a d'en tirer les autres — et cette facilité est une affaire d'accès, jamais de nature. Quand lire un dépôt, croiser ses merge requests et en régénérer une documentation de support cesse d'exiger un développeur, la spécification perd ce qui la tenait en place : elle n'a jamais été plus vraie, elle était plus accessible. L'autorité passe alors au code, avec ses deux conditions — un dépôt lisible et quelqu'un qui sache l'interroger — et avec son trou : il dit ce que le produit fait, jamais pourquoi il le fait ainsi.
Synthèse
Prises séparément, ces idées ressemblent à un retour d'expérience sur des documents produit mal tenus. Mises bout à bout, elles décrivent comment se distribue l'autorité entre les artefacts d'un produit, et ce qui la déplace.
Le point de départ est un décalage entre deux propriétés qu'on confond. Le code détient l'état réel : un comportement présent dans le dépôt existe, un comportement écrit dans une spécification et absent du dépôt n'existe pour personne. Mais détenir l'état réel n'a jamais suffi à gouverner la chaîne, parce que ceux qui produisent les documents — Product Managers, support, commerciaux — ne lisent pas le dépôt. La couche en langage naturel a occupé la place laissée vacante, non pour sa qualité d'information, mais pour sa qualité d'accès.
Cette couche, une fois installée, s'est mise à diverger, et la divergence n'est pas un relâchement. Deux mécanismes s'y ajoutent : les arbitrages rendus pendant le développement ne remontent pas systématiquement, et resynchroniser spécification, maquette, changelog et documentation de support coûte, à chaque évolution, plus que le temps disponible. La documentation périmée est le résultat cumulé d'arbitrages tous raisonnables pris un par un.
Ce qui change n'est pas la fiabilité du code, elle était déjà là. C'est le prix de son accès. Dès qu'un dépôt s'interroge sans savoir écrire, la spécification, le changelog, la documentation de support et jusqu'au design system peuvent être régénérés depuis lui plutôt que corrigés à partir d'eux-mêmes — et un artefact régénéré ne se périme pas, il est refait ou il ne l'est pas. Le renversement va jusqu'à l'étape qu'on croyait la plus éloignée du code : une maquette composée d'éléments qui existent réellement cesse d'être une représentation.
Ce déplacement a un prix, et il se paie en compétence. Il suppose un dépôt lisible, ce qui fait de la qualité du code une variable produit et non un confort d'équipe. Il suppose aussi quelqu'un capable de croiser code, historique, merge requests et règles métier — ce qu'aucun outil vertical ne fait, parce que chacun ne voit qu'une face. Et il ouvre un piège : produire vite des briques justes prises une par une et payer ensuite leur articulation.
Ce que l'ensemble donne à voir : le rang d'un artefact suit le coût d'accès à ce qu'il contient, et la hiérarchie tenue pour naturelle dans une chaîne produit n'était que la carte des lecteurs disponibles.
Tensions / contradictions
La tension principale oppose deux notes de ce lot. L'une fonde la position du Product Manager sur le fait qu'aucun outil vertical ne voit plusieurs faces du produit à la fois ; l'autre annonce un protocole qui donne précisément à chaque outil l'accès aux périmètres voisins. Si le second mouvement aboutit, l'avantage du premier s'efface — et rien ici ne permet de dire à quelle échéance.
Seconde tension, avec une idée écrite ailleurs : l'IA a été présentée comme ce qui rend enfin rentable une couche de connaissance neutre entre les sources et les livrables. Ici, elle sert plutôt à se passer d'une couche intermédiaire en régénérant depuis la source. Les deux peuvent tenir — la couche qu'on garde porte l'intention, celle qu'on jette portait l'état — mais le critère qui départage les deux cas n'est pas établi.
Enfin, l'angle suppose que l'accessibilité explique le rang. On peut objecter qu'une spécification faisait autorité aussi parce qu'elle était signée : elle engageait quelqu'un, ce qu'un artefact régénéré ne fait pas.
Questions
- Où consigner l'intention d'une décision produit, que ni le dépôt ni une spécification régénérée ne portent ?
- Qu'est-ce qui remplace l'engagement porté par un document validé, quand l'artefact est régénéré à la demande ?
- La démonstration tient sur un produit logiciel : que devient-elle dans une chaîne produit dont l'objet réel n'est pas lisible comme un dépôt ?