handoff

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 스킬을 활용하여 커밋합니다.

1. Commit: commit 스킬 워크플로우 실행
   • 변경사항 분석 → 논리적 단위 분리 → conventional commit 생성
2. 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 스킬 실행 중 세션이 종료되어야 하는 경우:

1. 현재 task까지만 완료 — 진행 중인 task를 마무리하거나 안전한 지점까지 진행
2. Phase checkpoint commit — executor의 Phase Checkpoint Commit 절차 실행
3. Handoff workflow 실행 — 이 스킬의 Step 1~5 실행
4. 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