← ClaudeAtlas

ux-bug-huntlisted

PROJECT-SPECIFIC to usync (mcp-config-tui). Use when iterating on TUI UI/UX bugs via the Docker-first bug-hunt harness. Triggers: "UX bug hunt", "iterate on UI bugs", "fix UX issues", "expand the matrix", "ux-fake-prod", "matrix scenario", "TUI regression", "DM-P<n>". Drives the 4-stage loop (expand → run → triage → fix+lock) and the lens framework for catching UX defect classes beyond functional bugs.
nawodyaishan/universal-mcp-sync · ★ 5 · Web & Frontend · score 73
Install: claude install-skill nawodyaishan/universal-mcp-sync
# UX Bug-Hunt Iteration (usync / mcp-config-tui) > **Scope:** This skill is personalized to the `mcp-config-tui` repository. > Every file path below is **relative to the repo root** > (`/Users/nawodyaishan/Documents/GitHub/mcp-config-tui`). It will not work in > any other project — the harness, scenarios, and IDs are project-owned. The Docker-first UX harness (`make ux-fake-prod`) is a **bug-funnel**, not a one-shot. Treat each iteration as a disciplined 4-stage loop and never skip stage 3 (triage). --- ## 0. Required reading (read these before doing anything) ### Specs & protocol (authoritative intent) - `docs/specs/doctor-mode-phase12/ux-bug-hunt-protocol.md` — the protocol; Docker run is the authoritative collection mechanism - `docs/specs/doctor-mode-phase12/ux-flow-matrix.md` — scenario matrix; every row is a contract - `docs/specs/doctor-mode-phase12/spec.md` — Phase 12 product intent - `docs/specs/doctor-mode-phase12/plan.md` — implementation plan - `docs/specs/doctor-mode-phase12/tasks.md` — task breakdown - `docs/specs/doctor-mode-phase12/user-flow-audit.md` — audited journeys ### Harness source (the runtime) - `tests/ux-fake-prod/Dockerfile` — fake-prod container build - `tests/ux-fake-prod/docker-run.sh` — entrypoint invoked by `make ux-fake-prod` - `tests/ux-fake-prod/run-flow.sh` — in-container scenario driver - `.dockerignore` — keep this small; image hygiene affects determinism ### Test runners (the matrix) - `pkg/tui/dashboard_fake_prod_matrix_test.go`