# Handoff

> 세션 종료 전 HANDOFF.md 작업 인계 문서 생성. Triggers on: 인계, handoff, 세션 정리, HANDOFF.md, 작업 넘기기. NOT for: 코드 작성, 리뷰.

- Skill: `jh941213/handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jh941213/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jh941213/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jh941213 (https://skillmd.com/u/jh941213)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jh941213/handoff

---


# HANDOFF.md 생성

세션 종료 전 작업 인계 문서를 생성합니다.

## HANDOFF.md란?
컨텍스트 리셋 전에 작업 상태를 기록하는 파일입니다.
새 세션에서 이 파일만 읽으면 바로 이어서 작업할 수 있습니다.

## 생성할 내용

`tasks/context.md`가 있으면 그 내용(목표/결정/다음단계)을 병합하고 중복 작성하지 않는다.

```markdown
# 작업 인계 문서

## 완료된 작업
- [x] 완료된 작업 1
- [x] 완료된 작업 2

## 진행 중인 작업
- [ ] 현재 작업 중인 것
  - 진행 상황: 70%
  - 다음 단계: ~~ 구현

## 다음에 해야 할 작업
1. 우선순위 높은 작업
2. 그다음 작업

## 주의사항
- 건드리면 안 되는 파일: ~~
- 알려진 버그: ~~
- 임시 해결책: ~~

## 관련 파일
- src/components/Login.tsx - 로그인 폼
- src/api/auth.ts - 인증 API

## 마지막 상태
- 브랜치: feature/auth
- 마지막 커밋: abc1234
- 테스트 상태: 통과
```

## 사용 시점
- 작업 주제를 전환하며 /clear 하기 전
- 컨텍스트 오염 신호(같은 실수 반복, 이전 결정 망각)가 보일 때
- 작업을 며칠 쉬기 전
- 복잡한 작업 중간에 세션을 넘길 때

새 세션에서 "HANDOFF.md 읽고 이어서 작업해줘"라고 하면 됩니다.

## HANDOFF.md 크기 가이드라인
- 최대 100줄, 3000자 이내 목표
- 코드 스니펫은 최소한으로 (파일 경로만 기록)
- 핵심 컨텍스트만 기록, 세부사항은 코드에서 확인
- 새 세션의 초기 토큰 소비를 줄여 캐시 워밍업 비용 절약