{"id":45995219,"url":"https://github.com/buildproven/qa-architect","last_synced_at":"2026-05-07T03:05:29.109Z","repository":{"id":316153738,"uuid":"1056676407","full_name":"buildproven/qa-architect","owner":"buildproven","description":"QA Architect – open-source quality automation starter (CLI + templates). Pairs with QA Architect Pro dashboard.","archived":false,"fork":false,"pushed_at":"2026-03-22T00:44:29.000Z","size":9536,"stargazers_count":1,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-22T14:59:10.795Z","etag":null,"topics":["automation","bootstrap","cli","eslint","github-actions","husky","lint-staged","npm-package","prettier","quality","scaffold","stylelint","template","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/brettstark73/create-quality-automation#readme","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/buildproven.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-14T15:28:18.000Z","updated_at":"2026-03-22T00:44:32.000Z","dependencies_parsed_at":"2026-03-21T19:06:12.927Z","dependency_job_id":null,"html_url":"https://github.com/buildproven/qa-architect","commit_stats":null,"previous_names":["brettstark73/quality-automation-template","brettstark73/create-quality-automation","vibebuildlab/qa-architect","buildproven/qa-architect"],"tags_count":63,"template":false,"template_full_name":null,"purl":"pkg:github/buildproven/qa-architect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildproven%2Fqa-architect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildproven%2Fqa-architect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildproven%2Fqa-architect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildproven%2Fqa-architect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/buildproven","download_url":"https://codeload.github.com/buildproven/qa-architect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildproven%2Fqa-architect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31333229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T03:20:36.090Z","status":"ssl_error","status_checked_at":"2026-04-03T03:20:35.133Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bootstrap","cli","eslint","github-actions","husky","lint-staged","npm-package","prettier","quality","scaffold","stylelint","template","typescript"],"created_at":"2026-02-28T21:02:19.529Z","updated_at":"2026-04-03T04:02:11.609Z","avatar_url":"https://github.com/buildproven.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QA Architect\n\nQuality automation CLI for JavaScript/TypeScript, Python, and shell script 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.\n\n**This repo = the free CLI.** For the Pro dashboard with repo analytics, CI integration, and automation workflows, see [QA Architect Pro](https://buildproven.ai/qa-architect) (included in BuildProven Starter Kit).\n\n---\n\n\u003e **Maintainer \u0026 Ownership**\n\u003e This project is maintained by **BuildProven**, a studio focused on AI-assisted product development, micro-SaaS, and \"vibe coding\" workflows for solo founders and small teams.\n\u003e Learn more at **https://buildproven.ai**.\n\n---\n\n## Features\n\n- **Prettier Code Formatting** - Consistent code style across your project\n- **Husky Git Hooks** - Pre-commit (lint + format) and pre-push (type check + tests)\n- **lint-staged Processing** - Only process staged files for speed\n- **Delta Testing** - Pre-push runs tests on changed files only (fast feedback)\n- **GitHub Actions** - Automated quality checks in CI/CD\n- **TypeScript Smart** - Auto-detects and configures TypeScript projects\n- **Python Support** - Complete Python toolchain with Black, Ruff, isort, mypy, pytest\n- **Shell Script Support** - ShellCheck linting, syntax validation, permissions checks, best practices\n- **Security Automation** - npm audit (Free), Gitleaks + ESLint security (Pro)\n- **Progressive Quality** - Adaptive checks based on project maturity\n- **Smart Test Strategy** - Risk-based pre-push validation (Pro feature)\n\n### Quality Tools\n\n- **Lighthouse CI** - Performance, accessibility, SEO audits (Free: basic, Pro: thresholds)\n- **Bundle Size Limits** - Enforce bundle budgets with size-limit (Pro)\n- **axe-core Accessibility** - WCAG compliance testing scaffolding (Free)\n- **Conventional Commits** - commitlint with commit-msg hook (Free)\n- **Coverage Thresholds** - Enforce code coverage minimums (Pro)\n\n### Pre-Launch Validation\n\n- **SEO Validation** - Sitemap, robots.txt, meta tags validation (Free)\n- **Link Validation** - Broken link detection with linkinator (Free)\n- **Accessibility Audit** - WCAG 2.1 AA compliance with pa11y-ci (Free)\n- **Documentation Check** - README completeness, required sections (Free)\n- **Env Vars Audit** - Validate .env.example against code usage (Pro)\n\n## Target Users\n\n- **Developers** who want quality automation without manual setup\n- **Teams** standardizing code quality across multiple projects\n- **Open source maintainers** enforcing contribution standards\n- **Agencies** shipping consistent quality across client projects\n\n## Demo / Live Links\n\n```bash\n# Try it on any project\nnpx create-qa-architect@latest\n```\n\n## Pricing\n\n| Tier     | Price             | What You Get                                                                                       |\n| -------- | ----------------- | -------------------------------------------------------------------------------------------------- |\n| **Free** | $0                | CLI tool, basic linting/formatting, npm audit (capped: 1 private repo, 50 runs/mo)                 |\n| **Pro**  | $49/mo or $490/yr | **Security scanning (Gitleaks + ESLint security)**, Smart Test Strategy, multi-language, unlimited |\n\n\u003e **Pro included in [BuildProven Starter Kit](https://buildproven.ai/starter-kit)**\n\n### Security Features by Tier\n\n| Feature                     | Free | Pro+ |\n| --------------------------- | ---- | ---- |\n| npm audit (basic)           | ✅   | ✅   |\n| Gitleaks (secrets scanning) | ❌   | ✅   |\n| ESLint security rules       | ❌   | ✅   |\n\n### Quality Tools by Tier\n\n| Feature                      | Free | Pro+ |\n| ---------------------------- | ---- | ---- |\n| Lighthouse CI (basic scores) | ✅   | ✅   |\n| Lighthouse thresholds        | ❌   | ✅   |\n| axe-core accessibility       | ✅   | ✅   |\n| Conventional commits         | ✅   | ✅   |\n| Bundle size limits           | ❌   | ✅   |\n| Coverage thresholds          | ❌   | ✅   |\n\n### Pre-Launch Validation by Tier\n\n| Feature             | Free | Pro+ |\n| ------------------- | ---- | ---- |\n| SEO validation      | ✅   | ✅   |\n| Link validation     | ✅   | ✅   |\n| Accessibility audit | ✅   | ✅   |\n| Documentation check | ✅   | ✅   |\n| Env vars audit      | ❌   | ✅   |\n\n### CI/CD Optimization by Tier\n\n| Feature                      | Free | Pro+ |\n| ---------------------------- | ---- | ---- |\n| GitHub Actions cost analyzer | ❌   | ✅   |\n\n### Get Pro\n\n**Purchase:** [buildproven.ai/qa-architect](https://buildproven.ai/qa-architect)\n\nAfter purchase, you'll receive a license key via email (QAA-XXXX-XXXX-XXXX-XXXX).\n\n**Activate your license:**\n\n```bash\nnpx create-qa-architect@latest --activate-license\n# Enter your license key when prompted\n```\n\n**Check license status:**\n\n```bash\nnpx create-qa-architect@latest --license-status\n```\n\n## Workflow Tiers (GitHub Actions Cost Optimization)\n\nqa-architect follows industry best practice: **\"Fail fast locally, verify comprehensively remotely\"**\n\n### The Testing Pyramid\n\n| Layer          | Time     | What Runs                          | Why                        |\n| -------------- | -------- | ---------------------------------- | -------------------------- |\n| **Pre-commit** | \u003c 5s     | Lint + format (staged files)       | Instant feedback           |\n| **Pre-push**   | \u003c 30s    | Type check + tests (changed files) | Catches bugs before push   |\n| **CI**         | 3-10 min | Full test suite + security         | Comprehensive verification |\n\nNote: CI does NOT re-run lint/format (pre-commit already did it). This avoids redundant work and reduces CI costs.\n\n### Workflow Tiers (GitHub Actions Cost)\n\nqa-architect defaults to **minimal CI** to avoid unexpected GitHub Actions bills. Choose the tier that matches your needs:\n\n### Minimal (Default) - Budget-First (\u003c1000 min/month target)\n\n**Best for:** Solo developers, side projects, open source\n\n- Single Node version (22) detection workflow\n- CI defaults to detection-only (tests/security/docs disabled in minimal mode)\n- Security scans run monthly (not on every commit)\n- Path filters skip CI for docs/README changes\n- **Runtime:** ~1-2 min/run\n- **Est. usage target:** under ~1000 minutes/month by default\n\n```bash\nnpx create-qa-architect@latest\n# or explicitly:\nnpx create-qa-architect@latest --workflow-minimal\n```\n\n### Standard - $5-20/month\n\n**Best for:** Small teams, client projects, production apps\n\n- Single Node 22 testing **only on main branch**\n- Security scans run monthly\n- Path filters enabled\n- **Runtime:** ~15-20 min/commit\n- **Est. cost:** ~$5-20/mo for typical projects\n\n```bash\nnpx create-qa-architect@latest --workflow-standard\n```\n\n### Comprehensive - $100-350/month\n\n**Best for:** High-compliance projects, large teams\n\n- Matrix testing (Node 20 + 22) on **every commit**\n- Security scans inline (every commit)\n- No path filters (runs on all changes)\n- **Runtime:** ~50-100 min/commit\n- **Est. cost:** ~$100-350/mo for typical projects\n\n```bash\nnpx create-qa-architect@latest --workflow-comprehensive\n```\n\n### Matrix Testing for Libraries\n\n**Publishing an npm package or CLI tool?** Use `--matrix` to test on multiple Node.js versions:\n\n```bash\nnpx create-qa-architect@latest --matrix\n```\n\nThis adds Node.js 20 + 22 matrix testing - recommended for published packages that support multiple runtime versions. Not needed for web apps you deploy (you control the Node version).\n\n### Switching Between Tiers\n\nAlready using qa-architect? Convert to minimal to reduce costs:\n\n```bash\nnpx create-qa-architect@latest --update --workflow-minimal\n```\n\n### ⚠️ Avoid Duplicate Workflows\n\n**qa-architect's `quality.yml` is designed to be your single CI workflow.** Do not use it alongside a separate `ci.yml` - this causes:\n\n- **2-3x CI minutes usage** (both workflows run on every push)\n- **Duplicate checks** (ESLint, tests, security scans run twice)\n- **Unexpected billing** (easily exceeds GitHub's 2,000 min/month free tier)\n\n**If you have both `ci.yml` and `quality.yml`, run:**\n\n```bash\nnpx create-qa-architect@latest --update --workflow-minimal\n```\n\n`--update` now automatically removes known duplicate workflow names (`ci.yml`, `test.yml`, `tests.yml`, `quality-legacy.yml`) while preserving `quality.yml`.\n\nThe `quality.yml` workflow is adaptive - it runs appropriate checks based on your project's maturity level, so a separate `ci.yml` is unnecessary.\n\n### Analyzing Your Costs (Pro Feature)\n\n```bash\nnpx create-qa-architect@latest --analyze-ci\n```\n\nShows estimated GitHub Actions usage and provides optimization recommendations.\n\n### License\n\n**Commercial License (freemium)** — free tier covers the basic CLI; Pro features require a paid subscription. See [LICENSE](LICENSE).\n\n## Tech Stack\n\n| Component         | Technology                                         |\n| ----------------- | -------------------------------------------------- |\n| **Runtime**       | Node.js 20+                                        |\n| **Linting**       | ESLint 9 (flat config)                             |\n| **Formatting**    | Prettier 3                                         |\n| **CSS Linting**   | Stylelint 16                                       |\n| **Git Hooks**     | Husky 9 + lint-staged 15                           |\n| **Python**        | Black, Ruff, mypy, pytest                          |\n| **Shell Scripts** | ShellCheck, syntax validation, permissions checks  |\n| **Performance**   | Lighthouse CI                                      |\n| **Security**      | npm audit (Free), Gitleaks + ESLint security (Pro) |\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 20 or higher\n- npm 10+ (installed automatically with Node 20)\n- Git repository (required for hooks)\n\n### Quick Start\n\n```bash\n# Navigate to your project\ncd your-project/\n\n# Bootstrap quality automation\nnpx create-qa-architect@latest\n\n# Install new dependencies\nnpm install\n\n# Set up pre-commit hooks\nnpm run prepare\n```\n\n### Update Existing Setup\n\n```bash\nnpx create-qa-architect@latest --update\nnpm install\nnpm run lint\n```\n\n`--update` refreshes the existing `quality.yml` from the latest template while preserving the detected workflow tier and existing matrix setting unless you explicitly override the tier with `--workflow-minimal`, `--workflow-standard`, or `--workflow-comprehensive`.\n\n### Dependency Monitoring (Free)\n\n```bash\nnpx create-qa-architect@latest --deps\n```\n\n### Pre-Launch Validation (Free)\n\n```bash\nnpx create-qa-architect@latest --prelaunch\nnpm install\nnpm run validate:all\n```\n\n## Usage Examples\n\n### Check Project Maturity\n\n```bash\nnpx create-qa-architect@latest --check-maturity\n```\n\n**Output:**\n\n```\nProject Maturity Report\n\nMaturity Level: Development\nDescription: Active development - has source files and tests\n\nQuality Checks:\n  Required: prettier, eslint, stylelint, tests\n  Optional: security-audit\n  Disabled: coverage, documentation\n```\n\n### Security Validation\n\n```bash\n# Check configuration security\nnpx create-qa-architect@latest --security-config\n\n# Validate documentation\nnpx create-qa-architect@latest --validate-docs\n\n# Comprehensive validation\nnpx create-qa-architect@latest --comprehensive\n```\n\n### GitHub Actions Cost Analysis (Pro)\n\n```bash\n# Analyze GitHub Actions usage and costs\nnpx create-qa-architect@latest --analyze-ci\n```\n\n**Output:**\n\n```\n📊 GitHub Actions Usage Analysis\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nRepository: my-project\n\nEstimated usage: 4,800 min/month\n  Commit frequency: ~2.0 commits/day\n  Workflows detected: 2\n\nWorkflow breakdown:\n  ├─ ci.yml:\n     • ~50 min/run\n     • ~60 runs/month = 3000 min/month\n  ├─ test.yml:\n     • ~30 min/run\n     • ~60 runs/month = 1800 min/month\n\n💰 Cost Analysis\nFree tier (2,000 min): ⚠️  EXCEEDED by 2,800 min\nOverage cost: $22.40/month\n\nAlternative options:\n  Team plan ($4/user/month): Still exceeds (1,800 min overage)\n    Total cost: $18.40/month\n  Self-hosted runners: $0/min (but VPS costs ~$5-20/month)\n```\n\n### Custom Templates\n\n```bash\n# Use organization-specific standards\nnpx create-qa-architect@latest --template ./my-org-templates\n```\n\n## What Gets Added\n\n```\nyour-project/\n├── .github/\n│   └── workflows/\n│       └── quality.yml          # GitHub Actions workflow\n├── .husky/                      # Pre-commit hooks\n├── .editorconfig                # Editor defaults\n├── .eslintignore                # ESLint ignore patterns\n├── .lighthouserc.js             # Lighthouse CI config\n├── .npmrc                       # npm configuration\n├── .nvmrc                       # Node version pinning\n├── .prettierrc                  # Prettier configuration\n├── .stylelintrc.json            # Stylelint rules\n├── eslint.config.cjs            # ESLint flat config\n└── package.json                 # Updated scripts\n```\n\n## Available Scripts (After Setup)\n\n```bash\nnpm run format              # Format all files\nnpm run format:check        # Check formatting (CI)\nnpm run lint                # ESLint + Stylelint\nnpm run lint:fix            # Auto-fix linting\nnpm run security:audit      # Vulnerability check\nnpm run security:secrets    # Scan for secrets\nnpm run validate:pre-push   # Pre-push validation\n```\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md) for planned features and strategic direction.\n\n## Contributing\n\nWant to improve this tool?\n\n1. Fork the repository\n2. Make your changes\n3. Test with a sample project\n4. Submit a pull request\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Pro Tier \u0026 Billing\n\n### Purchasing Pro\n\nPro tier ($49/mo or $490/yr) includes:\n\n- Security scanning (Gitleaks + ESLint security rules)\n- Smart Test Strategy (risk-based pre-push validation)\n- Multi-language support (Python, Shell scripts)\n- Unlimited private repos and runs\n\nPurchase at [buildproven.ai/qa-architect](https://buildproven.ai/qa-architect)\n\n### Server-Side Setup (Maintainers Only)\n\nThe billing system uses Stripe webhooks to manage licenses. If you're deploying your own instance:\n\n1. Set up webhook handler (see `webhook-handler.js`)\n2. Configure Stripe live mode keys\n3. Deploy to production server\n\nSee [docs/STRIPE-LIVE-MODE-DEPLOYMENT.md](docs/STRIPE-LIVE-MODE-DEPLOYMENT.md) for complete setup guide.\n\n## Support\n\n1. Review GitHub Actions logs\n2. Open an issue in this repository\n\n## License\n\nCommercial freemium license — the base CLI is free to use; Pro features require a paid subscription. See [LICENSE](LICENSE) for details.\n\n## Legal\n\n- [Privacy Policy](https://buildproven.ai/privacy-policy)\n- [Terms of Service](https://buildproven.ai/terms)\n\n---\n\n\u003e **BuildProven** · [buildproven.ai](https://buildproven.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildproven%2Fqa-architect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuildproven%2Fqa-architect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildproven%2Fqa-architect/lists"}