docs: link fresh clone guide and ac-scripts bootstrap script

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -1,5 +1,34 @@
 # ac-workspace
 
-Optional clone manifest for org `ac`.
+Clone manifest for org **`ac`** — one checkout for all product repos.
 
-`git clone git://f0xx.org/ac/ac-workspace && git submodule update --init`
+```bash
+git clone git://f0xx.org/ac/ac-workspace
+cd ac-workspace
+git checkout next
+git submodule update --init --recursive
+```
+
+## Layout
+
+Submodules are independent repos on `git://f0xx.org/ac/<name>` (branch `next`, single `initial` history).
+
+Core platform + deploy (init these first for backend work):
+
+- `ac-platform-db`, `ac-platform-php`, `ac-platform-web`, `ac-platform-edge`
+- `ac-deploy`, `ac-docs`, `ac-scripts`, `ac-ms-url-shortener`
+
+Backend microservices and consoles: `ac-ms-*`, `ac-be-*`  
+Mobile: `ac-mobile-android` (iOS stub: `ac-mobile-ios`)
+
+## Docs
+
+- **[DEVELOPER_SETUP.md](ac-docs/DEVELOPER_SETUP.md)** — repo map, lab paths
+- **[docs/FRESH_ENV_CLONE.md](ac-docs/docs/FRESH_ENV_CLONE.md)** — clean laptop + `ac-scripts/fresh-clone-dev-env.sh`
+- **SPEC:** `ac-docs` → `specs/20260618_repos_reorganizing.md`
+
+## Lab deploy
+
+`ac-deploy/sim/cluster0/` — NFS cluster scripts; composed backend at `/var/www/ac/composed/backend` on cast01–03.
+
+Remote: `git://f0xx.org/ac/ac-workspace`