Skip to content

QA checklist

Run the checks before a public publish.

Build gates

  • npm run typecheck passes.
  • npm test passes.
  • npm run lint passes.
  • npm run build passes.
  • The no-useEffect check passes.
  • The Whisper worker bundle check passes.
  • npm run docs:build passes with --strict.
  • git diff --check passes.

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.html loads 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.