ai-qa-framework

library2.11.10jsnpmunverified

Universal AI QA automation framework that installs a Senior QA Engineer agent (Rayan) into AI assistants like Claude Code, Cursor, and Copilot. Version 2.11.10 (stable, actively maintained) requires Node.js >=18. Automatically detects project stack (React, Angular, Vue, .NET, Node, Python), generates Playwright E2E tests from user stories, executes them, fixes failures, and produces professional QA reports in Arabic (configurable). Key differentiator: project-agnostic, covers full QA lifecycle from story analysis to report generation, not just test execution.

testing

npm install ai-qa-framework

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AI-QA-FRAMEWORK

ai-qa-framework

testingjavascriptv2.11.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installs the AI QA Framework, activates the Rayan agent, and runs full QA on a user story file.

npx ai-qa-framework install # Activate in Claude Code: type /aiqa-help # Activate in Cursor/Copilot/Windsurf: load ./ai-qa-framework/agents/qae.md # Run full QA on a user story: /aiqa-fullworkflow docs/stories/1-1-login-feature.md

Debug

Known issues

gotchaRequires Node.js >=18.0.0; older versions cause cryptic errors during installation.

fix

Upgrade Node.js to a version >=18.0.0.

affects: <18.0.0

gotchaThe default QA report language is Arabic. Configuration change needed for other languages.

fix

Edit config.yaml to set 'language: en' or desired language.

affects: >=2.0.0

gotchaPlaywright must be installed globally or in the project; framework does not auto-install it.

fix

Run 'npx playwright install' after setup if not already present.

affects: >=2.0.0

Errors

Common errors & fixes

Error: Cannot find module '@playwright/test'

Playwright not installed or not in node_modules.

fix

Run 'npm install -D @playwright/test' or 'npx playwright install'.

Upgrade

Version history

2.11.10latest on npm

Audit

Dependencies

playwrightrequiredE2E test execution engine

Agent activity

63 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/afmelwekeel/AI-QA-Framework ↗

packageai-qa-framework ↗

homepagehttps://github.com/afmelwekeel/AI-QA-Framework#readme ↗