Modèle de transfert dans les workflows Claude : Split en deux fichiers contre résumé en un document

Les longues sessions Claude se dégradent à cause de la perte de contexte. Les handoffs résolvent ce problème en compressant les informations clés dans un document et en démarrant un nouvel agent. Deux implémentations sont actuellement discutées dans la communauté : la compétence /handoff de Matt Pocock et une approche alternative de split en deux fichiers utilisée dans le framework multi-agent APM.
Compétence Handoff de Matt Pocock
La compétence de Pocock condense la conversation en un seul document. Elle pointe vers les artefacts existants sans les reformuler, et le prochain agent reprend de là. Elle permet aussi d'enchaîner entre les threads : /grill-with-docs → /handoff → /prototype → /handoff retour. Le dépôt est disponible sur mattpocock/skills.
Approche Split en Deux Fichiers (Framework APM)
Une approche alternative, intégrée dans le framework multi-agent APM pour Claude Code dès mai 2025, divise le handoff en deux artefacts :
- Fichier de récit persistant — enregistre ce qui a été fait, les décisions prises et pourquoi. Il reste dans le projet et laisse une trace durable.
- Prompt éphémère — indique à l'agent entrant comment reconstruire le contexte à partir de la base de code et du fichier de récit persistant.
La différence clé : l'agent entrant reconstruit à partir de l'état durable du projet (base de code + récit), pas seulement de la conversation compressée. Persister le récit le rend également visible quand plusieurs agents sont impliqués, permettant de suivre quel agent travaille à partir d'un résumé ou d'un contexte de première main. Cela facilite la gestion des lacunes de contexte.
L'auteur a ouvert un ticket sur le dépôt de Pocock avec ces idées : mattpocock/skills#235.
Questions Clés
- Un seul document compressé suffit-il pour les handoffs ?
- Ou le split en deux fichiers (récit persistant + prompt éphémère) offre-t-il une meilleure reconstruction du contexte et une traçabilité multi-agent ?
La discussion est en cours. Les deux approches sont valables selon que vous ayez besoin d'une reprise rapide ou de workflows multi-agent de longue durée avec gestion des lacunes de contexte.
📖 Lire la source complète : r/ClaudeAI
👀 See Also

civStation : Harnais VLM Open-Source pour le Contrôle en Langage Naturel de Civilization VI
civStation est une pile informatique open-source qui permet le contrôle vocal et en langage naturel de Civilization VI, traduisant des commandes stratégiques de haut niveau en actions d'interface utilisateur via une boucle d'observation et d'exécution basée sur un VLM.

La compétence OpenClaw ajoute la génération d'images par IA avec prise en charge locale de ComfyUI et des invites organisées.
Une nouvelle compétence OpenClaw offre des capacités de génération d'images par IA directement dans le terminal, avec plus de 1 300 invites sélectionnées, une intégration locale de ComfyUI et des flux de travail d'amélioration des invites.

Colony : Une couche de coordination locale qui réduit les jetons de transfert multi-agents de 30 000 à 400
Colony est un substrat de coordination local-first qui réduit les coûts de transfert multi-agents d'environ 30 000 jetons à environ 400 en remplaçant la relecture du contexte par des observations compactes stockées dans SQLite.

DocMason : Base de connaissances d'agent local pour les fichiers bureautiques complexes
DocMason est une application agent native de dépôt qui construit des bases de connaissances locales à partir de documents bureautiques complexes comme les PPTX, DOCX, Excel et PDF. Il fonctionne entièrement dans Codex ou Claude Code, en conservant la structure des documents et en fournissant des réponses traçables avec leur provenance.