OpenSkillIndex← back to search
claude-code

Learn-skills.dev ac-checkpoint-manager

Manage checkpoints for rollback capability. Use when creating save points, rolling back changes, managing recovery points, or restoring previous states.

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/adaptationio/skrillz/ac-checkpoint-manager" ~/.claude/skills/neversight-learn-skills-dev-ac-checkpoint-manager && rm -rf "$T"
manifest: data/skills-md/adaptationio/skrillz/ac-checkpoint-manager/SKILL.md
source content

AC Checkpoint Manager

Manage checkpoints for safe rollback during autonomous development.

Purpose

Creates and manages checkpoints that enable rollback to known-good states, providing safety during autonomous operation.

Quick Start

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint("before-refactor")
await manager.restore_checkpoint(checkpoint.id)

Checkpoint Types

  • Auto: Created automatically at key points
  • Manual: Created on explicit request
  • Feature: Created after each feature completion
  • Session: Created at session boundaries

Checkpoint Structure

.claude/checkpoints/
├── checkpoint-20240115-100000/
│   ├── metadata.json
│   ├── feature_list.json
│   ├── execution-state.json
│   └── git-ref.txt
├── checkpoint-20240115-110000/
│   └── ...

Auto-Checkpoint Points

  • Before starting new feature
  • After completing feature
  • Before risky operations
  • At context compaction

Workflow

1. CREATE    → Snapshot current state
2. STORE     → Save files and git ref
3. VALIDATE  → Verify checkpoint integrity
4. (on rollback)
5. RESTORE   → Restore from checkpoint
6. VERIFY    → Confirm restoration

Integration

  • Used by: 
    ac-state-tracker
    for state recovery
  • Used by: 
    ac-task-executor
    before risky operations

API Reference

See 

scripts/checkpoint_manager.py
for full implementation.