Checkpoint Management

Git-backed state management for safe rollback. Create and restore checkpoints with tagged commits and metadata tracking.

a5c-ai Updated 1.7k repo stars

File contents

  • Stage all current changes
  • Create commit with [CHECKPOINT] prefix
  • Tag with claudekit-checkpoint-{timestamp}
  • Record metadata: files changed, insertions, deletions

Restore Checkpoint

  • List available checkpoints by tag
  • Preview changes that would be reverted
  • Restore to selected checkpoint via git reset
  • Verify restored state matches checkpoint

Session Isolation

Checkpoints are session-scoped. Tags created during a session can be cleaned up without affecting other work.

When to Use

  • Before risky refactoring operations
  • After passing quality checks (safety checkpoints)
  • At the start and end of ClaudeKit sessions
  • Before spec execution phases

Processes Used By

  • claudekit-orchestrator (session start/end checkpoints)
  • claudekit-safety-pipeline (safety checkpoints after quality checks)

a5c-ai/babysitter/tree/main/library/methodologies/claudekit/skills/checkpoint-management commit 04f1258da9

Frequently asked questions

npx skillmds@latest add a5c-ai/checkpoint-management