여러 작업을 오가도 어디까지 했는지 놓치지 않게 해주는 플러그인입니다. 전체 설명은 README.md 참고.
/plugin marketplace add https://github.com/Gilbert9172/handoff.git
/plugin install handoff@gilbert9172
/reload-plugins/handoff:list # "아직 handoff가 없습니다" → 정상# 작업을 좀 하다가, 마무리하며 저장
/handoff:save my-first-task
# 저장된 목록 확인
/handoff:list
# 나중에 새 대화에서 그대로 이어받기
/handoff:resume my-first-task🌅 시작할 때 — /handoff:list로 어떤 작업이 어디까지 왔는지 한눈에 봅니다.
| Slug | Updated | Lines | Goal |
|---|---|---|---|
| auction-state-machine | 2026-06-11 | 52 | 낙찰→납부 상태 전이 설계 |
| batch-php-migration | 2026-06-13 | 88 | 레거시 PHP 배치를 신규 런타임으로 이관 |
/handoff:resume batch-php-migration # 오늘은 이거 이어서
# 🌙 끝낼 때
/handoff:save # 제목 없이 저장하면 알아서 같은 노트 갱신/새 노트 생성
# ✨ 완전히 끝났으면
/handoff:finish batch-php-migration # 종료 처리 — done/ 으로 봉인finish한 노트는 목록에서 빠지고 save도 덧붙이지 않습니다. 기록은 done/에 남아 /handoff:list --done으로 볼 수 있고, 정말 지울 때만 /handoff:delete를 씁니다.
| 커맨드 | 용도 | 예시 |
|---|---|---|
/handoff:save [제목] |
현재 작업 저장/갱신 | /handoff:save api-docs |
/handoff:save --compact |
길어진 노트 압축 (작업은 계속) | /handoff:save api-docs --compact |
/handoff:list |
목록 보기 | /handoff:list |
/handoff:resume [슬러그] |
작업 재개 | /handoff:resume api-docs |
/handoff:finish [슬러그] |
끝난 작업 종료 처리 | /handoff:finish api-docs |
/handoff:delete [슬러그] |
노트 완전 삭제 | /handoff:delete api-docs |
Codex에서는 skill 호출 접두사가
$입니다 —$handoff:save,$handoff:list처럼 입력하세요. 이 문서는 Claude Code 표기(/)로 씁니다.
# Goal ← 목표 (한두 문장)
# Current Progress ← 지금까지 한 일
# What Worked ← 잘된 접근
# What Didn't Work ← 실패한 접근 + 이유 (반복 방지)
# Next Steps ← 다음에 할 구체적 작업업데이트하면 Progress·Next Steps는 최신으로 새로 쓰고, What Worked/Didn't Work는 누적됩니다. 노트가 길어지면
--compact로 오래된 기록만 묶습니다.
~/.handoffs/<프로젝트-슬러그>/HANDOFF-<슬러그>.md
<프로젝트-슬러그>는 git 루트 경로의 /를 -로 바꾼 값. 프로젝트마다 자동으로 분리됩니다. Claude Code와 Codex 어느 쪽에서 저장·조회하든 같은 경로입니다. 파일을 직접 열어 수정해도 됩니다.
Q. 제목을 안 주면? A. 기존 노트 중 같은 작업이면 갱신, 새 작업이면 Goal에서 슬러그를 뽑아 새로 만듭니다. 애매하면 물어봅니다.
Q. 같은 제목으로 다시 저장하면? A. 그 파일이 업데이트됩니다(Progress·Next Steps는 갱신, What Worked/Didn't Work는 누적).
Q. 프로젝트를 바꾸면? A. git 루트가 다르면 슬러그도 달라져, 프로젝트별로 노트가 따로 관리됩니다.
Q. 삭제하면 복구되나요? A. 안 됩니다. 삭제 전 확인을 받지만 신중히 고르세요.
Q. 커맨드가 안 보여요.
A. /reload-plugins → 그래도 없으면 /plugin list로 설치 여부, /plugin marketplace list로 마켓플레이스 등록 여부 확인.
- Next Steps는 구체적으로. "테스트 더 하기"보다 "
tests/auth.test.ts의 POST 케이스 작성"처럼 — 미래의 나(또는 동료)가 바로 시작할 수 있게. - 실패는 이유까지. What Didn't Work가 다음 세션의 삽질을 막아줍니다.
- 병렬 작업은 노트를 나눠서.
/handoff:save auction-state-machine,/handoff:save batch-php-migration처럼 작업별로.
🚀 습관 하나만: 세션 끝에 /handoff:save.