Idée principale

Un cadre posé autour d'une production logicielle est spontanément lu comme une contrainte : des règles, des limites, des choses qu'on n'a pas le droit de faire. Sur un assistant, cette lecture est fausse dans la plupart des cas.

Laissé seul devant une base de code qu'il ne connaît pas, un assistant cherche. Il prend une API interne qui n'est pas la bonne, entre par un point d'entrée déprécié, reconstruit un composant qui existait déjà, contourne l'architecture existante parce qu'il ne l'a pas vue. Ces détours consomment du temps, produisent du code à jeter et fabriquent de l'incohérence — pas parce que l'assistant est mauvais, mais parce que l'information qui lui aurait évité le détour n'était disponible nulle part.

Un catalogue d'API internes utilisables, une documentation fonctionnelle générée depuis le code, une correspondance entre concepts métier et points d'entrée techniques, des exemples de requêtes, des composants d'interface réutilisables, des conventions, des fichiers d'instructions et des skills : chacun de ces objets supprime une recherche. Le cadre ne réduit pas l'espace des solutions, il supprime le coût d'y entrer.

Pourquoi c'est important

Cela renverse l'argument économique avec lequel on discute d'un investissement de plateforme. Tant que les rails sont présentés comme une protection, ils se négocient contre du délai et perdent. Présentés comme la condition de vitesse de tout ce qui sera produit ensuite, ils changent de catégorie de dépense.

Cela dit aussi ce qui distingue une base de code accueillante d'une base de code fermée pour un assistant : non pas sa beauté, mais la quantité d'informations qu'elle rend disponibles sans qu'il faille les deviner.

Nuances et limites

L'effet suppose que le cadre soit à jour. Un catalogue d'API périmé est pire que pas de catalogue : il oriente avec assurance vers le mauvais chemin, et rien dans la sortie ne signale l'erreur.

Et le cadre a un coût de fabrication et d'entretien, qui ne se rentabilise que sur une production répétée. Il ne se justifie pas pour un objet unique.

Questions ouvertes

• Parmi ces rails, lesquels doivent être écrits pour des humains et lesquels pour un assistant, quand un même fichier ne peut pas servir correctement les deux lectures ?