# Sync Tool Usage

## When to Use

**Syncing .claude/ automation to target projects.**

## Quick Reference

```bash
pip install persuade

# Dry-run (preview changes)
persuade sync --dry-run .

# Actual sync
persuade sync .

# List backups
persuade rollback --list .

# Rollback to previous state
persuade rollback .
```

## Why This Matters

- **Consistency:** All projects use same standards
- **Updates:** Easy to propagate improvements
- **Safety:** Dry-run and rollback available
- **Validation:** Checks permissions, gitignore compliance
- **Educational:** Reports what changed and why

## Related

- **PR Iteration:** [automation/pr-iteration.md](pr-iteration.md)
- **Full Documentation:** See main persuade repository
