QA Architect

Quality automation CLI for JavaScript/TypeScript and Python projects. One command adds ESLint, Prettier, Husky, lint-staged, and GitHub Actions. Pro tiers add security scanning (Gitleaks), Smart Test Strategy, and multi-language support.

This repo = the free CLI. For the Pro dashboard with repo analytics, CI integration, and automation workflows, see QA Architect Pro (included in VBL Starter Kit).

Maintainer & Ownership This project is maintained by Vibe Build Lab LLC, a studio focused on AI-assisted product development, micro-SaaS, and "vibe coding" workflows for solo founders and small teams. Learn more at https://www.vibebuildlab.com.

Features

• Prettier Code Formatting - Consistent code style across your project
• Husky Git Hooks - Pre-commit (lint-staged) and pre-push (validation)
• lint-staged Processing - Only process changed files for speed
• Pre-push Validation - Prevents broken code from reaching CI
• GitHub Actions - Automated quality checks in CI/CD
• TypeScript Smart - Auto-detects and configures TypeScript projects
• Python Support - Complete Python toolchain with Black, Ruff, isort, mypy, pytest
• Security Automation - npm audit (Free), Gitleaks + ESLint security (Pro)
• Progressive Quality - Adaptive checks based on project maturity
• Smart Test Strategy - Risk-based pre-push validation (Pro feature)

Target Users

• Developers who want quality automation without manual setup
• Teams standardizing code quality across multiple projects
• Open source maintainers enforcing contribution standards
• Agencies shipping consistent quality across client projects

Demo / Live Links

# Try it on any project
npx create-qa-architect@latest

Pricing

| Tier | Price | What You Get | | -------------- | ------------------------- | -------------------------------------------------------------------------------------------------- | | Free | $0 | CLI tool, basic linting/formatting, npm audit (capped: 1 private repo, 50 runs/mo) | | Pro | $59/mo or $590/yr | Security scanning (Gitleaks + ESLint security), Smart Test Strategy, multi-language, unlimited | | Team | $15/user/mo (5-seat min) | + RBAC, Slack alerts, multi-repo dashboard, team audit log | | Enterprise | $249/mo + $499 onboarding | + SSO/SAML, custom policies, compliance pack, dedicated TAM |

Pro included in VBL Starter Kit — Team/Enterprise are standalone purchases.

Security Features by Tier

| Feature | Free | Pro+ | | --------------------------- | ---- | ---- | | npm audit (basic) | ✅ | ✅ | | Gitleaks (secrets scanning) | ❌ | ✅ | | ESLint security rules | ❌ | ✅ |

License

Commercial License (freemium) — free tier covers the basic CLI; Pro/Team/Enterprise features require a paid subscription. See LICENSE.

Tech Stack

| Component | Technology | | --------------- | -------------------------------------------------- | | Runtime | Node.js 20+ | | Linting | ESLint 9 (flat config) | | Formatting | Prettier 3 | | CSS Linting | Stylelint 16 | | Git Hooks | Husky 9 + lint-staged 15 | | Python | Black, Ruff, mypy, pytest | | Performance | Lighthouse CI | | Security | npm audit (Free), Gitleaks + ESLint security (Pro) |

Getting Started

Prerequisites

• Node.js 20 or higher
• npm 10+ (installed automatically with Node 20)
• Git repository (required for hooks)

Quick Start

# Navigate to your project
cd your-project/

# Bootstrap quality automation
npx create-qa-architect@latest

# Install new dependencies
npm install

# Set up pre-commit hooks
npm run prepare

Update Existing Setup

npx create-qa-architect@latest --update
npm install
npm run lint

Dependency Monitoring (Free)

npx create-qa-architect@latest --deps

Usage Examples

Check Project Maturity

npx create-qa-architect@latest --check-maturity

Output:

Project Maturity Report

Maturity Level: Development
Description: Active development - has source files and tests

Quality Checks:
  Required: prettier, eslint, stylelint, tests
  Optional: security-audit
  Disabled: coverage, documentation

Security Validation

# Check configuration security
npx create-qa-architect@latest --security-config

# Validate documentation
npx create-qa-architect@latest --validate-docs

# Comprehensive validation
npx create-qa-architect@latest --comprehensive

Custom Templates

# Use organization-specific standards
npx create-qa-architect@latest --template ./my-org-templates

What Gets Added

your-project/
├── .github/
│   └── workflows/
│       └── quality.yml          # GitHub Actions workflow
├── .husky/                      # Pre-commit hooks
├── .editorconfig                # Editor defaults
├── .eslintignore                # ESLint ignore patterns
├── .lighthouserc.js             # Lighthouse CI config
├── .npmrc                       # npm configuration
├── .nvmrc                       # Node version pinning
├── .prettierrc                  # Prettier configuration
├── .stylelintrc.json            # Stylelint rules
├── eslint.config.cjs            # ESLint flat config
└── package.json                 # Updated scripts

Available Scripts (After Setup)

npm run format              # Format all files
npm run format:check        # Check formatting (CI)
npm run lint                # ESLint + Stylelint
npm run lint:fix            # Auto-fix linting
npm run security:audit      # Vulnerability check
npm run security:secrets    # Scan for secrets
npm run validate:pre-push   # Pre-push validation

Roadmap

• [x] ESLint 9 flat config support
• [x] Progressive quality (maturity detection)
• [x] Python toolchain support
• [x] Smart test strategy (Pro)
• [x] Monorepo support (Nx, Turborepo, Lerna, Rush, npm/pnpm/yarn workspaces)
• [ ] Rust and Go support
• [ ] VS Code extension

Contributing

Want to improve this tool?

1. Fork the repository
2. Make your changes
3. Test with a sample project
4. Submit a pull request

See CONTRIBUTING.md for guidelines.

Support

1. Review GitHub Actions logs
2. Open an issue in this repository

License

Commercial freemium license — the base CLI is free to use; Pro/Team/Enterprise features require a paid subscription. See LICENSE for details.

Legal

• Privacy Policy
• Terms of Service

Vibe Build Lab LLC · vibebuildlab.com