Claude Code 세션 핸드오프 템플릿: 다음 사람이나 에이전트가 바로 이어받을 수 있게 남기는 법

Claude Code는 세션이 이어질 때 더 강해진다

많은 실패는 모델이 코드를 못 써서가 아니라, 다음 세션이 이전 상태를 모르는 데서 생깁니다. handoff note는 내일의 나나 다음 담당자가 안전하게 이어가도록 만드는 짧은 운영 메모입니다.

이 글은 첫 작업 runbook 과 bug report 템플릿 을 연결합니다.

복사해서 쓰는 handoff 템플릿

# Claude Code Handoff

## Goal
- 오늘 달성할 것:
- 오늘 하지 않을 것:

## Current state
- branch:
- last commit:
- dirty files:
- 관련 URL:

## What changed
- 변경 내용:
- 수정 파일:
- 의도:

## Verification
- 실행한 명령:
- 결과:
- 눈으로 확인한 것:

## Risks
- 깨지기 쉬운 곳:
- 건드리지 말 곳:
- 미확인:

## Next prompt
다음 세션은 먼저 git status와 최근 diff를 확인하고,
이 handoff와 모순이 없는지 본 뒤 시작하세요.

좋은 예

## Goal
- /en/products/에서 5/25 세 글로 내부 링크 추가
- 오늘은 가격표 구조를 바꾸지 않음

## Verification
- npm.cmd run build: 성공
- production /en/products/: 200
- mobile 390px: 가로 넘침 없음

## Risks
- Gumroad link는 영어판 중심
- 비영어 본문은 공개 URL에서 다시 확인

흔한 누락

• build 성공만 쓰고 공개 URL 확인을 쓰지 않는다
• dirty files를 설명하지 않는다
• 미확인을 “아마 괜찮음”으로 숨긴다
• 다음 prompt를 남기지 않는다

handoff는 긴 일기가 아닙니다. 다음 세션이 5분 안에 안전하게 재개할 수 있으면 됩니다.

다음 단계

개인 운용은 무료 cheatsheet 로 확인 절차를 고정하세요. 팀 표준화에는 Setup Guide 와 Prompt Templates 조합이 좋습니다. 도입 설계가 필요하면 상담 페이지 를 보세요.

handoff는 commit message보다 자세하고 작업 일기보다 짧아야 한다

handoff note는 다음 세션이 안전하게 재개하기 위한 운영 데이터입니다. commit message만으로는 검증과 위험이 부족하고, 작업 일기는 너무 깁니다. 현재 상태, 변경 이유, 검증, 위험 구역, 다음 prompt만 남기면 됩니다.

이 handoff를 리뷰해 주세요.
1. git status와 모순이 없는가
2. 변경 이유가 한 문장으로 설명되는가
3. build와 공개 URL 확인이 분리되어 있는가
4. 미확인 위험이 숨겨져 있지 않은가
5. 다음 prompt만으로 재개할 수 있는가

다국어 사이트에서는 공개 URL, 언어, 모바일 폭, CTA 상태를 함께 남겨야 합니다. build 성공만으로 사용자가 보는 페이지가 맞다고 볼 수 없습니다.