| 1 | # Revisions Backup Runbook v1 |
| 2 | |
| 3 | ## Goal |
| 4 | |
| 5 | Keep `.revisions/` out of canonical Git history while preserving recoverability. |
| 6 | |
| 7 | ## Policy |
| 8 | |
| 9 | - `.revisions/` is local operational history and is ignored by Git. |
| 10 | - Canonical repository stores only decision-grade memory (`agent-notes.md`, `knowledge/*`). |
| 11 | - Archive snapshots are created on schedule and before risky migrations. |
| 12 | |
| 13 | ## Recommended Cadence |
| 14 | |
| 15 | - Weekly backup. |
| 16 | - Extra backup before: |
| 17 | - large KB refactors, |
| 18 | - alias retirements, |
| 19 | - mass renames or compaction passes. |
| 20 | |
| 21 | ## Manual Backup (PowerShell) |
| 22 | |
| 23 | From repository root: |
| 24 | |
| 25 | ```powershell |
| 26 | $stamp = Get-Date -Format "yyyyMMdd-HHmmss" |
| 27 | New-Item -ItemType Directory -Force -Path ".\backups" | Out-Null |
| 28 | Compress-Archive -Path ".\.revisions\*" -DestinationPath ".\backups\revisions-$stamp.zip" |
| 29 | ``` |
| 30 | |
| 31 | ## Restore (PowerShell) |
| 32 | |
| 33 | ```powershell |
| 34 | Expand-Archive -Path ".\backups\revisions-YYYYMMDD-HHMMSS.zip" -DestinationPath ".\.revisions" -Force |
| 35 | ``` |
| 36 | |
| 37 | ## Verification |
| 38 | |
| 39 | - Backup archive exists in `backups/`. |
| 40 | - Randomly open one snapshot file from extracted archive to validate readability. |
| 41 | - Keep at least last 4 weekly archives. |
| 42 | |
| 43 | |
View only · write via MCP/CIDE