git:20260507.8dfdcb4 to git:20260507.9f5be95

---

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)