Docs · La doctrine · Section 13
Matrice de décision récapitulative
Tout ce qui précède tient dans un tableau de décision. Chaque ligne est un arbitrage, avec son défaut recommandé et le signal qui commande d'en changer.
Matrice des arbitrages
| Décision | Défaut recommandé | Évoluer quand |
|---|---|---|
| Langage du coeur | TypeScript (orchestration et interface) | Jamais sans raison ; le polyglotte passe par un sidecar ou un service. |
| Capacité spécialisée | Sidecar dans le langage de la bibliothèque | Dès qu'une bibliothèque mûre vit dans un autre écosystème. |
| Composant au chemin critique | Service compilé derrière un contrat | Latence ou débit prouvés insuffisants. |
| Découpage | Monolithe modulaire hexagonal | Charge, cycle, isolation ou haute disponibilité l'exigent. |
| Intégration au patrimoine | Couche anticorruption derrière le port | Remplacement progressif, fonctionnalité par fonctionnalité, jamais d'un bloc. |
| Nombre d'agents | Orchestrateur unique dirigeant des spécialistes | Complexité parallélisable, jamais pour du raisonnement séquentiel. |
| Abstraction du modèle | Port unique, trois niveaux, SDK direct | Jamais un gros framework de chaînes par défaut. |
| État | Agent sans état, journal immuable plus vue de travail dérivée | Multi-instance : externaliser les structures en mémoire. |
| Franchir la frontière du processus | Le plus tard possible, sur déclencheur objectif | Assumer alors cohérence éventuelle, compensation et ordre causal explicite. |
| Évolution de contrat | Versionné, additif, lu en lecteur tolérant | Changement cassant : étendre puis contracter, sous vérification dirigée par le consommateur. |
| Mémoire et oubli | Score de valeur, invalidation (pas suppression), consolidation avec pointeurs vers les faits sources | Suppression physique réservée aux dérivés invalidés sous rétention. |
| Évaluation | Tests, plus boucle d'évaluation continue et gardée | Auto-réglage borné seulement, gardé, sous override humain. |
| Budget et découverte multi-agent | Compteur agrégé central, registre en mémoire | Allocation par blocs et fiches de capacités partagées dès la sortie du processus. |
| Modèle indisponible | Bascule multi-fournisseur derrière le port | Disponible dès la mise en service réelle. |
| Changer de modèle (nouveau ou mis à jour) | Valider en déploiement fantôme, puis par paliers | Jamais d'un seul geste ; retour arrière à la moindre divergence. |
| Attente d'une approbation humaine | Suspendre et libérer (état durable), réhydrater à la décision | Jamais bloquer le processus ; demandes à faible urgence regroupées en file. |
| Service non critique | Fail-open, mode dégradé signalé | Action sensible : au contraire fail-closed explicite. |
| Autonomie de délégation | Bornée : gabarits, budgets, approbations | Élargir seulement si le résultat s'améliore réellement. |
| Entrées non fiables | Contenu récupéré non fiable, moindre privilège, approbation sur l'action | Fort privilège : patterns dédiés (plan figé, quarantaine du non-fiable). |
| Identité d'agent | Principal propre, distinct de l'utilisateur servi ; délégation explicite, bornée en temps et en périmètre | Jamais l'emprunt des pleins droits de l'utilisateur ; agent hors registre = anomalie de sécurité. |
| Secrets d'exécution | Substitut côté agent, clé réelle attachée à la frontière réseau, destinations autorisées | Jamais de clé dans le contexte du modèle ni dans l'environnement d'exécution. |
| Brique partagée (connecteurs, compétences, mémoire transverse, livraison) | Consommée via un port ; adaptateur = client de découverte via un index (section 15) | L'index reste un index ; la livraison livre, l'orchestrateur décide. |