bmad-testarch-test-review

Review test files against a fixed quality rubric and produce scored reports.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-testarch-test-review-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-test-review
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/bmad-testarch-test-review
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-testarch-test-review-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Test suites often contain hidden quality defects—hard waits, tautological assertions, shared state, missing test IDs—that make tests flaky or meaningless while still reporting green. This Skill audits existing test files against a deterministic criteria registry and produces a 0-100 quality score with actionable, severity-ranked findings. ## Core Features & Use Cases - Rubric-Based Scoring: Evaluates tests against a pinned criteria registry (Critical/High/Medium/Low rows) covering determinism, isolation, fixtures, data factories, network-first patterns, and flakiness, with a fixed deduction ledger and severity caps. - Framework-Aware Review: Adapts to Playwright, Jest, Cypress, Vitest, Pact contract tests, and Maestro mobile flows, loading only the relevant knowledge base fragments for the detected stack. - Headless and Interactive Modes: Runs interactively with Create/Resume/Validate/Edit modes, or fully non-interactively via CLI-supplied review sets for CI integration. - Use Case: A QA engineer points the Skill at a directory of Playwright specs before a merge; it returns a scored report listing each violation with file:line location, registry row, and a recommended fix with code examples. ## Quick Start Ask the agent to review the test quality of the files in your tests directory and generate a scored review report.

Frequently Asked Questions about bmad-testarch-test-review

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

FAQPage Schema
How do I review test quality for Playwright or Jest tests?

Point the workflow at a test file, directory, or suite and it parses structure, fixtures, assertions, and waits, then scores each file against the criteria registry. The output is a markdown report with a 0-100 score, letter grade, and file:line findings with recommended fixes.

What test quality issues does a test review check for?

It checks hard waits, tautological or missing assertions, conditional logic, shared state, oversized files, missing test IDs and priority markers, network-first violations, and flakiness patterns. Each criterion has a pinned severity from Critical to Low defined in the criteria registry.

Can I run test review headless in a CI pipeline?

Yes. Setting headless to true skips the greeting and interactive menu, executes Create mode directly, and never prompts. You supply review_files as the authoritative review set and optionally context_files, and the run resolves everything from configuration.

Does the test review measure code coverage?

No. Coverage analysis is explicitly out of scope; the review only audits the quality of existing tests and never generates tests. Coverage mapping and coverage gate decisions are routed to the separate trace workflow.

How is the test quality score calculated?

Scoring starts at 100, deducts 10 per Critical, 5 per High, 2 per Medium, and 1 per Low violation, then adds up to 30 bonus points for patterns like fixtures and network-first. The highest severity caps the score, and the grade maps from the capped value.

Does it support Maestro mobile flows or Pact contract tests?

Yes. The registry includes Maestro-specific rows for flow assertions, secrets in flows, and optional outcome steps, plus Pact rows for worker parallelism and pool isolation. Stack detection loads the matching knowledge fragments only when relevant.