QAOS — Quality Assurance Operating System

Enterprise-grade, engine-agnostic QA platform. Not a test framework. Not a test repository.

QAOS is an operating system for Quality Assurance:

• Documentation Driven — blueprint and specifications are the contract.
• Test Case First — test cases are the source of truth; automation is generated from them.
• AI Native — ten specialized AI agents collaborate on QA work.
• Multi Product / Multi Engine — one platform, unlimited products, unlimited automation engines.
• Engine Agnostic — never coupled to Selenium, Playwright, Cypress, Appium, or any vendor technology.

Requirement → PRD → FSD → Scenario → Test Case → Automation → Execution → Report

If a requirement changes, the test case changes first. Automation is regenerated.

Repository Structure

qaos/
  blueprint/        Architecture, principles, conventions, roadmap, governance
  specifications/   Contracts every artifact must obey
  knowledge/        Reusable, cross-project engineering knowledge
  agents/           AI agent definitions and system prompts
  templates/        Test case, page object, project scaffolding
  framework/        Engine-agnostic core (Python package)
  packages/         Optional shared packages
  adapters/         Engine adapters (Selenium, Playwright, REST, ...)
  cli/              qaos command-line interface
  docs/             User documentation
  examples/         Reference product integration
  docker/           Container definitions
  scripts/          Maintenance scripts
  integrations/     CI/CD platform integrations

Quick Start

pip install qaos-agent      # install qaos CLI from PyPI
# or, isolated without global install:
pipx install qaos-agent

qaos doctor                 # verify platform health
qaos init my-product        # scaffold a new product workspace
qaos validate my-product    # validate test cases against specifications
qaos generate my-product    # emit pytest automation + page objects
qaos review my-product      # quality gates on locators and page code
qaos run my-product         # execute automation (--engine selenium|playwright|rest)
qaos report my-product      # generate reports
qaos migrate my-product --engine selenium   # switch primary engine
qaos explore my-product --prompt "testing pada login"   # AI: prompt -> test case
qaos analyze my-product     # failure analysis + flaky intelligence

Contributors / local dev: clone the repo and run pip install -e ".[dev]" instead.

See docs/quickstart.md (complete usage guide) and the canonical blueprint.

License

MIT. See LICENSE.