| allowed-tools | ["Read","Bash","Grep","Glob"] |
| description | Use when a session ends, work must pause, or another agent will continue the task to commit changes, run tests, and store handoff memory. |
| name | handoff |
| trigger | 세션 종료, 핸드오프, session end, handoff, 인수인계, wrap up session, 작업 정리, 세션 정리, 중단, 일시정지, checkpoint, suspend, save state, 다음 세션, 이어받기, continue next, resume work, 상태 저장, 작업 넘기기, session checkpoint, wrap up, finish session |
Quick Reference
- 상태 확인: Uncommitted 변경사항이 없으면 커밋 스킵 (Step 4 직행)
- 테스트 실행: 실패 시 수정 금지, 실패 사실만 메모리에 기록
- 커밋 & 푸시: 변경사항 분석 후 conventional commit 및 remote push 필수
- 메모리 저장:
session-handoff 태그로 Completed/In Progress/Next Steps 구조 준수
- 요약 출력: Branch, Commit Hash, Test Status 포함하여 다음 세션에 전달
Workflow
Step 1: Status Check
현재 작업 상태를 확인합니다.
git status
git diff --stat
판단 기준:
- Uncommitted changes 있음 → Step 2로 진행
- Clean working tree → Step 4로 직접 이동 (커밋 불필요)
- Untracked files만 있음 → 의도적 무시인지 확인 후 진행
Step 2: Test Execution
scripts/detect-language.sh의 함수를 활용하여 언어 비종속적으로 테스트를 실행합니다.
source .hxsk/scripts/detect-language.sh
RUNNER=$(detect_test_runner)
PKG=$(detect_pkg_manager)
TEST_CMD=$(get_test_cmd "$RUNNER" "$PKG")
테스트 결과 분기:
- PASS → Step 3으로 진행
- FAIL → 실패 내용을 핸드오프 메모리에 기록하고 Step 3 진행 (수정 시도하지 않음)
- 테스트 없음 (
RUNNER=unknown) → 스킵, Step 3으로 진행
중요: 핸드오프 시점에서 실패한 테스트를 수정하지 않는다. 실패 사실만 기록하여 다음 세션에 전달.
Step 3: Commit & Push
commit 스킬을 활용하여 커밋합니다.
- Commit:
commit 스킬 워크플로우 실행
- 변경사항 분석 → 논리적 단위 분리 → conventional commit 생성
- Push:
git push 실행
- Remote tracking branch 없으면
git push -u origin <branch> 사용
Step 4: Handoff Memory Store
md-store-memory.sh로 세션 인수인계 정보를 저장합니다.
bash .hxsk/hooks/md-store-memory.sh \
"Session Handoff: <session-goal>" \
"<content>" \
"handoff,session,<scope-tags>" \
"session-handoff" \
"<keywords>" \
"<contextual_description>" \
"<related-memory-slugs>"
Handoff Memory Content Structure
<content> 필드는 아래 구조를 따릅니다:
## Completed
- [task/feature 완료 목록]
## In Progress
- [진행 중이던 작업 + 현재 상태]
## Blocked / Failed
- [블로커 또는 실패한 테스트 목록]
## Next Steps
- [다음 세션에서 이어할 작업 목록, 우선순위 순]
## Key Decisions
- [이번 세션에서 내린 주요 결정사항]
## Commit History
- <commit-hash>: <description>
Step 5: Handoff Summary Output
아래 형식으로 요약을 출력합니다:
---
SESSION HANDOFF
Branch: <branch-name>
Last Commit: <hash> — <message>
Test Status: PASS | FAIL (N failures) | SKIPPED
---
Completed: <bullet list>
In Progress: <bullet list>
Next Steps: <bullet list>
---
Mid-Execution Handoff
executor 스킬 실행 중 세션이 종료되어야 하는 경우:
- 현재 task까지만 완료 — 진행 중인 task를 마무리하거나 안전한 지점까지 진행
- Phase checkpoint commit —
executor의 Phase Checkpoint Commit 절차 실행
- Handoff workflow 실행 — 이 스킬의 Step 1~5 실행
- In Progress 섹션에 executor 상태 포함:
- 현재 Phase/Plan/Task 위치
- PLAN.md 경로
- 남은 task 수
Anti-Patterns
| Anti-Pattern | 올바른 방법 |
|---|
| 핸드오프 시 실패 테스트 수정 시도 | 실패 사실만 기록, 수정은 다음 세션 |
| 메모리 저장 없이 커밋만 | 반드시 session-handoff 메모리 저장 |
| "다 끝났다"만 기록 | Completed/In Progress/Next Steps 구조 준수 |
| push 없이 종료 | 반드시 remote에 push |
| PLAN.md 상태 업데이트 누락 | executor 연동 시 PRD/PLAN 상태도 반영 |
Iron Laws
NO TEST FIX WITHOUT NEW SESSION START
NO COMMIT WITHOUT HANDOFF MEMORY STORE
NO SESSION END WITHOUT GIT PUSH
NO HANDOFF WITHOUT STATUS CHECK
NO HANDOFF SUMMARY WITHOUT STRUCTURED CONTENT
NO MID-EXECUTION HANDOFF WITHOUT PHASE CHECKPOINT
