kc-session-resume

Restore developer session context from journal handoffs and project checkpoints.

3|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/iamcxa/kc-claude-plugins --skill kc-session-resume
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kc-session-resume
Source: https://github.com/iamcxa/kc-claude-plugins/tree/main/kc-hyperfocus/skills/kc-session-resume
Command: npx skills add https://github.com/iamcxa/kc-claude-plugins --skill kc-session-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Restore lost or paused developer context so engineers can pick up work quickly without manually reconstructing branch state, recent commits, or prior decisions.

Core Features & Use Cases

  • Handoff ID lookup: Directly load a session handoff when the user supplies an explicit handoff ID and avoid scanning other checkpoints.
  • List & present recent handoffs: Search and display recent session handoffs scoped to the repo, widening scope when none are found, and require explicit user selection.
  • GSD vs Journal decisioning: Detect GSD checkpoints and journal handoffs, present numbered options when both exist, and never auto-merge or auto-select between them.
  • Mandatory MEMORY.md check: Always scan project MEMORY.md for relevant context and flag candidates for migration to CLAUDE.md with user confirmation.
  • Environment validation & safety: Warn on worktree or working-directory mismatches, and require explicit task direction before performing any work.
  • Use case: When a developer types "resume" or supplies a handoff ID, the skill finds the correct journal entry, shows a summary, and waits for a specific task to begin.

Quick Start

Resume my session using handoff ID 2024-01-02/10-00-00-000000 and present options before proceeding.

Frequently Asked Questions about kc-session-resume

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restore a paused developer session from a handoff ID?

To restore a paused developer session, supply the handoff ID to directly load the matching journal entry, which bypasses scanning other checkpoints and immediately presents the context summary for your review.

What happens when both GSD checkpoints and journal handoffs exist for a git repository?

When both GSD checkpoints and journal handoffs exist, the system detects both formats and presents numbered options, requiring explicit user selection rather than auto-merging or auto-selecting between them.

How do I resume work in a git worktree without losing prior context?

To resume work safely, the system validates worktree and working-directory consistency, scans MEMORY.md for relevant context, and warns on mismatches before requiring explicit task direction to begin.

When do I need to migrate context from MEMORY.md to CLAUDE.md?

You need to migrate context from MEMORY.md to CLAUDE.md when the mandatory context scan flags relevant candidates during session restoration, requiring your explicit confirmation before proceeding.

Can I list recent session handoffs if I don't have a specific ID?

You can list recent session handoffs by typing resume or continue without an ID, which searches repo-scoped entries, widens scope if none are found, and requires explicit selection before loading context.

Does session restoration work with local git repositories and project workspaces?

Session restoration applies to local git repositories and project workspaces, performing prioritized handoff lookups, reading recent journal entries, and recording resume metrics using specified MCP tools.