클로드 워크플로우의 핸드오프 패턴: 두 파일 분할 방식과 한 문서 요약 방식

긴 Claude 세션은 컨텍스트 소멸로 인해 성능이 저하됩니다. 핸드오프는 핵심 정보를 문서로 압축하고 새로운 에이전트를 시작하여 이 문제를 해결합니다. 현재 커뮤니티에서는 두 가지 구현 방식이 논의되고 있습니다: Matt Pocock의 /handoff 스킬과 APM 멀티 에이전트 프레임워크에서 사용되는 대안적인 두 파일 분할 접근법입니다.

Matt Pocock의 핸드오프 스킬

Pocock의 스킬은 대화 내용을 단일 문서로 압축합니다. 기존 아티팩트를 다시 설명하는 대신 참조하며, 다음 에이전트가 그 내용을 이어받습니다. 또한 스레드 간 체이닝이 가능합니다: /grill-with-docs → /handoff → /prototype → 다시 /handoff. 저장소는 mattpocock/skills에서 확인할 수 있습니다.

두 파일 분할 접근법 (APM 프레임워크)

2025년 5월 Claude Code용 APM 멀티 에이전트 프레임워크에 내장된 대안적 접근법은 핸드오프를 두 개의 아티팩트로 분할합니다:

• 지속적 내러티브 파일 — 수행된 작업, 결정 사항 및 그 이유를 기록합니다. 이 파일은 프로젝트 내에 위치하여 지속적인 추적을 가능하게 합니다.
• 임시 프롬프트 — 새로운 에이전트가 코드베이스와 지속적 내러티브 파일에서 컨텍스트를 재구축하는 방법을 안내합니다.

핵심 차이점: 새 에이전트는 압축된 채팅 대화가 아닌 지속적인 프로젝트 상태(코드베이스 + 내러티브)에서 재구축합니다. 내러티브를 유지하면 여러 에이전트가 관여할 때 어떤 에이전트가 요약 기반인지 직접 컨텍스트 기반인지 추적할 수 있어 컨텍스트 간격을 더 쉽게 관리할 수 있습니다.

저자는 이러한 아이디어를 Pocock의 저장소에 이슈로 제출했습니다: mattpocock/skills#235.

핵심 질문

• 단일 압축 문서만으로 핸드오프가 충분한가?
• 아니면 두 파일 분할(지속적 내러티브 + 임시 프롬프트)이 더 나은 컨텍스트 재구축과 멀티 에이전트 추적성을 제공하는가?

논의는 진행 중입니다. 빠른 재개가 필요한지, 아니면 컨텍스트 간격 관리가 필요한 장기 멀티 에이전트 워크플로우가 필요한지에 따라 두 접근법 모두 유효합니다.