Checkpoint Recovery

Saves the current state of a long-running task to a checkpoint file so it can be resumed accurately after interruption, context reset, or session end.

Purpose

Capture a complete snapshot of in-progress task state — completed steps, current step status, remaining steps, key decisions, and created files — and restore that state precisely on resume so no work is repeated or lost.

Trigger

Apply when:

• User says "save progress", "checkpoint", "resume task", "where were we", "recover from interruption"
• "儲存進度", "斷點恢復", "繼續任務", "從哪裡繼續"
• Task has more than 5 remaining subtasks and context window is filling up
• Approaching context window compression (proactive trigger)
• Before any operation that changes external state (file writes, API calls, database changes)
• User requests a pause or indicates they will return later