Claude 워크플로우의 핵심 패턴으로 자리 잡는 핸드오프(Handoff)
Handoffs are becoming a first-class pattern in Claude workflows. Here is how I have been thinking about them.
핵심 요약
Claude 세션의 컨텍스트 소실 문제를 해결하기 위해 대화 내용을 압축하고 다음 에이전트로 넘기는 핸드오프 전략을 공유함.
- 컨텍스트 소실 해결 — 긴 세션에서 발생하는 성능 저하를 방지하기 위해 대화 내용을 압축하고 새 에이전트로 전환함.
- 핸드오프 전략 — 서사 파일과 임시 프롬프트를 분리하여 에이전트 간의 컨텍스트를 효과적으로 재구성함.
- 멀티 에이전트 관리 — 여러 에이전트가 협업하는 시스템에서 작업 이력을 추적하고 컨텍스트 공백을 최소화함.
- 커뮤니티 활용 — Matt Pocock의 핸드오프 스킬과 같은 도구를 활용해 워크플로우를 자동화하고 최적화함.
긴 Claude 세션은 여전히 컨텍스트 소실로 인해 끊기곤 합니다. 핸드오프는 이를 해결하는 간단한 방법입니다. 중요한 내용을 압축하고, 새로운 에이전트를 시작하고, 계속 진행하는 것이죠.
Matt Pocock의 새로운 handoff 스킬(repo)은 이 과정을 명령어 하나로 수행합니다. 대화를 문서로 압축하고, 기존 아티팩트를 다시 설명하는 대신 가리키기만 하면 다음 에이전트가 이어서 작업을 수행합니다. 스레드 간 연결도 가능합니다: /grill-with-docs -> /handoff -> /prototype -> /handoff back.
저는 2025년 5월(1년 전...)에 Claude Code를 위한 멀티 에이전트 프레임워크인 APM에 핸드오프 기능을 구축했습니다. 당시에는 컨텍스트 윈도우가 너무 작아서 계속 새로 시작하지 않으면 끊임없이 환각(hallucination) 현상을 겪어야 했거든요.
제가 다르게 접근한 점은 핸드오프를 두 개의 아티팩트로 나눈 것입니다.
- 무엇을, 왜 결정했는지 기록하는 지속적인 서사 파일(persistent narrative file)
- 코드베이스와 해당 서사 파일로부터 컨텍스트를 재구성하는 방법을 알려주는 임시 프롬프트(ephemeral prompt)
다음 에이전트는 단순히 압축된 대화 내용이 아니라, 지속 가능한 프로젝트 상태로부터 컨텍스트를 재구성합니다. 파일을 유지하면 기록이 남기 때문에, 여러 에이전트가 관여하는 멀티 에이전트 시스템에서 한 에이전트가 직접적인 컨텍스트가 아닌 요약본을 기반으로 작업할 때 이를 추적할 수 있습니다. 컨텍스트 공백을 관리하기가 훨씬 쉬워지죠.
Matt의 저장소에 이런 아이디어들을 담아 이슈를 하나 올렸습니다: mattpocock/skills#235.
여러분은 핸드오프를 어떻게 처리하시나요? 수동 요약, 스킬, 아니면 서브 에이전트를 사용하시나요? 그리고 두 개의 파일로 나누는 방식이 공감이 가시나요, 아니면 문서 하나로도 충분하다고 생각하시나요?
