Principe #3 · /sdd context

Context Engineering Budget — la discipline du contexte

Le Product Engineer est responsable du budget de contexte de chaque session agent. Un agent ne dégrade pas sa qualité à la limite théorique de sa fenêtre — il la dégrade bien avant. Le Context Engineering Budget est la discipline qui transforme cette réalité physique en règles opérationnelles.

Le context rot — la dégradation avant la limite

Le context rot désigne la dégradation de la qualité LLM bien avant la limite théorique de la fenêtre de contexte. Les symptômes sont reconnaissables : réponses moins précises, oublis de contraintes de spec, comportements répétitifs. Un AGENT-GUIDE de cent pages n'est pas plus efficace — il est moins efficace : l'agent reçoit tout, comprend peu. C'est pourquoi injecter tous les artefacts en même temps est l'anti-pattern principal du framework.

Anthropic a formalisé en mars 2026 le Context Engineering comme discipline à part entière, distincte du prompt engineering — « l'art et la science de curating ce qui entre dans la fenêtre de contexte limitée ». Le Context Budget AIAD en est une implémentation opérationnelle, présente dans le framework depuis la v1.3.

Le seuil opérationnel : 60-70 % de la fenêtre

Le point clé : la fenêtre disponible ne change pas le seuil de 60-70 % — elle le déplace vers le haut. Les fenêtres de 1M tokens repoussent le seuil de dégradation, elles ne le suppriment pas ; elles ne dispensent pas non plus du découpage en sessions à objectif unique.

Une référence datée, pas une vérité durable

Règle transverse de la doctrine v1.9 : toute hypothèse de capacité ou de prix citée dans un artefact AIAD est datée et revalidée périodiquement. Le tableau ci-dessus vaut au 25/09/2026 ; il ne cite aucun tarif, et en particulier aucun tarif promotionnel, par nature temporaire. Les règles du budget, elles, s'énoncent comme des mécanismes — part de la fenêtre, placement, délégation — pour rester valides quand les modèles changent.

Les règles de composition d'une session

Le « lost in the middle effect » est documenté : les LLM accordent plus d'attention au début et à la fin de leur contexte qu'au milieu. Placer l'intention et la SPEC en tête garantit que ce qui ne doit pas être trahi reste dans la zone de meilleure adhérence.

Délégation à des sous-agents : le contexte hérité

Certains harnesses font hériter aux sous-agents la conversation parente. Le coût d'une délégation dépend alors du mécanisme :

• si le sous-agent hérite de la conversation parente, son coût vaut contexte parent au moment du fork + travail propre, et non un coût marginal : il vaut mieux déléguer tôt, quand le contexte parent est encore léger ;
• le point de fork devient un poste de coût explicite du Context Audit ;
• si l'héritage est désactivé, le sous-agent part d'un contexte vierge et doit recevoir explicitement l'Intent Statement et la SPEC active.

Compaction intentionnelle et loop engineering

Deux pratiques issues du terrain complètent le budget. L'intentional compaction (Dex Horthy, HumanLayer) consiste à compacter délibérément l'historique en un état écrit — décisions prises, fichiers touchés, prochaines étapes — plutôt que de subir la compaction automatique. Le loop engineering consiste à structurer chaque boucle agentique autour d'un objectif, d'un critère de sortie et d'une vérification. Ce vocabulaire date de 2026 et reste un vocabulaire non stabilisé : il est adopté comme description de pratiques, pas comme norme.

L'argument économique

La discipline du contexte n'est pas qu'une affaire de qualité — c'est une décision d'optimisation de coût mesurable. Deux données convergentes valident l'intent-based design : R2Code (arXiv, avril 2026) mesure −41,7 % de tokens consommés sur du code spec-anchored, avec +7,4 % de fidélité ; AWS Strands (2026) observe −96 % de tokens sur des workflows intent-based. Sur des projets intensifs en génération de code, l'économie est directement mesurable — et model-agnostic : elle s'applique quelle que soit la plateforme. La commande /sdd context fournit une estimation du coût évité par session.

La skill context-budget et les 5 métriques santé

L'audit post-session est outillé par la skill context-budget, invoquée par /sdd context, /sdd exec (vérification du budget) et /sdd resume. Elle calcule cinq métriques et produit un score de santé sur 5 :

Chaque métrique hors cible pointe une remédiation précise : M1 < 70 % → contexte injecté en excès ; M4 en baisse → context rot, condenser l'AGENT-GUIDE ; M5 > 35 min → objectif trop large, passer par /sdd split. Si une métrique n'est pas mesurable, le score sort en ?/5 — un JNSP, pas un zéro.

Session unique < 35 minutes, puis /compact

La règle pratique qui résume tout : une session = un objectif, durée inférieure à 35 minutes, contexte = AGENT-GUIDE + ARCHITECTURE condensée + SPEC active. Au-delà de 35 minutes, lancer /compact et repartir sur une session propre — une session qui s'étire est le signal d'une SPEC trop large ou d'un contexte mal préparé, pas d'un agent lent. La commande /sdd resume reconstruit alors un contexte minimal et précis depuis le résumé de la session interrompue, sans tout réinjecter.