docs: stage browser alias + UX backlog (P0–P2)

WORKFLOW.md

@@ -62,6 +62,19 @@ IFT smoke Admin UI (живой API после деплоя): `npm run test:e2e:i
 
 Окружение: **WSL + asdf**. PowerShell/Windows — только IDE; сборка и тесты — в WSL.
 
+### Shell для Agent (обязательно)
+
+PowerShell в Cursor **ломает экранирование** (кавычки, `$`, JSON, heredoc, вложенный `bash -lc "..."`).
+
+| Нельзя | Нужно |
+|--------|--------|
+| Сложные one-liner’ы в PowerShell | Файл `.sh` + `wsl -e bash /mnt/c/.../script.sh` |
+| `wsl -e bash -lc "…\"…\"…"` | `wsl -e bash -lc 'cd … && cmd'` (снаружи `'…'`) |
+| Windows `npm` / `erl` / `rebar3` | npm и rebar **только в WSL** |
+| Push Front без локальной проверки | WSL: `npm run lint && npm run build && npm run test:e2e:ift`, потом push |
+
+Канон для агентов: `EventHubBack/.cursor/rules/shell-wsl-not-powershell.mdc`.
+
 | Tool | Version | Path (WSL) |
 |------|---------|------------|
 | Erlang/OTP | **28.2** | `/home/alexc/.asdf/installs/erlang/28.2/bin` |
@@ -260,6 +273,15 @@ IFT и stage крутят **одну и ту же** сборку `sha-*`. Produc
 - **IFT smoke:** после успешного Deploy IFT — workflow `e2e-ift.yml` → `npm run test:e2e:ift` (без моков). Учётки с хоста IFT: `/opt/eventhub-ift/.env` (`SMOKE_ADMIN_*` → `ADMIN_SUPER_*`).
 - Селекторы: `data-testid` + a11y; контракт в `EventHubFrontAdmin/e2e/TESTIDS.md`.
 
+### Stage UI в Cursor Browser
+
+`*.eventhub.local` часто не резолвится в Chromium/Cursor IDE Browser (mDNS). Для ручного и агентского просмотра stage:
+
+- URL: `http://ui.stage.eventhub.test:8787`
+- Инструкция + proxy: **`STAGE-BROWSER.md`**, скрипт `scripts/stage-browser-alias-proxy.mjs` (Windows Node на `:8787`)
+- Hosts: `127.0.0.1 ui.stage.eventhub.test`
+- Учётки smoke: `~/.cursor/secrets/eventhub-stage.env` (не коммитить)
+
 ---
 
 ## 7. Нагрузочное тестирование IFT (Tsung)
@@ -354,6 +376,8 @@ error rate > 1% **или** mean request > 500 ms (hold ≥2 мин в фазе)
 
 | Дата | Изменение |
 |------|-----------|
+| 2026-07-22 | §6: Stage UI в Cursor Browser — `STAGE-BROWSER.md` + alias proxy |
+| 2026-07-22 | §2.1: Agent shell — не PowerShell для сложного; `.sh` + WSL; Front push только после lint/build/IFT |
 | 2026-07-15 | §7: анализ через EventHub `/metrics` + admin `nodes/metrics`; compose Prom опционален |
 | 2026-07-15 | §7: cleanup дампов на IFT + мониторинг в анализе; KEEP_OBSERVABILITY |
 | 2026-07-15 | §7: сбор и анализ логов — обязательный gate после stress |