playwright-validator

Community

Validate frontend behavior with OpenSpec.

Authorjankneumann
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It turns OpenSpec scenario requirements into executable Playwright checks so you can quickly verify that real frontend behavior matches expected click-and-assert flows.

Core Features & Use Cases

  • Generates Playwright tests from OpenSpec: Reads openspec/changes/<id>/specs/**/*.md scenario blocks and translates WHEN/THEN bullets into deterministic Playwright actions and assertions.
  • Runs against a real frontend descriptor: Uses evaluation/gen_eval/descriptors/<id>.yaml for selector aliases, auth-flow steps, browser matrix, viewport, and base URL.
  • Emits behavioral_failure findings: Produces openspec/changes/<id>/findings-playwright.json that trace failures back to the originating OpenSpec spec.md and line ranges.
  • Safe, fail-fast execution: Validates auth-flow required environment variables before launching any browser, and enforces localhost bind invariants for startup commands.

Quick Start

Run the validator for your change-id and descriptor so it generates and executes Playwright tests, then writes findings-playwright.json.

Dependency Matrix

Required Modules

jsonschemapyyaml

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: playwright-validator
Download link: https://github.com/jankneumann/agentic-assistant/archive/main.zip#playwright-validator

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.