parity-suite

Builds Playwright parity test suites against legacy apps and validates them via fault injection.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/shoji9x9/portfolio --skill parity-suite-shoji9x9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parity-suite
Source: https://github.com/shoji9x9/portfolio/tree/main/.agents/skills/parity-suite
Command: npx skills add https://github.com/shoji9x9/portfolio --skill parity-suite-shoji9x9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? When replacing an application without changing its specification, teams lack an executable pass/fail criterion that works against both the old and new implementations. This Skill builds that criterion—a parity suite—against the current application and proves its strength through fault injection, so the replacement can be verified objectively. ## Core Features & Use Cases - Parity Suite Authoring: Writes Playwright suites using a logical-name locator mapping layer and hand-written tolerant aria snapshots, plus API characterization via record/replay. - Baseline & Noise Capture: Collects visual baselines (screenshots, computed styles, reference aria snapshots) and noise thresholds in one pass for handoff to diff tooling. - Strength Gate via Fault Injection: Injects known faults (data, DOM structure, style, document-level) to verify the suite actually detects regressions before declaring it complete. - Use Case: During a legacy-to-React migration, run the Skill per feature to produce a suite that is green against the current app, with baselines and strength reports recorded for downstream replace and diff phases. ## Quick Start Ask the AI to run parity-suite for a specific feature slug and current-side target to build and strength-verify the parity suite.

Frequently Asked Questions about parity-suite

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

FAQPage Schema
How do I build a parity test suite for an application migration?▼

Run parity-suite with a feature slug and a current-side target after completing replace-strategy setup and the golden-dataset phase. It writes a Playwright suite with locator mapping, hand-written aria snapshots, and API characterization, then verifies strength via fault injection.

How to test that old and new app implementations behave identically?▼

Write one Playwright suite against logical names resolved per side, and run it through projects with two baseURLs (current and new). The suite must be green on both sides; side-specific expectations are only allowed for declared intentional differences.

Can I use Selenium or Cypress instead of Playwright for parity testing?▼

No. The design depends on Playwright-specific features: partial-match toMatchAriaSnapshot, role and accessible-name resolution via getByRole, and projects with two baseURLs. The Skill stops explicitly when Playwright is unavailable.

Why not diff captured aria snapshots between old and new implementations?▼

Mechanically diffing snapshots mixes genuine improvements (div becoming role=alert) with noise, producing no usable signal. Assertions must be hand-written tolerant snapshots covering only what the specification guarantees, with captured snapshots kept as reference material.

What is fault injection testing for test suite strength?▼

Fault injection is a negative control: known faults derived from regression categories are injected at observation boundaries, and the detection set (assertions plus differ) must turn red. A positive control run without injection must be green first, and passing faults reveal suite weaknesses.

What are the prerequisites for running parity-suite?▼

It requires git, Node.js with Playwright, completed replace-strategy setup, and a finished golden-dataset phase A. The dataset's current target must match the selected target, and the suite runs one feature per execution.