checkpoint

Save, resume, discard, or replace RDPI session snapshots in tasks/checkpoint.md.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/KMakayee/playbook --skill checkpoint-kmakayee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/checkpoint
Command: npx skills add https://github.com/KMakayee/playbook --skill checkpoint-kmakayee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents you from losing progress during an agentic software engineering session by letting you save, resume, discard, or replace a complete suspend-and-resume snapshot of your work.

Core Features & Use Cases

  • Create a checkpoint snapshot: Captures RDPI phase, plan cursor position, branch state, and an embedded recovery diff so a later session can restore context.
  • Resume with validation: Re-reads the saved checkpoint, validates frontmatter and branch/base commit reachability, and re-locates the plan cursor before continuing.
  • Discard or replace safely: Removes the checkpoint (discard/delete/remove) or overwrites it atomically with a new snapshot (replace), with guardrails when no checkpoint exists.

Quick Start

Use checkpoint to save your current session by running the checkpoint command with no arguments.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I resume an agentic software engineering session after losing context?

To resume an agentic software engineering session, you can restore a saved checkpoint snapshot that captures your RDPI phase, plan cursor position, branch state, and recovery diff. This allows a later session to safely continue exactly where you left off.

How do I validate branch and base commit drift before resuming a development workflow?

Validating branch and base commit drift before resuming a development workflow involves re-reading the saved checkpoint, robustly parsing frontmatter, and checking branch and base commit reachability to ensure phase-accurate cursor restoration.

Can I safely discard or replace a git checkpoint snapshot if my work is obsolete?

Yes, you can safely discard or replace a git checkpoint snapshot if your work is obsolete. The system removes the checkpoint file or atomically overwrites it with a new snapshot, providing guardrails when no checkpoint exists.

What is the best way to save RDPI session state for diff recovery?

The best way to save RDPI session state for diff recovery is by creating a checkpoint snapshot that embeds a recovery diff and captures the current plan cursor and branch state into a dedicated markdown file.

Do I need a specific git workflow to use deterministic commit consumption for checkpoints?

Deterministic commit consumption for checkpoints requires an RDPI workflow using singleton RDPI artifacts or issue-specific plan and research artifacts, applying git-isolated semantics to manage your suspend-and-resume snapshots safely.