checkpoint-management git:20260601.da7723aA

Immutable. This exact content is served forever at /api/v1/blob/ce359c4a5661acc7.

---
name: checkpoint-management
description: Git-backed state management for safe rollback. Create and restore checkpoints with tagged commits and metadata tracking.
allowed-tools: Read, Bash, Grep, Glob
graph:
  domains: [domain:software-engineering]
  skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
  workflows: [workflow:feature-development]
  topics: [topic:developer-experience]
  roles: [role:tech-lead, role:backend-engineer]
---

- 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)