The docs give back the day-one lines the trim cut, the tutor becomes exercises on a +Tutor copy, the README builds the GUI and says what a terminal needs, and Shift-Esc says it needs the kitty keyboard protocol

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 5 insertions, 0 deletions

diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index d957ff94..a261a913 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -97,6 +97,11 @@ zig build cheatsheet       render the cheatsheet PDF (needs typst)
 - `zig build monkey -Dplatform=tty -- <seeds> [steps] [--from=N] [--out=DIR] [--keep]` writes one random script per seed and keeps any
   that panics; a seed always makes the same script. Each crash found gets a
   fix and a regression script in `test/snapshots/`.
+- The tutor's practice blocks (`# keys:`, `# before`, `# after` in
+  `src/tutor.txt`) are typed by hand; nothing runs them. What pins that
+  behaviour is `hxdiff`, which replays `test/hxcases` against goldens
+  recorded from a real helix, and `hxparity`, which runs each case in a
+  file pane and in a shell and demands they agree.
 - `zig build hxdiff -- --strict cases.jsonl reference.jsonl [waivers.jsonl]` runs custom differential cases. `docs/helix-keys.md`
   tracks helix parity key by key and names the reference helix build;
   `docs/selections.md` is the selection model under normal mode.