debug-failed-integration-test

Diagnose failed Playwright integration tests in werewolf-simple with log correlation.

Updated Jun 25, 2025
One-click install
npx skills add https://github.com/wangdaqian08/werewolf-simple --skill debug-failed-integration-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-failed-integration-test
Source: https://github.com/wangdaqian08/werewolf-simple/tree/main/.claude/skills/debug-failed-integration-test
Command: npx skills add https://github.com/wangdaqian08/werewolf-simple --skill debug-failed-integration-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and fix failing integration tests in werewolf-simple by turning vague red builds into evidence-backed root causes and targeted repairs.

Core Features & Use Cases

  • Local Reproduction: Re-run the exact failing Playwright spec against the real backend before changing any code.
  • Log Correlation: Match frontend test output with Spring Boot state-change logs to identify the precise rejection or stalled phase.
  • DOM-First Fixes: Prefer testids, real user interactions, and product-code corrections over timeouts, retries, or guesswork.
  • CI Verification: Confirm the fix with repeated stable runs, type checks, unit tests, and monitored PR checks.
  • Use Case: A GitHub Action turns red on a Playwright shard; this Skill walks you from reproduction to a verified patch without hiding the underlying bug.

Quick Start

Use this skill to reproduce the failing spec locally, inspect both backend and Playwright logs, apply a DOM-first fix, and verify the result across multiple stable runs.

Frequently Asked Questions about debug-failed-integration-test

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

FAQPage Schema
How do I debug failing Playwright E2E tests running against a real Spring Boot backend?

Debug failing Playwright E2E tests by reproducing the exact spec locally against the real backend, then correlating frontend test output with Spring Boot state-change logs to pinpoint the precise rejection or stalled phase before applying fixes.

What is the best way to fix flaky integration tests on GitHub Actions without hiding the underlying bug?

Fix flaky integration tests on GitHub Actions by using an evidence-driven approach: reproduce the failing spec locally, inspect backend and frontend logs, apply a DOM-first fix using testids, and verify the result across multiple stable runs without relying on timeouts or retries.

Why do my Playwright specs fail on pull requests but pass locally, and how should I handle quarantined specs?

Playwright specs failing on pull requests require matching frontend output with Spring Boot logs to identify the exact failure. Handle quarantined specs by reproducing them locally against the real backend and applying product-code corrections rather than guesswork.

Can I use DOM-first fixes to resolve E2E test failures instead of adding retries or timeouts?

Yes, DOM-first fixes resolve E2E test failures by preferring testids, real user interactions, and product-code corrections over timeouts, retries, or guesswork, ensuring the underlying bug is addressed rather than masked by unstable test behavior.

How do I verify a Playwright test fix before merging a pull request on CI?

Verify a Playwright test fix before merging by confirming repeated stable runs, type checks, unit tests, and monitored PR checks on GitHub Actions, ensuring the red build turns green through evidence-backed root cause resolution rather than intermittent passes.

What should I do when my Playwright shard turns red on a GitHub Actions pull request?

When a Playwright shard turns red on a GitHub Actions pull request, re-run the exact failing spec locally against the real backend, inspect both Spring Boot and Playwright logs to correlate failures, and apply a targeted DOM-first fix followed by CI verification.