AP82 · Framework opaque

Famille : Supervision, exploitation et gouvernance

Preuve moyenne

Noms d'origine : opaque framework abstractions

Le framework cache le prompt, le contexte envoyé ou le flux de contrôle : on ne règle pas ce qu’on ne voit pas.

Définition

Un framework cache le prompt final, le contexte effectivement envoyé au modèle ou le flux de contrôle.

Symptômes observables

  • Impossible de voir le prompt final.
  • On débogue en lisant le code du framework.
  • Un plafond de qualité que l’équipe ne sait pas dépasser.

Pourquoi c'est nuisible

On ne peut pas faire d’ingénierie du contexte sur ce qu’on ne voit pas. Anthropic note que ces couches d’abstraction masquent les prompts et les réponses, et compliquent le débogage.

Un choix défendable quand…

  • Un framework qui laisse voir et modifier le prompt, le contexte envoyé et le flux de contrôle : le problème tient à l’opacité, pas au framework.

Chiffres

  • HumanLayer (D. Horthy) : les équipes atteignent 70 à 80 % de qualité avec un framework, constatent que c’est insuffisant pour la production, puis repartent de zéro. Retour d’expérience rapporté, non mesuré.

Remèdes du catalogue

  • B6 · Graphe d’états sur mesure — Écrire le graphe d’états à la main : chaque nœud, chaque transition et chaque prompt restent lisibles dans le code de l’équipe.

Mesures hors catalogue

  • Posséder ses prompts, son contexte et son flux de contrôle (12-Factor Agents, facteurs 2, 3 et 8).
  • Journaliser le contexte réellement envoyé au modèle à chaque appel.

Patterns détournés

Anti-patterns voisins

Sources

Contenu relu le 2026-10-05

Catalogue des anti-patterns