**TL;DR**: `/checkpoint [name]` - Create git snapshot with verification for safe experimentation.

---

## Usage

```bash
/checkpoint                 # Auto-named checkpoint
/checkpoint before-refactor # Named checkpoint
/checkpoint list            # List all checkpoints
/checkpoint restore <name>  # Restore to checkpoint
```

## What It Does

1. **Creates snapshot** - Commits current state
2. **Tags it** - For easy reference
3. **Verifies** - Runs quick sanity checks
4. **Records** - Logs checkpoint in `.claude/state/`

## When to Use

- Before risky refactoring
- Before experimental changes
- When trying multiple approaches
- Before merging complex branches

## Example Session

```bash
$ /checkpoint before-auth-refactor

Creating checkpoint...
  ✅ All changes committed
  ✅ Tag created: checkpoint/before-auth-refactor
  ✅ Build verified
  ✅ Tests pass

Checkpoint created! To restore:
  /checkpoint restore before-auth-refactor

# Later, after things go wrong...
$ /checkpoint restore before-auth-refactor

Restoring checkpoint...
  ✅ Working directory clean
  ✅ Restored to checkpoint/before-auth-refactor
  ✅ Build verified

Restored successfully!
```

## Checkpoint Format

```
checkpoint/<name>-<timestamp>
```

Example: `checkpoint/before-refactor-20260124-1530`

## List Checkpoints

```bash
$ /checkpoint list

Checkpoints:
  before-auth-refactor   (2h ago)    47 files
  experiment-1           (1d ago)    12 files
  stable-point           (3d ago)    89 files
```

## Integration

Checkpoints integrate with:
- Git tags for persistence
- State tracking in `.claude/state/`
- Verification loop before creation
