# Backup Rollback

> Snapshot configs, memory, and skills before risky edits, and define a rollback path. Use before bulk refactors, migrations, or skill/config changes.

- Skill: `navinspire-ia/backup-rollback` (Agent Skill)
- Install (CLI): `npx skillmds@latest add navinspire-ia/backup-rollback`
- Raw SKILL.md: https://api.skillmd.com/api/skills/navinspire-ia/backup-rollback/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Navinspire-ia (https://skillmd.com/u/navinspire-ia)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/navinspire-ia/backup-rollback

---


# Backup & Rollback

## Overview

Make change reversible before you make it hard to undo.

## Native checkpoints (first line of defense)

Navin saves a checkpoint **automatically before every user prompt**: the conversation state plus the pre-edit content of every file the agent modifies with its file tools. Rewind with:

- `/checkpoint` - list restore points (auto + manual)
- `/checkpoint save <note>` - add a named restore point before a risky step
- `/checkpoint restore <name> code` - revert the files the agent edited, keep the conversation
- `/checkpoint restore <name> chat` - rewind the conversation, keep the code
- `/checkpoint restore <name>` - rewind both

Limits (recommend git for anything beyond these):
- Shell-command changes (`rm`, `mv`, scripts) are **not** tracked - only edits made through the file tools
- External/manual edits are not tracked
- Checkpoints are session-local recovery, not version control

## What to snapshot

| Area | How |
|------|-----|
| Code | native checkpoints for tool edits; git branch / commit for everything else |
| Config | copy of `config.json` or relevant snippets |
| Skills | copy `skills/<name>/` before overwrite |
| Data | DB dump / export when migrating |

## Workflow

1. Identify blast radius (files, skills, services).
2. Create a restore point:
   - `git status` + commit or stash when in a repo
   - or copy critical files to `backups/<timestamp>/` in the workspace
3. Perform the change in the smallest steps.
4. Verify (tests, smoke check).
5. If failed: restore from the snapshot; do not “fix forward” blindly on production data.

## Rollback note (always leave for the user)

```markdown
## Rollback
Restore point: ...
Command / steps: ...
```