Docs · La doctrine · Section 02
Le découplage qui rend langage et topologie secondaires
Avant de parler langage et déploiement, il faut comprendre pourquoi ces choix deviennent secondaires. Deux frontières y suffisent : les ports du domaine, et un protocole d'intégration standardisé entre processus.
Frontière 1, les ports du domaine
Le domaine exprime ses besoins comme des contrats (ports) : fournir une génération de modèle, persister un état, exécuter une action, lire une source. Chaque contrat est implémenté par un adaptateur. L'adaptateur peut être écrit dans n'importe quel langage tant qu'il honore le contrat. Le langage devient un détail d'implémentation d'adaptateur. Ce découplage porte un nom, l'architecture hexagonale, ou « ports et adaptateurs », formalisée par Alistair Cockburn en 2005. L'appliquer au modèle lui-même, traité comme un adaptateur parmi d'autres, est une idée que l'écosystème partage de plus en plus ; ce qui suit n'en revendique pas la paternité, mais la pousse jusqu'à ses conséquences, de l'évaluation à la mémoire, de la sécurité à la gouvernance de contrats.
Cette dernière idée mérite d'être poussée jusqu'au bout, car elle fonde la durabilité de tout l'édifice. Le moteur placé derrière le port modèle n'est lié que par son contrat, pas par sa nature. C'est aujourd'hui un modèle de langage ; ce pourrait être demain un moteur de raisonnement d'un autre type, et l'architecture y survivrait sans réécriture, du moment qu'il honore le même contrat. Ce qui resterait alors à traiter n'est pas la frontière mais les propriétés du moteur : tant qu'il raisonne de façon non déterministe sur des entrées ouvertes, les exigences d'évaluation, de mémoire et de sécurité décrites plus loin tiennent à l'identique. Autrement dit, le modèle n'est pas le centre que l'architecture organise, c'est un composant qu'elle peut remplacer, jusqu'à son paradigme. Soyons justes, toutefois, sur le bénéfice quotidien de cette frontière : il tient moins au remplacement effectif du modèle, plus rare qu'on ne le dit, qu'à la capacité de tester et de raisonner sur le domaine sans dépendre du modèle. La substituabilité est l'assurance que l'on garde en réserve ; la testabilité est le dividende de tous les jours. Et une précision qui vaut pour tout le reste : le port est propre pour le contrat typé, mais la frontière comportementale, elle, ne se garantit pas par le type, elle se valide (section 12).
Frontière 2, le protocole d'intégration entre processus
Quand une capacité vit dans un autre processus, voire un autre langage, elle est exposée via un protocole d'outils standardisé. Le système consomme ce processus comme un fournisseur d'outils, et expose lui-même ses cas d'usage de la même manière. La frontière inter-langage est nette et stable.
Schéma, le langage et la topologie derrière les contrats
Conséquence pratique
Le débat full TypeScript contre back Python, Rust ou Go cesse d'être un dilemme d'architecture. C'est un arbitrage local, pris adaptateur par adaptateur, selon l'écosystème de la capacité concernée. Le même raisonnement vaut pour le découpage en services : un service est un adaptateur qui a migré dans son propre processus, sans que le domaine change.
Le contrat, au-delà du type
Un contrat ne se réduit pas à un schéma typé : il se gouverne, il porte du sens, et il doit composer avec l'existant. Trois facettes d'une même exigence.
Il se gouverne. Un contrat stable n'est pas un contrat figé. Tout contrat, port du domaine, message échangé ou schéma de persistance, évolue ; sans discipline, il dérive et casse ses consommateurs en silence, le mal classique des architectures orientées services. Quatre règles le gouvernent. Il porte une version. Son évolution est additive par défaut, et le consommateur est un lecteur tolérant : il ignore ce qu'il ne connaît pas et accepte l'absence d'un champ optionnel, ce qui rend l'ajout non cassant. Un changement réellement cassant ne se fait pas d'un bloc, mais en deux temps, étendre puis contracter : on introduit le nouveau, on migre les consommateurs, on retire l'ancien une fois que plus personne ne l'utilise. Enfin, la provenance, qui enregistrait déjà ce qu'un prompt a vu et ce que la mémoire a fourni, s'étend aux contrats et aux événements : savoir qui produit, qui consomme et sous quelle version permet de mesurer l'impact d'un changement avant de le faire. La vérification, elle, appartient au consommateur (section 12) : il exprime ses attentes sous forme de contrat exécutable, et un changement du producteur qui les briserait échoue à l'intégration, avant d'atteindre la production.
Les messages et les événements qui franchissent une frontière portent une enveloppe stable, séparée de leur charge utile : une identité, un type qualifié, une référence de schéma, un horodatage, une origine. Cette taxonomie est ce qui permet à un consommateur de router, filtrer et tracer sans connaître le détail du producteur.
Il porte du sens. Un contrat honoré dans sa forme peut encore désigner des choses différentes. « Client », « compte », « engagement », « validation » n'ont pas le même sens d'un système à l'autre, ni d'un agent à l'autre. L'interopérabilité difficile n'est pas « comment s'appeler » mais « parle-t-on de la même chose ». La réponse n'est pas un modèle de données central qui dirait tout pour tout le monde : un tel modèle devient vite ingérable, lent à faire évoluer, et finit contourné. C'est, par contexte, un langage commun explicite, celui que partagent le métier et le code, des frontières nettes entre contextes, et un vocabulaire minimal partagé aux seules jointures. L'adaptateur y joue son second rôle : au-delà de traduire un protocole, il aligne le sens, exactement comme la couche anticorruption traduit le dialecte d'un système hérité. Cet alignement compte doublement pour un système agentique : faute de sémantique fixée, un modèle rapprochera de force des concepts voisins mais distincts et inventera des correspondances fausses. Le contrat sémantique est, contre ces alignements hallucinés, ce que le schéma typé est contre la donnée malformée.
Il compose avec l'existant. Sur du neuf, le port est une frontière nette et l'adaptateur est mince. Sur un système existant, la frontière n'est pas donnée : ses contrats sont implicites, sa sémantique non documentée. L'adaptateur devient alors une couche anticorruption qui traduit le dialecte du système hérité dans le langage du domaine et empêche le modèle ancien de contaminer le neuf. La bascule d'un existant se fait par remplacement progressif, fonctionnalité par fonctionnalité, jamais d'un seul geste. Il faut le dire sans détour : le modèle ports et adaptateurs tient le mieux en terrain neuf ; sur le patrimoine il tient toujours, mais l'adaptateur paie une traduction explicite, et c'est là que se concentre le coût réel d'intégration. L'isolation est précisément ce qui rend cette intégration propre, à condition de ne jamais prétendre que la frontière est gratuite.