Add Claude Code memory snapshot and restore instructions

README.md

@@ -13,6 +13,28 @@ Created for migrating the current KiteStacks host to Hetzner Cloud.
 - `restore/RESTORE.md` - first-pass restore procedure.
 - `SHA256SUMS` - checksums for all files in this backup.
 
+## Restoring Claude's Context on a New Machine
+
+This repo includes a snapshot of Claude Code's persistent memory in `claude-memory/`
+(taken from `~/.claude/projects/-home-kenpat/memory/` on the original host). It
+captures the homelab setup, this migration plan/status, and your working
+preferences, so a fresh Claude session on the new machine doesn't start blank.
+
+To restore it:
+
+1. Clone this repo on the new machine.
+2. Copy the contents of `claude-memory/` into Claude Code's memory directory for
+   your new home path, e.g.:
+   ```sh
+   mkdir -p ~/.claude/projects/-home-<youruser>/memory
+   cp claude-memory/*.md ~/.claude/projects/-home-<youruser>/memory/
+   ```
+3. Start a Claude Code session in that project. It will automatically load
+   `MEMORY.md` and the linked memory files, and can pick up the migration
+   (and any other tracked work) where it left off.
+4. Update `claude-memory/project-cloud-migration.md` as migration phases
+   progress, and re-copy it back into this repo so future restores stay current.
+
 ## Important
 
 This repository contains secrets: `.env` files, tunnel tokens, app database data, and service credentials. Keep it private.