kc-session-resume

Session Resume

Restore context from a previous session's journal handoff entry.

Companion skill: kc-session-handoff creates the entries this skill reads.

Routing

Priority order — explicit handoff ID always wins:

1. User gave handoff ID (YYYY-MM-DD/HH-MM-SS-nnnnnnn pattern) → Go directly to step 2A. Do NOT check GSD checkpoints, do NOT read .continue-here.md, do NOT read STATE.md. The handoff ID is the sole intent signal — GSD state is irrelevant when the user points to a specific journal entry.
2. No handoff ID → Check GSD structure:

   ls .planning/phases/*/.continue-here.md 2>/dev/null
   ls .planning/STATE.md 2>/dev/null
   

   • GSD checkpoint found → Check for recent journal handoffs too (step 2B preview: list_recent_entries(days: 3, limit: 3, type: "project")). If BOTH GSD checkpoint AND journal handoffs exist → you MUST present numbered options and wait for user choice:

     找到兩種可恢復的上下文：
     1. GSD Phase {N}: {description} (checkpoint)
     2. Journal handoff: {branch} — {description} ({date})
     
     要恢復哪一個？
     

     User picks GSD → invoke /gsd:resume-work. User picks journal → continue to step 2B. Do NOT merge both sources on your own judgment. Do NOT auto-select "the most recent one." Even if they point to the same branch, they represent different resume mechanisms — the user decides which context to restore.
   • GSD checkpoint only (no recent journal handoffs) → Inform user, invoke /gsd:resume-work.
   • No GSD → Continue to step 1.

Process

1. Extract Clues (no handoff ID path only)

Extract branch name / topic keywords from prompt. Fallback: git branch --show-current.

Also check current state:

git branch --show-current
git status --short
git log --oneline -3
git rev-parse --show-toplevel

Derive repo slug (same logic as kc-session-handoff Step 1.5):

REPO_SLUG=$(basename "$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null | sed 's|/\.git$||')" 2>/dev/null | tr '[:upper:]' '[:lower:]')
REPO_SLUG=${REPO_SLUG:-$(basename "$(pwd)" | tr '[:upper:]' '[:lower:]')}