diff --git a/docs/port/HANDOFF.md b/docs/port/HANDOFF.md
index 5349822a..06db8811 100644
--- a/docs/port/HANDOFF.md
+++ b/docs/port/HANDOFF.md
@@ -1996,7 +1996,12 @@ discovered it after re-exporting. ❔ The sweeps may simply be a small term, and
   this element to the visibly wrong answer, so it and a decision about
   plateau-less elements have to land together, and neither half has a capture to
   verify against.
-  **Default unchanged**, experiment reachable via `SYLPHEED_KF_TIME_SHIFT=1`.
+  **Default unchanged**, experiment reachable via `SYLPHEED_KF_TIME_LEGACY=1`.
+  ⚠️ **This line said `SYLPHEED_KF_TIME_SHIFT=1` until 2026-08-30** — a variable
+  removed with the record-layout fix. Setting it does nothing and yields the
+  default, so the instruction would have produced a clean, wrong confirmation
+  rather than an error. `SYLPHEED_KF_TIME_LEGACY=1` is the live gate
+  (`ui_layout.rs:595`).
   **What this means for you:** the interpolation *law* is settled (linear, 2
   units/frame); a multi-keyframe group's *timing* is not — do not expect a
   2-frame hold where the game holds 83.
diff --git a/docs/re/structures/ui-resting-pose.md b/docs/re/structures/ui-resting-pose.md
index 7c06ada8..b431b25e 100644
--- a/docs/re/structures/ui-resting-pose.md
+++ b/docs/re/structures/ui-resting-pose.md
@@ -609,7 +609,7 @@ end of that movement the indexing lands on:
 | | returned "rest pose" |
 |---|---|
 | as decoded | `(108,72) 0%,0% a=0` — invisible |
-| with `SYLPHEED_KF_TIME_SHIFT=1` | `(108,72) 200%,200% a=255` — the peak |
+| with `SYLPHEED_KF_TIME_LEGACY=1` ⚠️ | `(108,72) 200%,200% a=255` — the peak |
 
 An 896×389 sprite at 200 % scale is 1792×778 — larger than the screen. Painting
 it permanently is what made build 7's render 13.1 % different and 4.9 luminance
@@ -1189,3 +1189,12 @@ rests.
 keyframe timing now supports ([time unit](../ui-keyframe-time-unit.md)). Use a
 static composite for the title, main menu and `EXTRAS`, where the screen does
 settle and `rest_plateau` is measurably right.
+
+
+⚠️ **The row above said `SYLPHEED_KF_TIME_SHIFT=1` until 2026-08-30.** That gate
+was removed with the record-layout fix and reading it back would have set an inert
+variable, produced the DEFAULT row, and let a reader conclude the two readings
+agree — a stale instruction inside a results table, which is the form that
+manufactures evidence rather than merely misleading. The live equivalent is
+`SYLPHEED_KF_TIME_LEGACY=1`, read in `ui_layout.rs:595` (the parser itself, not
+only the tests, so it does reach `screen info` and `screen render`).
\ No newline at end of file