docs: add workspace clone commands

README.md

@@ -28,6 +28,47 @@ Multi-service monorepo for the Darano financial/crypto platform.
 - [overmind](https://github.com/DarthSim/overmind) or [foreman](https://github.com/ddollar/foreman) — Procfile runner
 - PostgreSQL 16, Redis, RabbitMQ running locally (or via Docker)
 
+## Clone the Workspace
+
+The Darano workspace is an aggregate of independent Git repositories. These
+commands reproduce the current directory layout and select the branches used by
+this refactor. They expect the local branches to have been pushed first and
+require SSH access to `git.darano.ir` (except `dev-procfile`, which uses HTTPS).
+
+```bash
+mkdir darano
+cd darano
+
+git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/AdminPanel.git AdminPanel
+git clone --branch m2 git@git.darano.ir:Kahroba/DevOps.git DevOps
+git clone --branch dev git@git.darano.ir:Kahroba/GL.git GL
+git clone --branch main git@git.darano.ir:KuknosNode/Scripts.git Kuknos-Node-scripts
+git clone --branch dev git@git.darano.ir:Kahroba/alert.git alert
+git clone --branch main git@git.darano.ir:Kahroba/api.git api
+git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/auth.git auth
+git clone --branch main https://git.darano.ir/Kahroba/dev-procfile.git dev-procfile
+git clone --branch dev git@git.darano.ir:Kahroba/docs.git docs
+git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/proto.git proto
+git clone --branch fix/contact-us git@git.darano.ir:Kahroba/ui.git ui
+git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/wallet.git wallet
+```
+
+`private-chain/` is not included because the current local repository has no
+`origin` remote configured.
+
+Recreate the root documentation links after cloning:
+
+```bash
+ln -s dev-procfile/AGENTS.md AGENTS.md
+ln -s dev-procfile/CLAUDE.md CLAUDE.md
+ln -s dev-procfile/README-REFACTORING.md README-REFACTORING.md
+ln -s dev-procfile/README.md README.md
+ln -s dev-procfile/REFACTORING-AUDIT.md REFACTORING-AUDIT.md
+ln -s dev-procfile/REFACTORING-PLAN.md REFACTORING-PLAN.md
+ln -s dev-procfile/REFACTORING-TODO.md REFACTORING-TODO.md
+ln -s dev-procfile/گزارش-زیرساخت-توکنسازی-دارانو.md گزارش-زیرساخت-توکنسازی-دارانو.md
+```
+
 ## Infrastructure
 
 Start the shared infrastructure (Postgres, Redis, RabbitMQ, MinIO):

REFACTORING-TODO.md

@@ -97,6 +97,7 @@ This is the authoritative execution tracker for the refactor. Work is performed
 | T008 | `DONE` | Execute full Docker image builds for every in-scope Go service. | GL passes and produced image `sha256:717c75dfa91f843acdb8d56b4dd111224e5ee45d060dcd4731e5d472ff2c8f69`; API, Auth, and Wallet are blocked in `go mod download` by repeated 300-second `504 Gateway Timeout` responses from `go.reg.darano.ir` for `google.golang.org/api` metadata. |
 | T009 | `DONE` | Add Gitea CI/CD configuration to GL. | Seven action/workflow YAML files parse successfully; the exact buildx action produced both GL OCI tags using the mandated proxy; committed as `675def5`. |
 | T010 | `DONE` | Commit outstanding workspace work and centralize root Markdown files in `dev-procfile` with root symlinks. | Pending work committed in DevOps (`665fd6b`), docs (`2c49a92`), Kuknos Node scripts (`c114c13`), and proto (`c778fda`); all eight root Markdown paths resolve through relative symlinks to tracked files in `dev-procfile`. |
+| T011 | `DONE` | Document commands for cloning the complete Darano workspace on another machine. | `README.md` now has copy-paste commands for all 12 repositories with configured origins, pins the current branches, recreates all eight root Markdown symlinks, and identifies `private-chain` as lacking a clone URL. |
 
 ## Phase 2 — `auth` architecture