Note d'architecture
Ingénierie du Contexte
Contexte d'architecture
Méthode réutilisable
Appliqué à

Ce que j'appelais autrefois « documentation » est, en réalité, le véritable produit de mon travail avec l'IA.
Pendant des mois, j'ai construit des fichiers de contexte, structuré des dépôts avec des fichiers CLAUDE.md, créé des systèmes de mémoire persistante par projet. J'appelais cela « garder les choses organisées ». Ce que je faisais en réalité, c'était de l'ingénierie du contexte — je n'avais simplement pas de nom pour cela.
Tobi Lütke, PDG de Shopify, lui a donné un nom en juin 2025 : « Je préfère largement le terme 'ingénierie du contexte' à celui d'ingénierie du prompt. Il décrit mieux la compétence essentielle : l'art de fournir tout le contexte nécessaire pour que la tâche soit raisonnablement résoluble par le LLM. » Andrej Karpathy a affiné la définition : « l'ingénierie du contexte est l'art et la science délicats de remplir la fenêtre de contexte avec exactement la bonne information pour l'étape suivante. »
Il ne s'agit pas du prompt parfait. Il s'agit de ce qui se trouve dans la fenêtre de contexte au moment où le modèle doit agir.
Ce qui a changé — et pourquoi maintenant
L'ingénierie du prompt avait du sens en 2022–2023. C'était la compétence consistant à formuler la bonne question. Cela fonctionnait pour des tâches isolées. Mais lorsque les équipes sont passées des démonstrations aux systèmes en production — agents, flux de travail multi-étapes, mémoire persistante —, le prompt a cessé d'être le goulot d'étranglement.
La plupart des échecs des agents en production ne sont pas des échecs du modèle. Ce sont des échecs de contexte. Trop peu de contexte et le modèle hallucine. Trop, ou mal structuré, et il perd le fil. Le point d'équilibre n'est pas trivial — et il ne se résout pas par une meilleure formulation.
Si l'ingénierie du prompt consistait à trouver la phrase magique, l'ingénierie du contexte consiste à écrire le scénario complet.
À quoi ressemble une véritable architecture de contexte
Ce changement devient concret lorsqu'on observe comment sont réellement structurés les systèmes d'IA bien gouvernés. Une configuration prête pour la production ne repose pas sur un seul fichier d'instructions. Elle répartit le contexte sur plusieurs couches : un prompt système qui définit le comportement et les garde-fous ; une documentation modulaire couvrant le contexte métier, l'architecture, les règles de conception et l'état d'exécution ; une matrice de déclencheurs qui associe chaque type de changement au document exact devant être mis à jour ; et un journal de décisions qui conserve le raisonnement derrière les choix non évidents.
Chaque couche répond à une question différente que le modèle pourrait se poser. Ensemble, elles éliminent le besoin de réexpliquer le système à chaque tâche.
Ce n'est pas de la documentation. C'est de l'infrastructure.
La question qui compte vraiment
Dans les environnements d'entreprise, ce n'est pas seulement un problème de conception. C'est aussi un problème de gouvernance : qui possède le contexte, qui le met à jour, et qui est responsable lorsqu'il dérive ?
Si vous construisez avec l'IA en production, la question n'est plus « quel modèle devrions-nous utiliser ? ». C'est « qu'est-ce qui entre dans le contexte, dans quel ordre, et qui est responsable de le maintenir à jour ? ».
L'ingénierie du contexte est la réponse à cette question. Et, comme tout bon travail d'ingénierie, elle commence par une clarté sur le problème — pas par des mots magiques.
Comment gérez-vous le contexte persistant dans vos systèmes ? Laissez un commentaire.
Sources
- Tobi Lütke, post no X, junho 2025: https://x.com/tobi/status/1938270308563099971
- Andrej Karpathy, post no X, junho 2025: https://x.com/karpathy/status/1937902205765607626
- Simon Willison, "Context engineering", 27 Jun 2025: https://simonwillison.net/2025/jun/27/context-engineering/
- Simon Willison, "How to Fix Your Context", 28 Jun 2025: https://simonwillison.net/2025/Jun/29/how-to-fix-your-context/
- Philipp Schmid, "The New Skill in AI is Not Prompting, It's Context Engineering", Jun 2025: https://www.philschmid.de/context-engineering
- Drew Breunig, "Why 'Context Engineering' Matters", Jul 2025: https://www.dbreunig.com/2025/07/24/why-the-term-context-engineering-matters.html
- The Decoder, "Shopify CEO and ex-OpenAI researcher agree that context engineering beats prompt engineering", Jun 2025: https://the-decoder.com/shopify-ceo-and-ex-openai-researcher-agree-that-context-engineering-beats-prompt-engineering/
- Salesforce Ben, "Prompt Engineering Jobs Are Obsolete in 2025", Apr 2025: https://www.salesforceben.com/prompt-engineering-jobs-are-obsolete-in-2025-heres-why/