Handoffs-Muster in Claude-Workflows: Zwei-Datei-Aufteilung vs. Ein-Dokument-Zusammenfassung

Lange Claude-Sitzungen leiden unter Kontextverfall. Handoffs lösen dies, indem sie wichtige Informationen in einem Dokument komprimieren und einen neuen Agenten starten. In der Community werden derzeit zwei Implementierungen diskutiert: Matt Pococks /handoff-Skill und ein alternativer Zwei-Datei-Ansatz, der im APM-Multi-Agenten-Framework verwendet wird.

Matt Pococks Handoff-Skill

Pococks Skill komprimiert das Gespräch in einem einzigen Dokument. Er verweist auf bestehende Artefakte, anstatt sie neu zu formulieren, und der nächste Agent übernimmt von dort. Er verknüpft auch Threads miteinander: /grill-with-docs → /handoff → /prototype → /handoff zurück. Das Repository ist unter mattpocock/skills verfügbar.

Zwei-Datei-Aufteilung (APM-Framework)

Ein alternativer Ansatz, der bereits im Mai 2025 in das APM-Multi-Agenten-Framework für Claude Code integriert wurde, teilt den Handoff in zwei Artefakte auf:

• Persistente Narrativdatei – zeichnet auf, was getan wurde, welche Entscheidungen getroffen wurden und warum. Sie bleibt im Projekt und hinterlässt eine dauerhafte Spur.
• Ephemerer Prompt – weist den eingehenden Agenten an, wie er den Kontext aus der Codebasis und der persistenten Narrativdatei wiederherstellen kann.

Der Hauptunterschied: Der eingehende Agent rekonstruiert aus dauerhaftem Projektzustand (Codebasis + Narrativ), nicht nur aus dem komprimierten Chatgespräch. Die Persistenz des Narrativs macht es auch sichtbar, wenn mehrere Agenten beteiligt sind, sodass nachvollziehbar ist, welcher Agent mit einer Zusammenfassung und welcher mit direktem Kontext arbeitet. Dies erleichtert die Handhabung von Kontextlücken.

Der Autor hat ein Issue zu Pococks Repository mit diesen Ideen eröffnet: mattpocock/skills#235.

Wichtige Fragen

• Reicht ein einziges komprimiertes Dokument für Handoffs aus?
• Oder bietet die Zwei-Datei-Aufteilung (persistentes Narrativ + ephemerer Prompt) bessere Kontextrekonstruktion und Nachvollziehbarkeit bei mehreren Agenten?

Die Diskussion läuft noch. Beide Ansätze sind gültig, je nachdem, ob eine schnelle Zusammenfassung oder langlaufende Multi-Agenten-Workflows mit Kontextlücken-Management benötigt werden.