diff --git a/CLAUDE.md b/CLAUDE.md
index c01ac63..9427136 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -66,9 +66,16 @@ acting on one.
   `~/.local/share/Balatro/Mods/JokerComboAdvisor -> ~/Documents/JokerComboAdvisor`
   (this repo). Edits here go live on next game launch — do not copy files anywhere.
   Lovely reads that folder as `C:\users\steamuser\AppData\Roaming\Balatro\Mods`.
-- Game: Steam/Proton at `~/.local/share/Steam/steamapps/common/Balatro`. Lovely
-  injector + Steamodded 1.0.0-beta are already installed; mods are managed via
-  Balatro Mod Manager.
+  The link used to point at the repo's pre-rename home (`~/Documents/Balatro Mod`);
+  when that path died the loader silently skipped the mod — **if the game boots
+  with no JCA in the log at all, check this symlink first.** A disabled-in-BMM
+  mod looks the same way (SMODS drops a `.lovelyignore` file into the mod folder
+  to disable it — never create one at the repo root).
+- Game: Steam/Proton, installed in the `/mnt/games/Steam` library (not the
+  default one — its save prefix is
+  `/mnt/games/Steam/steamapps/compatdata/2379780/pfx/.../Roaming/Balatro`).
+  Lovely injector + Steamodded 1.0.0-beta are already installed; mods are
+  managed via Balatro Mod Manager.
 - Crash/load logs: `~/.local/share/Balatro/Mods/lovely/log/` (newest file).
 - Remote: `https://git.aleshym.co/funman300/JokerComboAdvisor` (private, user's
   Gitea). `git push` just works: it authenticates through the global libsecret
@@ -246,7 +253,9 @@ pipeline, a real overlay `UIBox` — with no clicking:
 
 It boots the game, runs `scenarios/JokerComboAdvisor.lua`, quits, and prints a
 pass/fail report (non-zero exit on failure). Close Balatro first; it needs a clean
-boot. Scenarios live in the harness repo, not here.
+boot. Scenarios live in the harness repo, not here. If `~/Documents/BalatroSmoke`
+is missing, clone it: `git clone https://git.aleshym.co/funman300/BalatroSmoke.git
+~/Documents/BalatroSmoke` and symlink it into the Mods folder like any mod.
 
 It covers the surfaces this repo's tests cannot reach: the hover tooltip naming a
 partner, the clash and caution lines, discovery on emplace, and — the reason it