docs: pin atlas-ralph-loop (patched fork) as canonical over base ralph-loop

Spec §11.9 now shows /atlas-ralph-loop:ralph-loop as the canonical slash
command; §14b.9 records the mid-build pivot with rationale (eval-safer
parsing, richer promise matching via .claude/ralph-done + <promise>...
</promise>, cleaner stop-hook handshake). Plan's ship-check.py docstring
and d7 skeleton README updated to match. Base /ralph-loop:ralph-loop is
documented as fallback only.

Jobs-lens: fix-don't-cut repair of an outdated reference. No feature
removed; the pattern (loop wrapper + deterministic promise token) is
unchanged, only the preferred plugin-level implementation is clarified.

Author: claude

docs/superpowers/plans/2026-04-16-atlas-ai-prd-taskmaster-plugin-implementation.md

@@ -2015,7 +2015,7 @@ This directory is managed by @atlas-ai/prd-taskmaster. Files here layer on top o
 - `references/` — Captured reference heatmap
 - `debrief/` — Dogfood debriefs
 - `config/atlas.json` — Your workflow preferences (from customise-workflow skill)
-- `ship-check.py` — Deterministic completion check used by ralph-loop
+- `ship-check.py` — Deterministic completion check used by /atlas-ralph-loop:ralph-loop (Hayden's patched fork of /ralph-loop)
 
 ## Reset
 Delete this directory to start fresh. Backup first if you care about the state.
@@ -2096,7 +2096,9 @@ def test_ship_check_passes_on_all_gates_green(tmp_path, monkeypatch):
 ```python
 #!/usr/bin/env python3
 """Deterministic ship-check. Emits SHIP_CHECK_OK to stdout ONLY when all gates pass.
-Referenced by ralph-loop --completion-promise SHIP_CHECK_OK per spec §11.8."""
+Referenced by /atlas-ralph-loop:ralph-loop --completion-promise SHIP_CHECK_OK per spec §11.8.
+(atlas-ralph-loop is Hayden's patched+improved fork of /ralph-loop — prefer it; legacy
+/ralph-loop:ralph-loop remains fallback only.)"""
 from __future__ import annotations
 
 import json
@@ -2139,7 +2141,7 @@ def check() -> tuple[bool, list[str]]:
 
     # Gate 5: ralph-loop-prompt.md exists (per spec §11.9)
     if not (atlas / "ralph-loop-prompt.md").exists():
-        failures.append(".atlas-ai/ralph-loop-prompt.md missing (ralph-loop will fail with empty prompt)")
+        failures.append(".atlas-ai/ralph-loop-prompt.md missing (/atlas-ralph-loop:ralph-loop will fail with empty prompt)")
 
     return len(failures) == 0, failures
 

docs/superpowers/specs/2026-04-16-prd-taskmaster-plugin-design.md

@@ -898,16 +898,21 @@ Ralph-loop prompt instructs the AI: *"At end of each iteration, run `python3 .at
 
 ### 11.9 Shell-Escaping Mitigation
 
-The ralph-loop invocation CANNOT contain `()`, `!`, `$`, em-dash, smart quotes, or unicode. These break `eval` in ralph's plugin.
+The ralph-loop invocation CANNOT contain `()`, `!`, `$`, em-dash, smart quotes, or unicode. These break `eval` inside the plugin's setup shell script. The patched fork `atlas-ralph-loop` tightens some of these cases but the shape of the invocation must still be ASCII-only and flags-outside-quoted-prompt. Treat ASCII-only as the contract, not the implementation detail of any one plugin version.
 
 **Pattern:**
 ```bash
 # Invocation (short, ASCII-only):
-/ralph-loop:ralph-loop \
+/atlas-ralph-loop:ralph-loop \
   --max-iterations 100 \
   --completion-promise SHIP_CHECK_OK \
   "See .atlas-ai/ralph-loop-prompt.md"
 
+# NOTE: /atlas-ralph-loop is Hayden's patched+improved fork of /ralph-loop
+# (better eval safety, richer completion-promise matching, cleaner stop-hook
+# handshake). Prefer /atlas-ralph-loop:ralph-loop everywhere in the plugin —
+# the legacy /ralph-loop:ralph-loop remains a fallback only.
+
 # All detail lives in the file:
 .atlas-ai/ralph-loop-prompt.md
 ```
@@ -1175,7 +1180,17 @@ Our spec repeatedly says "CDD-native verification". For non-software domains (pe
 
 This is a framing change, not an implementation change. Makes the plugin's domain-agnostic claim actually hold.
 
-### 14b.9 (Reserved) — Additional updates discovered during implementation land here.
+### 14b.9 atlas-ralph-loop (patched fork) is canonical — not base ralph-loop
+
+**Caught mid-build**: initial spec §11.9 quoted the base `/ralph-loop:ralph-loop` slash command. During execution Hayden confirmed the patched fork `/atlas-ralph-loop:ralph-loop` is the canonical invocation for this project. The fork adds (a) eval-safer arg parsing, (b) richer completion-promise matching including `.claude/ralph-done` file fallback and `<promise>...</promise>` last-line discipline, (c) cleaner stop-hook handshake that avoids re-feeding prompts after explicit cancel.
+
+**Fix applied**: §11.9 updated in-place to show the `/atlas-ralph-loop:ralph-loop` invocation and name the fork; the plan's ship-check.py docstring updated to reference it by name; base `/ralph-loop:ralph-loop` remains documented as the fallback only.
+
+**Downstream docs to align on next touch**: the user-facing README and the `.atlas-ai/README.md` skeleton should say "Install the atlas-ralph-loop plugin for Mode C" and not "Install ralph-loop". Filenames stay put — `.atlas-ai/ralph-loop-prompt.md` is a file path inside our plugin's namespace and does not refer to the fork by name.
+
+**Jobs-lens read**: this is a fix-don't-cut repair of an outdated reference. No feature was removed; the pattern (loop wrapper with deterministic promise token) is unchanged, only the preferred plugin-level implementation is clarified.
+
+### 14b.10 (Reserved) — Additional updates discovered during implementation land here.
 
 ---