diff --git a/RECLONE.md b/RECLONE.md
new file mode 100644
index 00000000..5190b1fb
--- /dev/null
+++ b/RECLONE.md
@@ -0,0 +1,16 @@
+# claudetools was restructured 2026-06-18 — RE-CLONE if you have an old clone
+
+History was rewritten: every project split into its own Gitea repo (now git **submodules**),
+and large data/history purged. `.git` went 3.2 GB → ~80 MB. An OLD clone (multi-GB `.git`,
+no submodules) is **incompatible** — do NOT `/sync`, `/save`, or `git push` from it.
+
+Re-clone:
+```
+cd <parent>;  mv ClaudeTools ClaudeTools.old
+git clone https://git.azcomputerguru.com/azcomputerguru/claudetools.git ClaudeTools
+cp ClaudeTools.old/.claude/identity.json ClaudeTools/.claude/      # gitignored, per-machine — keep it
+cd ClaudeTools && git submodule update --init --recursive
+# recover any uncommitted work from ClaudeTools.old, then delete it
+```
+Project history now lives in the submodules under `projects/`. Full pre-split backup bundle:
+`\172.16.3.20\Backups\Gitea-Storage\claudetools-pre-split-2026-06-18.bundle`