bmad-testarch-test-review

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Test suites often contain hidden quality problems such as hard waits, missing assertions, shared state, and non-deterministic logic that pass silently in CI. This Skill audits existing test files against a fixed criteria registry and produces a deterministic 0-100 quality score with actionable, line-level findings. ## Core Features & Use Cases - Rubric-Based Test Audit: Evaluates test files against pinned severity rules covering disabled tests, tautological assertions, hard waits, isolation, fixtures, data factories, and network-first patterns. - Deterministic Scoring and Verdict: Computes a 0-100 score, letter grade, and a computed recommendation (Approve, Approve with Comments, Request Changes, or Block) from violation counts rather than reviewer judgment. - Multi-Mode Workflow: Supports Create, Resume, Validate, and Edit modes, plus a headless non-interactive mode for CLI runners, with optional inline TODO comments written into reviewed test files. - Use Case: A QA engineer points the workflow at a Playwright spec directory before a merge; the review flags a committed test.only as critical, deducts points for hard waits, and emits a report with file:line fixes grounded in knowledge base fragments. ## Quick Start Ask the agent to review the test quality of the files in your tests directory and generate a scored test 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 test files?

Run the test review workflow against a single file, directory, or full suite. It parses each test file, checks criteria like hard waits, assertions, isolation, and fixtures, and outputs a scored report with file:line violations and recommended fixes.

What does the test quality score and grade mean?

The score starts at 100 and deducts 10 per critical, 5 per high, 2 per medium, and 1 per low violation, with up to 30 bonus points for best practices. Grades map to ranges: A is 90-100, B is 80-89, C is 70-79, D is 60-69, and F is below 60.

Does the test review workflow measure code coverage?

No, coverage analysis is explicitly out of scope. The workflow only audits the quality of existing tests and does not generate tests or measure coverage; coverage metrics and gate decisions are routed to the separate trace workflow.

Can the test review run non-interactively in CI?

Yes, setting headless to true skips the greeting and interactive menu, executes Create mode directly, and never prompts. Inputs such as review_files, context_files, and output_file_override are resolved entirely from configuration.

Which test frameworks and file types are supported?

The review adapts to Playwright, Jest, Cypress, Vitest, Pact contract tests, and Maestro mobile flows, with framework-specific rules loaded from the knowledge base. Files in formats the criteria registry cannot evaluate are excluded from scoring and listed in the report's excluded manifest.

Will the review modify my test files?

By default the run is report-only and never touches test files. Only when generate_inline_comments is set to true does it add non-invasive TODO comments at violation locations, leaving all test logic unchanged.