qa-automation-architect

Design test suite automation architecture with tooling, CI placement, and migration plans.

2|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/nguyenpv1980-wq/Project-Aegis --skill qa-automation-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-automation-architect
Source: https://github.com/nguyenpv1980-wq/Project-Aegis/tree/main/.claude/skills/qa-automation-architect
Command: npx skills add https://github.com/nguyenpv1980-wq/Project-Aegis --skill qa-automation-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill designs the automation machinery behind a QA strategy so test suites are structured, parallel-safe, observable, and properly placed in CI. It helps teams turn a slow, tangled, unreliable test setup into a maintainable framework with clear ownership and migration steps.

Core Features & Use Cases

  • Tooling Selection: Chooses the right runner and supporting tools for each test layer with rationale and a rejected alternative.
  • Framework Design: Defines directory layout, helper and fixture placement, auth-state reuse, reporting conventions, and import boundaries.
  • Parallelization and CI: Specifies worker-safe isolation, database strategy, sharding, retry policy, artifact retention, and PR/merge/nightly execution tiers.
  • Use Case: A team with a 45-minute suite, shared seed-user collisions, and unconditional retries can use this Skill to redesign the test architecture before rewriting individual tests.

Quick Start

Ask for an automation blueprint for your current test stack, including layer-by-layer tooling, isolation rules, CI placement, and a migration plan.

Frequently Asked Questions about qa-automation-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a test automation architecture that scales?

Designing test automation architecture involves selecting appropriate runners for each test layer, organizing directory layouts, defining import boundaries, and establishing reporting conventions to ensure suites remain maintainable and structured.

What is the best way to stop flaky tests and retry policy failures in CI?

To stop flaky tests, define a structured retry policy targeting specific failure modes rather than applying unconditional retries. Redesigning the test architecture isolates collision-free execution and establishes proper worker-safe database strategies.

How do I fix parallelization failures and shared seed-user collisions in my test suite?

Fixing parallelization failures requires specifying worker-safe isolation rules and database sharding strategies to prevent shared seed-user collisions. The architecture enforces collision-free isolation across parallel test workers.

Does Vitest or Playwright work for layer-specific test runners in a CI pipeline?

Vitest and Playwright can serve as layer-specific runners within a CI pipeline. The architecture selects the right runner for each test layer with rationale and defines a rejected alternative to ensure optimal tooling fit.

How do I structure a CI pipeline for PR, merge, and nightly test execution tiers?

Structuring a CI pipeline for test execution involves defining PR, merge, and nightly tiers with specific artifact retention and reporting rules. This ensures test suites run efficiently at the correct stage of the development workflow.

When should I redesign my test architecture instead of rewriting individual tests?

You should redesign your test architecture before rewriting individual tests when facing a slow, tangled, or unreliable test setup. Framework overhauls establish clear ownership, migration steps, and proper tooling before fixing specific test cases.