---
name: AC Checkpoint Manager
slug: ac-checkpoint-manager
category: DevOps
description: AC Checkpoint Manager creates and restores checkpoints for safe rollback during autonomous development. Use it to save state before risky changes, recover known-good points, or return to a previous checkpoint.
github: "https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/ac-checkpoint-manager"
language: HTML
stars: 575
forks: 88
install: "npx degit https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/ac-checkpoint-manager ~/.claude/skills/ac-checkpoint-manager"
installs_to: ~/.claude/skills/ac-checkpoint-manager
source_path: skills/agent/ac-checkpoint-manager/SKILL.md
collection_size: 23
category_size: 798
collection_url: "https://dirskills.com/collections/majiayu000/claude-skill-registry"
added: 2026-08-25T05:14:10.785Z
last_synced: 2026-08-25T05:14:10.785Z
canonical_url: "https://dirskills.com/skills/ac-checkpoint-manager"
---

# AC Checkpoint Manager

AC Checkpoint Manager creates and restores checkpoints for safe rollback during autonomous development. Use it to save state before risky changes, recover known-good points, or return to a previous checkpoint.

**Install:**

```bash
npx degit https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/ac-checkpoint-manager ~/.claude/skills/ac-checkpoint-manager
```

## README

# 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

```python
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.