bmad-testarch-test-review

Review test files against a quality rubric and produce a scored report with actionable fixes.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-testarch-test-review-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-test-review
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-testarch-test-review
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-testarch-test-review-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Test suites often contain hidden quality problems such as hard waits, missing assertions, shared state, and flakiness patterns that pass CI but erode reliability. This Skill audits existing test files against a fixed criteria registry and produces a deterministic 0-100 quality score with severity-ranked findings and recommended fixes. ## Core Features & Use Cases - Rubric-Based Test Audit: Evaluates test files against pinned criteria (disabled tests, hard waits, determinism, isolation, fixtures, data factories, network-first patterns) with fixed severities, so two reviewers reach the same verdict. - Framework-Aware Analysis: Adapts to Playwright, Jest, Cypress, Vitest, Pact contract tests, and Maestro mobile flows, loading only the knowledge fragments relevant to the detected stack. - Scored Review Report: Generates a structured Markdown report with a quality score, letter grade, computed recommendation (Approve / Request Changes / Block), code-level fix examples, and optional inline TODO comments in the reviewed files. - Use Case: Before merging a pull request, run the review on the changed test files to catch a committed test.only or a race condition between navigation and network interception, and receive a report the team can act on. ## 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 in a Playwright or Jest project?

Point the workflow at a single test file, a directory, or the full suite via the review_scope variable. It parses the test structure, checks criteria like hard waits, assertions, and isolation, and writes a scored report with fixes to the configured output file.

What does the test quality score measure?

The score starts at 100 and deducts points per violation by severity: 10 for critical, 5 for high, 2 for medium, 1 for low, with up to 30 bonus points for patterns like fixtures and network-first. The result maps to a letter grade from A to F.

Does the test review check code coverage?

No, coverage analysis is explicitly out of scope for this workflow. It only audits the quality of existing tests; coverage metrics and coverage gate decisions are handled by the separate trace workflow.

Can the review run without user interaction in CI?

Yes, setting headless to true skips the greeting and interactive menu, executes the create flow directly, and resolves all inputs from configuration such as review_files and output_file_override. It never prompts the user in this mode.

Which test frameworks are supported by the review?

The workflow adapts to Playwright, Jest, Cypress, Vitest, Pact contract tests, and Maestro mobile flows. It detects the stack from project files and loads only the knowledge fragments relevant to that runner.

Will the review modify my test files?

By default no, the run is report-only. Only when generate_inline_comments is set to true does it write TODO comments at violation locations, and it never changes test logic.