ux-bug-huntlisted
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`