Emile Handoff — Documentation skill for Claude Code

emile-handoff

[Claude Code](https://claude.com/claude-code) skill that writes a session handoff document so work can continue cleanly in a fresh session.

세션 컨텍스트가 커져서(대략 20만 토큰 근처) 곧 압축/초기화될 것 같을 때, 지금까지의 진행 상황·결정 사항·다음 할 일을 `docs/handoffs/`에 마크다운으로 정리해두는 Claude Code 스킬입니다. 새 세션에서 이 파일을 읽으면 이전 맥락을 빠르게 복원할 수 있습니다.

When it triggers

• 현재 세션의 컨텍스트가 커져서 압축/초기화가 임박했을 때
• 작업을 새 세션으로 넘겨야 할 때
• 사용자가 "핸드오프 만들어줘", "다음 세션에 이어서" 등을 요청할 때

What it produces

`docs/handoffs/{YYYYMMDD}-{HHMM}-{간략한-제목}.md` 파일 하나에 아래 항목을 채워 넣습니다.

• 다음 세션 시작 프롬프트 (그대로 복사해서 붙여넣을 수 있는 블록)
• 작업 배경 / 목표
• 완료된 작업
• 현재 상태
• Git 상태 (브랜치, 이번 핸드오프의 커밋 여부, 커밋 안 된 변경사항)
• 남은 작업 / 다음 단계
• 주요 결정 사항
• 참고 파일 / 경로
• 기타 참고사항

파일을 저장한 뒤에는 "다음 세션 시작 프롬프트" 블록을 채팅 응답에도 그대로 출력해, 사용자가 바로 복사해 `/clear` 후 붙여넣을 수 있게 합니다.

Commit

**기본값은 커밋하지 않는 것입니다.** 핸드오프 파일만 만들고 git은 건드리지 않으며, 커밋할지 여부를 묻지도 제안하지도 않습니다. 세션을 넘기기 직전에 대화가 한 번 더 끊기지 않도록 하기 위해서입니다.

커밋을 원하면 요청에 함께 적으면 됩니다 — "핸드오프 쓰고 커밋해줘"처럼 말하면 그때만 커밋하고, 범위(핸드오프 파일만 / 이번 세션 변경사항 전체)와 푸시 여부도 말한 대로 따릅니다. 범위를 말하지 않으면 핸드오프 파일만 커밋합니다. 어느 경우에도 사용자가 요청하지 않은 커밋을 임의로 만들지는 않습니다.

Install

Claude Code는 `~/.claude/skills//`(전역) 또는 `/.claude/skills//`(프로젝트 한정) 아래의 `SKILL.md`를 스킬로 인식합니다.

git clone https://github.com/emile-popcornsar/emile-handoff.git ~/.claude/skills/emile-handoff

또는 특정 프로젝트에서만 쓰려면 해당 리포의 `.claude/skills/emile-handoff/`에 두면 됩니다.

Usage

Claude Code 세션에서:

/emile-handoff

또는 자연어로 "핸드오프 만들어줘"라고 요청하면 스킬 설명(description)을 보고 자동으로 매칭됩니다.

Related

• emile-masterplan — 여러 세션·여러 plan에 걸치는 대형 작업 묶음을 위한 상위 진행 상황 문서 스킬. 슬라이스 중간에 세션이 끊길 때는 emile-masterplan이 아니라 이 스킬(emile-handoff)을 사용합니다.

License

MIT