running-bug-review-boardlisted
Install: claude install-skill RayFernando1337/rayfernando-skills
# Running the Bug Review Board (BRB) QA pass
This skill runs a **real-user QA pass** on an app and feeds the output into a
Bug Review Board: a folder of structured bug reports, per-pass run reports,
and a final YES/NO sign-off the team can act on. It generalizes a
battle-tested workflow that already shipped phase QA on Mokuhoe — the
techniques are repo-agnostic.
## Why this exists
Most engineers test their own code. They confirm what they wrote works. That
misses the bugs **real users hit first** — stale state across flows, mobile
overflow, copy that lies, paths that 404 mid-onboarding, race conditions
between auth and routing.
This skill simulates a real user. The QA agent acts like a careful, mildly
unforgiving customer who does not read the source code.
## The trifecta — three hats, one pass
For every pass, wear all three hats:
- **Product Manager.** Confirm the build delivers the user-visible promise
documented in the product spec or phase doc. If it does not, that is a
product gap, not a bug — flag it in the run report.
- **QA.** Execute every scenario from a real user's perspective on the
primary supported viewport(s). Capture evidence (snapshot, console, server
data when relevant). Pass / Fail / Blocked.
- **Engineer.** Watch for invalidated assumptions: phase doc says "X uses
function Y" but Y was renamed; new client orchestration appeared in a flow
the docs say is server-driven; fields exist in UI that aren't in the
spec. **Finding gaps is the po