Prévenir l'effondrement du contexte des agents IA
Empêchez l'effondrement du contexte dans les tâches longues des agents IA en persistant les plans, les notes de recherche et les journaux de progression sous forme de trois fichiers Markdown. Réinjectez-les au début de chaque tour pour éviter la dérive des objectifs. Fonctionne avec Claude Code (plugin) ou d'autres agents via npx. Destiné aux développeurs intermédiaires+ utilisant Claude Code, Codex, etc.
Contexte
En septembre 2026, les développeurs utilisant des agents IA comme Claude Code ou Codex pour des tâches longues se heurtaient à un effondrement du contexte. L'historique des conversations dépassait la fenêtre de contexte, déclenchant une compression ou un /clear manuel, ce qui faisait perdre à l'agent ses objectifs et découvertes. Les résultats devenaient incohérents, avec des travaux répétés et une fiabilité compromise.
La communauté a proposé planning-with-files : externaliser la mémoire dans trois fichiers Markdown (plan.md, research.md, progress.md). Injectés au début de chaque tour, ils restaurent le contexte. Publié comme plugin Claude Code et portable via npx, il a séduit les développeurs cherchant une persistance déterministe.
Analyse approfondie
La méthode contourne les limites des fenêtres de contexte, même larges. Les compressions classiques (fenêtres glissantes, résumés) détruisent l'état fin. Ici, le système de fichiers sert de mémoire externe vérifiable. plan.md décompose la tâche, research.md stocke les références et décisions, progress.md journalise les étapes et problèmes.
Contrairement aux mémoires vectorielles, cette approche ne nécessite aucune infrastructure supplémentaire, est déterministe et facilite le débogage. Le format Markdown préserve les détails, évitant la distorsion des résumés. Pour les développeurs, c'est un équilibre simplicité-contrôle-fiabilité.
Impact sur l'industrie
Cette pratique réduit les échecs des tâches longues, encourageant la délégation de travaux complexes (refactorisations, recherches, DevOps) à Claude Code et Codex CLI. Elle amplifie l'utilité de ces outils et accélère leur adoption professionnelle.
Elle expose aussi le manque de gestion d'état native chez Anthropic et OpenAI. L'équipe Claude Code envisagerait des points de contrôle officiels. Des frameworks comme LangChain et AutoGPT reconsidèrent leurs mémoires vectorielles. Le paradigme « explicite, basé sur fichiers » pourrait influencer les IDE agents comme Cursor et Windsurf.
Perspectives
Des variantes émergeront : notes bibliographiques pour la recherche, états de test pour l'AQ, fichiers partagés pour le multi-agent. L'outillage pourrait automatiser leur gestion. À surveiller : l'intégration native dans Claude Code, des mécanismes analogues dans Codex CLI ou GitHub Copilot Workspace, et l'adoption par les IDE émergents.
Même avec des fenêtres de contexte élargies, la persistance explicite reste cruciale pour la focalisation, la reprise après interruption et la traçabilité. Cette approche relie la génération probabiliste à une gestion d'état déterministe, les fichiers jouant le rôle de pont.