From 2bd3a896c27b1d8e3ad3dfeb0637eeac0ab62673 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sun, 19 Jul 2026 06:19:29 +0000
Subject: [PATCH] docs: note sibling rl-harness symlink needed for experiment
 smoke runs

Co-authored-by: Alex Vardakostas <Al-does@users.noreply.github.com>
---
 AGENTS.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 9ee1dd0..0cc5381 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -115,6 +115,13 @@ Notes below are only the non-obvious gotchas for this environment.
   `--smoke`.
 - Smoke/dev runs write throwaway outputs under the experiment leaf's
   `results/<run-id>/` and `artifacts/<run-id>/`; do not commit artifacts.
+- The experiment repo's editable dep is `rl-harness = { path = "../rl-harness"
+  }`, but the cloud checkout of this library is `RL-Harness` (Linux is
+  case-sensitive) and `bootstrap_local.sh` only auto-links `RL Harness` /
+  `rl-harness-src`. So before `uv sync`/smoke-testing from
+  `../alex-rl-experiments`, create the sibling link once (needs sudo since the
+  repos root is root-owned): `sudo ln -sfn RL-Harness <repos-parent>/rl-harness`.
+  The library's own `uv sync --group dev` needs no symlink.
 
 ### Verify changes