Quality of Life (QoL) pass

Check one section of the product (a tab, a flow, a group of pages) for the small problems users notice, judge it against written standards (the bar), and hand back one numbered list of findings. Build nothing before the person picks. One section per pass keeps the list short enough to decide on and the pull request small enough to review.

Talk to the person in short, plain sentences. Every finding has a recommended fix; where there is a real choice, give 2 or 3 options with your pick first.

0. The bar (first run, or setup)

If the repo has no qol-pass config (.qol-pass/config.json, or ~/.claude/qol-pass/<repo>/config.json, where <repo> is the repo's name on GitHub, not its folder name), or $ARGUMENTS is setup, follow references/setup.md. It finds the team's own standards or drafts a QUALITY.md from what the code already does, and the person approves it. Stop there if the argument was setup.

Read the bar files the config names before every pass. A team's own standards always win over references/default-quality.md.