# Mk Session Continuation

> Persists and restores mid-session workflow progress across context resets. Use when resuming workflows, saving state, or handling context compaction. Triggers on: handoff, save state, resume workflow.

- Skill: `ngocsangyem/mk-session-continuation-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ngocsangyem/mk-session-continuation-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ngocsangyem/mk-session-continuation-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: ngocsangyem (https://skillmd.com/u/ngocsangyem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ngocsangyem/mk-session-continuation-2

---


<!-- Split for progressive disclosure (checklist #11, #14): 427 → ~60 lines -->

# Session Continuation

Manage workflow state across sessions with handoff and resume.

## When to Use

- Runtime reports that the session is approaching its context-warning threshold
- User says "handoff", "save", "pause"
- User says "resume" + workflow ID
- Session ending with incomplete workflow
- Incomplete workflow from previous session

## Plan State Variables

```toon
state_vars[4]{var,purpose,persistence}:
  MEOWKIT_ACTIVE_PLAN,Current active plan path,Session temp file
  MEOWKIT_SUGGESTED_PLAN,Branch-matched plan hint,Inferred from git branch
  MEOWKIT_COMPLEXITY,Auto-detected task complexity,Session memory
  MEOWKIT_ACTIVE_AGENTS,Currently active agents,Session memory
```

## Process

1. **Detect trigger** — token limit, user command, or session ending
2. **If handoff** — load `references/handoff-flow.md`, execute save + summary
3. **If resume** — load `references/resume-and-state.md`, execute load + restore + continue
4. **If list** — show all saved workflows from `.codex/logs/workflows/`

## References

| Reference | When to load | Content |
|-----------|-------------|---------|
| **[handoff-flow.md](./references/handoff-flow.md)** | On handoff/save trigger | State save format, summary generation |
| **[resume-and-state.md](./references/resume-and-state.md)** | On resume trigger | Resume steps, state management, error handling, TOON format |

## Quick Commands

```
workflow:handoff           → Save state + get resume instructions
workflow:resume AUTH-123   → Load state + continue from last phase
workflow:list              → Show all saved workflows
```

## Gotchas

- **Stale handoff after codebase changes**: Saved state references files that were renamed or deleted → Validate all file paths in handoff state before resuming
- **TOON corruption on concurrent sessions**: Two agents writing state simultaneously → Use file locking or session-scoped state files