e2e-testing

name	e2e-testing
description	Guides the creation of Playwright E2E tests from planning through implementation. Covers test plan creation, data seeding, Page Object Model development, and test writing with human checkpoints at each stage.

Writing E2E Tests

Before starting, read .claude/skills/e2e-testing/REFERENCE.md for project-specific patterns, application context, POM rules, assertion conventions.

Pre-flight checks

Run these before starting any test work:

# 1. Verify playwright-cli is installed
playwright-cli --version

# 2. Verify Playwright version is 1.59 or higher
npx playwright --version

# 3. Ensure playwright-cli skills are installed
playwright-cli install --skills

# 4. Session name — use -s=<output> for all playwright-cli calls this run
node -e "console.log('e2e-' + Date.now())"

If playwright-cli is not found, install it by running these two commands separately (chaining with && can fail on Windows):

npm install -g @playwright/cli@latest
playwright-cli install --skills

Use the output from step 4 as your -s= value for every playwright-cli call this run.

---

Create Playwright end-to-end tests for a feature or workflow, from plan through passing tests. Follow this workflow step by step. Stop after each step and check in with the user before proceeding.

Workflow checklist

E2E Test Progress:
- [ ] Step 1: Create the test plan
- [ ] Step 2: Seed test data (skip if not needed)
- [ ] Step 3: Create/update Page Object Models
- [ ] Step 4: Write the tests

Step 1: Create the test plan