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