checkpoint

name	checkpoint
description	Save current progress to memory-keeper to prevent work loss.

Checkpoint Skill

Automatically checkpoint current progress to memory-keeper to prevent catastrophic work loss when context is exhausted.

When to Use

• Every 5-10 tool calls during implementation
• After completing a significant piece of work
• Before starting a large operation
• When switching tasks
• Before ending a session
• When explicitly requested via /checkpoint

Checkpoint Actions

1. Gather Current State

Collect the following information:

• Current task description from todo list
• List of files modified this session
• Implementation progress (percentage or phase)
• Current blockers or issues
• Next action to take

2. Save to Memory-Keeper

context_save(key: "current-task", value: "<task description>", category: "progress", priority: "high")
context_save(key: "files-modified", value: "<comma-separated file list>", category: "progress")
context_save(key: "implementation-progress", value: "<percentage or phase>", category: "progress")
context_save(key: "next-action", value: "<exact next step>", category: "progress", priority: "high")

3. Create Named Checkpoint

context_checkpoint(
  name: "checkpoint-<timestamp>",
  description: "Task: <task>, Progress: <progress>, Files: <count>, Next: <action>"
)

4. Prepare for Compaction (if context is large)

context_prepare_compaction()

Checkpoint Frequency Guidelines

Activity	Checkpoint Frequency
File creation/modification	After every file
Running tests	After each test run
Research/exploration	Every 10 tool calls
Debugging	After each hypothesis tested
Multi-step implementation	After each step

Key Items to Always Save

Key	Description	Priority
current-task	What you're currently working on	high
files-modified	All files touched this session	normal
implementation-progress	How far along (%, phase)	normal
next-action	Exact next step to take	high
blockers	Current issues/blockers	high
todo-state	Serialized todo list	normal

Checkpoint Output

After checkpointing, confirm with:

Checkpoint saved:
- Task: <current task>
- Progress: <progress>
- Files modified: <count>
- Next action: <next step>

Recovery Reference

If context is lost, use /recover to restore state from checkpoints.