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.