Orchestration et contexte¶
Page générée — ne pas éditer
Rendue au build par scripts/gen_doc_reference.py,
depuis web/data/catalogue-export.json.
Une modification manuelle serait perdue au build suivant.
Ces patterns structurent le passage d'une intention client vers des lots exécutables par des agents spécialisés, sans perte de contrôle ni saturation de contexte.
11 patterns dans cette famille.
ORC-01 — Orchestrateur et subagents spécialisés¶
Intention. Déléguer sans perdre le contrôle.
Problème. Un agent généraliste sature en contexte et oublie les contraintes.
Solution. L'orchestrateur découpe le travail et transmet des task envelopes à des subagents spécialisés.
Maturité. Orchestré
Contrôles. WIP limité, outils par rôle, handoff packet, revue croisée
À ne pas faire. Subagents autonomes qui explorent librement sans contrat de sortie.
Relations. Dépend de ORG-01 · Produit ORC-02 · À ne pas confondre avec ORC-05
ORC-02 — Task envelope¶
Intention. Donner à un agent exactement ce qu'il doit faire.
Problème. Les prompts longs et flous produisent dérive, coûts et faux Done.
Solution. Encapsuler mission, rôle, contexte minimal, outils, contraintes, critères et format de sortie.
Maturité. Minimal
Contrôles. Pre-delegation, budget de contexte, policy engine, modèle autorisé
À ne pas faire. Coller tout l'historique de conversation à chaque agent.
Relations. À ne pas confondre avec ORC-03 · Produit par ORC-03
ORC-03 — Handoff packet¶
Intention. Passer le relais sans recharger toute la mission.
Problème. Les étapes suivantes perdent les décisions ou héritent de bruit inutile.
Solution. Résumer résultat, preuves, hypothèses, risques, changements et prochain déclencheur.
Maturité. Minimal
Contrôles. Post-subagent, claim ledger, journal de preuves, transition d'étape
À ne pas faire. Rapport narratif long sans action suivante ni preuve.
Relations. Alimente QUA-01 · Alimentée par KNO-04
ORC-04 — Context router¶
Intention. Fournir un contexte utile, frais et proportionné.
Problème. Trop peu de contexte crée hallucination ; trop de contexte crée confusion.
Solution. Sélectionner sources par rôle, étape, risque, budget, fraîcheur et statut de connaissance.
Maturité. Orchestré
Contrôles. Pre-context-load, Post-context-load, Pre-context-reuse, source registry
À ne pas faire. RAG large sans filtres ni métadonnées.
Relations. À ne pas confondre avec ORC-05
ORC-05 — Orchestrateur de contexte avancé¶
Intention. Piloter le contexte comme un plan de contrôle au-dessus des mémoires, modèles, outils et transitions.
Problème. Des couches mémoire séparées restent utiles mais insuffisantes : elles rappellent, stockent ou relient, sans décider quoi exposer, à qui, quand, ni avec quel niveau de preuve.
Solution. Ajouter un orchestrateur de contexte qui classe la tâche, choisit un profil, arbitre les sources, calcule un budget, critique les contradictions, produit un context pack, puis décide persistance, invalidation ou escalade.
Maturité. Gouverné
Contrôles. Context scorecard, provenance obligatoire, budget tokens/coût, policy engine, memory gate, pre-stage-transition, ledger des décisions de contexte
À ne pas faire. Laisser chaque subagent récupérer son propre contexte sans coordination globale.
Relations. Gouverne ORC-04 · Produit ORC-02
ORC-06 — Context constitution¶
Intention. Définir l'ordre d'autorité des informations utilisées par l'agent.
Problème. L'agent peut traiter une mémoire, une similarité ou une hypothèse comme équivalente à une source de vérité.
Solution. Établir une constitution du contexte : source active > preuve vérifiée > décision validée > mémoire durable > handoff récent > hypothèse > similarité vectorielle.
Maturité. Contrôlé
Contrôles. Source registry, claim ledger, memory gate, vérification de provenance, marquage des hypothèses
À ne pas faire. RAG aveugle ou mémoire autoritaire.
Relations. Fonde ORC-05 · À ne pas confondre avec ORC-04
ORC-07 — Context conflict resolver¶
Intention. Résoudre ou exposer les contradictions de contexte avant action.
Problème. Code, documentation, tickets, mémoire, ADR et demande client peuvent se contredire.
Solution. Détecter les conflits, classer leur gravité, appliquer l'ordre d'autorité, puis décider : source gagnante, hypothèse, question client, tâche d'analyse ou blocage.
Maturité. Contrôlé
Contrôles. Context scorecard, claim ledger, validation authority, incident si mémoire contaminée
À ne pas faire. Choisir la source la plus récente ou la plus similaire sans justification.
Relations. Dépend de ORC-06 · À ne pas confondre avec ORC-08
ORC-08 — Context budget escalation¶
Intention. Augmenter le contexte seulement quand une preuve montre que le budget courant est insuffisant.
Problème. Le contexte grossit par confort, ou reste trop petit par économie, ce qui crée hallucinations et coûts inutiles.
Solution. Définir des déclencheurs d'escalade de tiny vers small, medium ou deep, avec justification, durée et retour au budget inférieur après synthèse.
Maturité. Contrôlé
Contrôles. Logs tokens/coût, context scorecard, pre-context-load, validation si dépassement de seuil
À ne pas faire. Prompt-cargo : ajouter toujours plus de contexte sans diagnostic.
Relations. Alimente ORC-05 · Mesuré par QUA-06 · À ne pas confondre avec ORC-04
ORC-09 — Workflow State Engine¶
Intention. Rendre les workflows agentiques explicites, reprenables et auditables.
Problème. Les agents enchaînent souvent étapes, interruptions et reprises dans une logique cachée au prompt ou au runtime.
Solution. Déclarer un manifeste d'états, transitions, guards, retries, interruptions, compensations et preuves minimales.
Maturité. Orchestré
Contrôles. Workflow state manifest, mission ledger append-only, evidence-driven transition, telemetry events
À ne pas faire. Décrire un process dans un prompt sans état machine ni preuve de transition.
Relations. Décrit par ORC-10 · Alimente QUA-05
ORC-10 — Flow DSL minimal¶
Intention. Décrire des flows réutilisables sans créer un langage complexe prématuré.
Problème. Les workflows restent dispersés entre prompts, scripts et documentation, ou deviennent un DSL trop riche et fragile.
Solution. Définir un DSL minimal : états, transitions, guards, preuves et export Mermaid/manifest.
Maturité. Gouverné
Contrôles. Flow DSL minimal, workflow state manifest, validation syntaxique, dry-run de flow
À ne pas faire. Encoder la logique métier dangereuse directement dans le DSL au lieu de la garder dans les policies/outils.
Relations. Décrit ORC-09 · Validé par GOV-02
ORC-11 — Planner-executor-critic¶
Intention. Séparer planification, exécution et critique pour les tâches complexes ou risquées.
Problème. Un agent unique peut confondre intention, action et validation, puis défendre son propre résultat.
Solution. Organiser trois responsabilités : un planner produit plan et critères, un executor agit sous task envelope, un critic vérifie hypothèses, preuves, erreurs et risques résiduels.
Maturité. Orchestré
Contrôles. Task envelope, validation authority, independent reviewer, evidence pack, budget de critique proportionné au risque
À ne pas faire. Demander au même agent de planifier, exécuter et valider une décision critique sans séparation de rôle.
Relations. Produit ORC-02 · Escalade vers QUA-15 · À ne pas confondre avec COG-03