QA checklist¶
Run the checks before a public publish.
Build gates¶
-
npm run typecheckpasses. -
npm testpasses. -
npm run lintpasses. -
npm run buildpasses. - The no-
useEffectcheck passes. - The Whisper worker bundle check passes.
-
npm run docs:buildpasses with--strict. -
git diff --checkpasses.
Browser gates¶
Check the app at 320, 360, 768, 1024, and 1280 CSS pixels.
- No horizontal overflow exists.
- The onboarding form is readable.
- A quest can show details without starting an attempt.
- The mission panel changes when a different quest is selected.
- The response form appears only after Begin teach-back.
- Busy buttons show a clear state and block duplicates.
- Keyboard focus is visible.
- Reduced motion does not remove meaning.
- The console has no new errors.
- Live and replay labels remain honest.
Documentation gates¶
-
docs/index.htmlloads from CloudFront. - Search returns a result.
- Internal links do not leave the docs prefix.
- The app link opens Orion.
- Provider names and modes match the deployed configuration.
- No secret, token, raw audio, or private learner data appears.
Evidence rule¶
A replay result proves a user journey. It does not prove a live AWS, CockroachDB, MCP, or OpenRouter integration. Record the mode and commit for each screenshot.