[pinklightultra]

The README is now the document a writer uses to capture SmartClient UI figures, and the document a reviewer can check against the code.

What changed

• Opens with who the kit is for (a writer producing release figures from a shared environment) and the two controls that ship on: the click guard, and safeShot() as the only path that writes a PNG.
• Walks the three failures that look like a finished run. Each one names the file that handles it and stops at what that file actually does. Reference-stop is opt-in. waitForIsc() does not throw when a post-condition never appears. The shipped modules do not call runBeat().
• Gives the install, capture, diff, and annotate procedures, including exit codes, where files land, and which flags change behavior.
• Points proof at scripts/smoke-test.js and .github/workflows/ci.yml: what the smoke job runs, and the assertions in the test. The click-strategy timings stay attributed to the one run recorded in lib/nav.js, with bench-results.json gitignored.
• Drops the terminology glossary and the sample transcript. That transcript's step counts are not what modules/login.js and modules/admin.js emit, and nav.goto is not a function. The REPL example now calls iscNav.navigatePath().

Noted in the doc, not fixed here

modules/home.js passes a toolbar crop as { x, y, width, height }. lib/redact.js reads left and top, so that crop arithmetic is NaN and the bounds check does not raise RedactionError. The README tells the writer not to treat home-toolbar.png as a figure the module produces.