docs(reconcile): main-lags-master foot-gun is RESOLVED, not live

The refine brief predated the 2026-06-09 branch fix. main==master now and
main is canonical, so "git checkout master after cloning" is stale/backwards.
Reframe README + USER_GUIDE + OVERVIEW to "main is canonical & synced; fresh
clone works as-is; ImportError = stale clone, git checkout main".

README.md

@@ -35,9 +35,7 @@ This repository is the **"paper of the project"** — it is the methodology / re
 ## Install
 
 ```bash
-# If cloning fresh from HF: `git checkout master` first — the Hub `main`
-# branch LAGS `master`, and installing from `main` ImportErrors on
-# make_dr_grpo_config. (See docs/HF_REPO_LAYOUT.md + docs/TROUBLESHOOTING.md.)
+# `main` is canonical and synced with `master` — a fresh clone works as-is.
 pip install -e .
 python examples/qwen_05b_quickstart/run.py
 ```

docs/OVERVIEW.md

@@ -72,9 +72,10 @@ for known foot-guns.
 
 ## Foot-guns worth knowing on day one
 
-- **HF `main` lags `master`.** After cloning from the Hub, `git checkout master` (or pin a
-  master SHA) before `pip install -e .`, or you `ImportError` on `make_dr_grpo_config`. Same
-  for any Modal / HF-Jobs clone-and-install step.
+- **Branch sync (resolved 2026-06-09).** `main` is canonical and kept in sync with `master`,
+  so a fresh Hub clone of `main` installs the complete tree. If you ever `ImportError` on
+  `make_dr_grpo_config`, your clone is stale (`git fetch && git checkout main`). Historically
+  `main` lagged `master`; that's fixed as long as both stay synced.
 - **`strip_thinking` × SDPO.** On real agent traces, SDPO requires `strip_thinking=False`:
   ~67% of error-recovery turns are pure thinking, so stripping them yields empty SDPO masks.
 - **KL estimator delta.** TRL uses the **k3** estimator; Composer's report describes **k1**.

docs/USER_GUIDE.md

@@ -59,16 +59,15 @@ Always start with the core install:
 ```bash
 git clone https://huggingface.co/Codeseys/composer-replication-framework
 cd composer-replication-framework
-git checkout master   # HF 'main' LAGS 'master'; without this you ImportError on make_dr_grpo_config
 pip install -e .
 ```
 
-> **Branch foot-gun.** The HF Hub `main` branch lags `master`. Always
-> `git checkout master` (or pin a known-good master SHA) before `pip install -e .`
-> — otherwise newer symbols such as `make_dr_grpo_config` / `make_po_config`
-> are missing and you hit an `ImportError`. The same applies to any Modal /
-> HF-Jobs clone-and-install step. See [`docs/TROUBLESHOOTING.md`](TROUBLESHOOTING.md)
-> and [`docs/HF_REPO_LAYOUT.md`](HF_REPO_LAYOUT.md).
+> **Branch note (resolved 2026-06-09).** `main` is the canonical branch and is kept in
+> sync with `master` (`main == master`). A fresh clone of `main` has the complete tree
+> (incl. `make_dr_grpo_config` / `make_po_config`), so no branch switch is needed.
+> Historically `main` lagged `master` — if you ever see an `ImportError` on those symbols,
+> the clone is stale; `git fetch && git checkout main` (or pin a current SHA) fixes it.
+> See [`docs/HF_REPO_LAYOUT.md`](HF_REPO_LAYOUT.md).
 
 That gets you `torch>=2.0` + `transformers>=4.46` and is enough for the
 verification harness on CPU (sections 3, 5, 6).