playwright-qa

Files (5)

• SKILL.md
• bug-reports.md
• manual-to-automated.md
• test-design.md
• test-review.md

SKILL.md (first lines)

# Playwright QA Workflows

> For **QA engineers**: the work around the test code. What to test, how to report what broke, how to automate a manual suite, and how to judge a test.

**4 guides**. They build on the `core/` guides for the Playwright APIs and link to them rather than repeating them.

## Guide Index

| What you're doing | Guide |
|---|---|
| Ticket / PRD / acceptance criteria → test cases, risk ranking, test plan for the generator | [test-design.md](test-design.md) |
| Failing test → app bug, test bug or flake; bug report; what to do with the test meanwhile | [bug-reports.md](bug-reports.md) |
| Manual test cases or a CSV export → Playwright specs with case IDs | [manual-to-automated.md](manual-to-automated.md) |
| Review Playwright tests or a PR; lint rules; prove a test can fail | [test-review.md](test-review.md) |

## Golden Rules

1. **Boundaries and negative paths first**: bugs live at the edges of a rule, not in the happy path.
2. **Lowest layer that proves it**: rules at API level, wiring and critical flows in E2E.
3. **Classify before filing**: app bug, test bug, flake or environment; the trace usually decides.
4. **Frequency is a number**: `--repeat-each=20` gives N/20, never "sometimes".
5. **Known bug → `test.fail()` with an issue link**, never a deleted test or a loosened assertion.
6. **A test that can't fail guards nothing**: break the feature once and watch it fail.
7. **Keep case IDs on automated tests** so results map back to the manual suite.

From testdino-hq/playwright-skill, MIT.

More from testdino-hq/playwright-skill