session-handoff

name	session-handoff
description	Generate comprehensive session summary for handoff to new LLM session. Use when user says "session handoff", "세션 인계", "세션 정리", "handoff", "다음 세션에 넘겨줘", or when ending a session and needing to preserve full context for continuation. Do NOT use for learning summaries (use learning-tracker skill), TIL documents (use til skill), or development work logs (use devlog skill).

Session Handoff - 대화 세션 인계 요약본 생성

목표

현재 세션의 모든 내용을 극도로 상세하게 요약하여, 새 LLM 세션에서 완벽하게 맥락을 이어받을 수 있도록 합니다.

실행 단계

1단계: 슬러그 결정

세션 핵심 주제를 영문 kebab-case 슬러그로 요약 (2~4단어). 사용자에게 제안 후 확인. _session/{topic-slug}.md 기존 파일 있으면 읽어서 이전 맥락 파악.

2단계: 상세 요약 생성

기존 핸드오프가 있으면 이전 맥락을 흡수하여 통합 작성. 아래 9개 섹션 구조를 따라 극도로 상세하게 작성 (상세는 references 참조).

섹션 목록:

• I. 빠른 시작 가이드 (Quick Start) — 반드시 최상단
• II. 근본적인 목표 및 초기 설정
• III. 상세한 대화 전개 과정
• IV. 공유된 중요 정보 및 배경 맥락
• V. 시도한 접근법과 결과 (CRITICAL)
• VI. 중간 결론, 합의, 잠정적 성과
• VII. 대화 중단 시점의 정확한 상태
• VIII. 남은 계획 및 다음 단계 (CRITICAL)
• IX. 핵심 개념, 용어, 반복된 패턴

3단계: 파일 저장 + Clipboard 복사

_session/ 폴더 확인/생성 → Write tool로 저장 → cat _session/{topic-slug}.md | pbcopy

4단계: 사용자 안내

저장 경로 + "Clipboard에 복사되었습니다" + 새 세션 사용법 안내.

핵심 원칙

• 자립성: 이 파일 하나만으로 다음 에이전트가 바로 작업 이어받기 가능. 맥락 독립적
• 상세성: 정보 누락 금지. "답변했다"가 아니라 "어떤 답변을 했는지". 코드 스니펫 포함
• Rolling 통합: 최근 2세션 상세 유지, 이전은 핵심만 압축. 실패한 것들/핵심 파일/남은 계획은 항상 유지
• 한국어 작성

References

파일	내용
references/section-template.md	I~IX 전체 섹션 상세 구조 (25개 항목)

Gotchas

• 추상적 기술: "리팩토링했다"로 끝내지 말고 구체적 변경사항, 파일, 코드 포함
• 실패 접근법 누락: Section V의 "What Didn't Work"는 다음 에이전트가 같은 실수 반복 방지에 핵심
• 기존 파일 무시: _session/{slug}.md 기존 파일이 있으면 반드시 읽고 통합. 덮어쓰기만 하면 이전 맥락 유실