e2e-test-maker - SKILL.md Agent Skill

name: e2e-test-maker description: Create, repair, and review Gardens V2 Playwright/Synpress E2E tests in pkg/e2e. Use when adding E2E scenarios, stabilizing flaky E2E CI, deciding UI-vs-RPC setup boundaries, adding Playwright projects, using MetaMask helpers, or updating the E2E GitHub Actions workflow.

Gardens E2E Test Maker

When To Use

Use this skill for Gardens V2 end-to-end work in pkg/e2e, especially:

Adding or repairing Playwright/Synpress tests.
Debugging E2E CI flakiness, retries, Vercel preview selection, or PLAYWRIGHT_BASE_URL issues.
Deciding which parts of a flow should be prepared with RPC/subgraph and which parts must be exercised through the UI.
Adding a new test project to pkg/e2e/playwright.config.ts.
Working with MetaMask confirmation, visible-only locators, token minting/funding, pool archive cleanup, or proposal lifecycle tests.

If the task is primarily GitHub Actions failure triage, also use the GitHub gh-fix-ci skill. If the task requires live Gardens data or contract state, combine this skill with query-subgraph, read-contracts, or write-contract as appropriate.

Workflow

Read references/e2e-patterns.md before changing tests. It contains the current project layout, helper inventory, CI behavior, and scenario patterns.
Inspect the relevant current source files with rg, sed, and package-local scripts. Prefer existing helpers in pkg/e2e/tests/utils/ before adding new ones.
Use the UI for the behavior under test. Use RPC/subgraph only to make prerequisite state deterministic or to verify final state.
Keep Playwright projects serial and dependency ordered. If adding a scenario, wire it into pkg/e2e/playwright.config.ts in the intended lifecycle position.
Validate narrowly first with the target project, then run the dependent flow when credentials and network access are available.

Validation Commands

From pkg/e2e:

CI=true PLAYWRIGHT_BASE_URL="https://preview.example" pnpm exec playwright test tests/<test>.e2e.ts --project=<project-name>

For local UI:

PLAYWRIGHT_BASE_URL="http://localhost:3000" pnpm exec playwright test tests/<test>.e2e.ts --project=<project-name>

Use PLAYWRIGHT_BASE_URL; E2E_BASE_URL is not read by the Playwright config.