kc-session-handoff

Session Handoff

Write a journal entry and produce a minimal resume prompt for the next session.

Companion skill: kc-session-resume handles context restoration on the other side.

When NOT to Use

• Trivial sessions (pure Q&A, no code changes)
• Active GSD phase — use /gsd:pause-work instead

Focus Note (optional argument)

If the user provided text after /kc-session-handoff (e.g., /kc-session-handoff 重點記錄 auth middleware 決策), treat it as a focus note — emphasize these topics in the journal's ## Completed / ## Remaining / ## Decisions sections. This does NOT replace git/conversation state gathering — it supplements it with explicit user intent about what matters most for the next session.

Primary Trigger

Context pressure (WARNING/CRITICAL) is the most common trigger. The skill is designed to work under tight context budgets. Steps 2.5 and 2.7 are conditional — skip them freely. Steps 1–3 and the confirmation block are never optional, regardless of remaining context.

Process

1. Gather State

pwd                          # current working directory
git branch --show-current 2>/dev/null || echo "(no git branch)"
git status --short 2>/dev/null || echo "(no git repo)"
git log --oneline -5 2>/dev/null
git rev-parse --show-toplevel 2>/dev/null

Non-git fallback: If git commands fail (workspace root, temp dir, non-repo), proceed with branch = "(no branch)". The journal and resume prompt still work — use the working directory and description as the primary identifiers instead.

Working directory: Record pwd output. This is critical for multi-directory workspaces where GSD, bun test, or other tools must run from a specific subdirectory (not the git root or workspace root). The resume skill restores this context so the next session starts in the right place.

Worktree detection — compare --show-toplevel against main worktree:

git worktree list

If --show-toplevel differs from the first line of worktree list → you are in a linked worktree. Record the path. If they match → main worktree, omit worktree field. If git worktree list fails → omit worktree field (assume main).