Skip to content
Orbit Docs

Run QA Scripts

Orbit’s QA harness runs checks automatically after each prompt completes, so regressions surface immediately.

How it works

Section titled “How it works”
  1. Put per-project scripts in scripts/qa/*.mjs in the project.
  2. Universal, cross-project scripts run alongside them.
  3. After each completion, Orbit runs both and records one of five result states — pass, fail, flaky, skipped, or environment_error — into ~/.orbit/qa-results.db.
  4. A QA badge appears on the Pipeline (green, red, gray, or amber). When something fails, Flash can diagnose it on request.

From an AI client

Section titled “From an AI client”

orbit_run_script runs the full QA scope; orbit_get_qa_history and orbit_get_qa_results read the results.

A useful discipline

Section titled “A useful discipline”

When a bug recurs three or more times, add a QA stress test to the fix prompt so the harness catches it from then on.

Section titled “Related”