kc-session-resume

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.