QAForge automates the complete QA lifecycle — from requirement analysis through test design, browser & API execution, defect tracking, to final reporting. One framework. One command. Zero manual test scripting.

⚡ Quick Start (30 seconds)

# Install globally
npm install -g qa-forge

# Create a demo project with sample data
qa-forge demo

# Launch the web dashboard
qa-forge dashboard

🎯 What It Does

| Stage | What Happens | Output | |-------|-------------|--------| | 0. Intake | Parse requirement documents | Structured goals, scope, constraints | | 1. Analysis | Break requirements into milestones | Milestone definitions with priorities | | 2. Planning | Design test strategy per milestone | Test plan with coverage matrix | | 3. Design | Generate test cases (browser + API) | Executable test case specifications | | 4. Env Check | Validate target URL, credentials, deps | Go/no-go signal | | 5. Defect Fix | Fix-and-retest loop for failures | Verified fixes with regression checks | | 6. Execution | Run Playwright tests (headed/headless) | Pass/fail results, screenshots, traces | | 7. Closure | Generate reports, close milestones | QA report with defect summary |

🛠️ CLI Commands

qa-forge init <name>       # Scaffold a new QA project
qa-forge validate          # Run preflight validation
qa-forge run <milestone>   # Execute tests (headless by default)
qa-forge status            # Show pipeline status
qa-forge report            # Generate test report
qa-forge dashboard         # Launch web dashboard
qa-forge encrypt           # Encrypt credentials file
qa-forge decrypt           # Decrypt credentials file
qa-forge demo              # Set up demo project

🔧 CI/CD Integration

# GitHub Actions example
- run: npm install -g qa-forge
- run: qa-forge validate
- run: qa-forge run M1
  env:
    QA_CI: 'true'
    QA_HEADLESS: 'true'
    QA_PASSPHRASE: ${{ secrets.QA_PASSPHRASE }}

Environment Variables:

| Variable | Effect | |----------|--------| | QA_HEADLESS=true | Run Playwright in headless mode | | QA_CI=true | JSON reporter, headless, screenshots on failure only | | QA_TIMEOUT=<ms> | Override test timeout (default: 90000) | | QA_RETRIES=<n> | Override retry count | | QA_PASSPHRASE=<str> | Passphrase for credential encryption |

🔒 Security

• AES-256-GCM encryption for credential files at rest
• PBKDF2 key derivation (100,000 iterations, SHA-512)
• Credentials decrypted only in memory during execution
• Input sanitization against template injection and path traversal

📊 Dashboard

Launch with qa-forge dashboard to get:

• Pipeline progress visualization (8-stage tracker)
• Milestone board with pass/fail rates
• Defect tracker with severity filtering
• Execution run history
• Auto-refresh every 10 seconds

🏗️ Architecture

qa-forge/
├── bin/qa-cli.js              # CLI entry point
├── dashboard/                 # Express server + SPA dashboard
├── lib/                       # Core libraries (crypto, sanitize, rate-limiter)
├── scripts/                   # Test execution engine
├── .claude/skills/            # 9 pipeline skill modules
├── .claude/hooks/             # State management & lifecycle hooks
├── tests/                     # 89+ automated tests
└── docs/                      # Landing page & documentation

🧪 Development

git clone https://github.com/ManSangApps/agentQA.git
cd agentQA
npm install
npm test          # Run 89 tests
npm run lint      # ESLint check
npm run format    # Prettier format

📄 License

MIT © ManSangApps