| name | zupulse-web-debug |
| description | Start or reuse the Zupulse Browser demo (apps/web-demo on http://127.0.0.1:5173) and drive it for manual UI verification, bug reproduction, and UX audits. Use when a task requires opening the local web demo, exercising Library/Viewer/Studio in Chromium, checking IndexedDB persistence or refresh recovery, taking screenshots at desktop or narrow viewports, or Browser-only import/drag-drop behavior. Do not use for Desktop Electron, PDF OMR, unit tests, or journeys already covered by pnpm demo:test:e2e unless investigating a failure those tests do not cover. |
Zupulse Web Debug
All paths below are relative to the repository root unless absolute.
Host facts (demo:dev, locale, IndexedDB, file import, viewports): apps/web-demo/AGENTS.md.
Locators and deterministic journeys: apps/web-demo/e2e/library.spec.ts.
Product behavior: docs/features/contracts/ (not this skill).
Desktop Electron: zupulse-desktop-debug — do not merge the two skills.
When not to use
- Desktop shell, native dialogs, SQLite, recognition engines, or PDF OMR (Browser has no
#/pdf-omr).
- Unit tests or
pnpm demo:test:e2e journeys that already assert the same outcome.
- Reading code or Feature Contracts without driving the running app.
If a playbook's steps become stable assertions, add them to e2e/library.spec.ts and leave a one-line pointer here.
Driving modes
- Playwright driver (default for repro / screenshots / IndexedDB). Same JSON
cmd.mjs pattern as desktop-debug; Chromium profile under the workdir.
- In-app browser tools (light walkthrough). When the environment already exposes a browser against
http://127.0.0.1:5173, reuse pnpm demo:dev and exercise the journey there. Still follow for locale, clean session, and viewports. Prefer the driver when you need , , , , or durable under .
