diff --git a/ARCHIVED.md b/ARCHIVED.md
new file mode 100644
index 0000000..d52c737
--- /dev/null
+++ b/ARCHIVED.md
@@ -0,0 +1,23 @@
+# Archived
+
+This repo is **archived** as of 2026-06-02. Not deployed, not maintained.
+
+## What this was
+
+Custom Go microservice for per-user file sync (Steam-Cloud-style). Reached working skeleton (33 tests passing) before being deprecated in favor of [`Timemachine/cloud-sync`](https://git.timemachine.center/Timemachine/cloud-sync)'s simpler restic-backed architecture.
+
+## Why deprecated
+
+`restic-rest-server` with `--private-repos --append-only` does everything cloud-svc would have done — snapshots, retention, chunk-level dedup, encryption, server-enforced append-only — and is already deployed on `john`. Building cloud-svc was reinventing it badly.
+
+See [`Timemachine/cloud-sync/DESIGN.md`](https://git.timemachine.center/Timemachine/cloud-sync/src/branch/main/DESIGN.md) for the chosen architecture.
+
+## What's preserved here
+
+- Commit history (skeleton through pivot decision)
+- `DESIGN.md` — the original design; useful as a record of what was considered
+- 33 tests covering the abandoned API surface
+
+## What to do if you land here
+
+Use [`Timemachine/cloud-sync`](https://git.timemachine.center/Timemachine/cloud-sync) instead. This repo is for reference only; no PRs accepted, no security fixes shipped, no production use.