e2e

E2E Skill Suite

This is the entry point for the E2E skill suite. It does not contain implementation details — it delegates to the sub-skills listed below, each covering a distinct concern.

Load order is mandatory. Each sub-skill depends on state written by the previous one.

---

When to Load This Suite

Load this suite whenever the spec involves any of the following:

• End-to-end tests or browser automation
• VE tasks (VE0, VE1, VE2, VE3) in any workflow phase
• [VERIFY] tasks that use browser tools
• Playwright, MCP Playwright tools (browser_*)
• User flow verification against a running application
• UI interaction testing (clicks, form fills, navigation)

If any of the above applies: load all sub-skills before writing any browser code.

---

Sub-Skills — Load in This Order

1. playwright-env.skill.md

Purpose: Resolves the browser execution context — app URL, auth mode, credentials references, browser config, safety limits. Writes playwrightEnv to .ralph-state.json.

Load when: Always first, before any other E2E skill.

Read: ${CLAUDE_PLUGIN_ROOT}/skills/e2e/playwright-env.skill.md

2. mcp-playwright.skill.md

Purpose: Validates MCP server availability, handles lock recovery, and emits ESCALATE if the server is unreachable. Writes mcpPlaywright to .ralph-state.json.

Load when: Always second, after playwright-env.

Read: ${CLAUDE_PLUGIN_ROOT}/skills/e2e/mcp-playwright.skill.md

3. playwright-session.skill.md

Purpose: Governs session lifecycle — start, navigation, stable-state detection, auth flows, context isolation, unexpected page recovery, and cleanup guarantee.

CRITICAL sections (read before writing any browser interaction):

• Navigation Anti-Patterns — page.goto() on internal routes breaks SPA routing
• Unexpected Page Recovery — if you land on 404/login/wrong page, diagnose the navigation step, do NOT assume the element is missing

Load when: Always third, after mcp-playwright.

Read: ${CLAUDE_PLUGIN_ROOT}/skills/e2e/playwright-session.skill.md

4. ui-map-init.skill.md

Purpose: Builds or updates ui-map.local.md — the authoritative selector map for the spec. Sub-skills and tasks use selectors from this file; they never invent selectors.

Load when: VE0 tasks, or when ui-map.local.md is missing or stale.

Read: ${CLAUDE_PLUGIN_ROOT}/skills/e2e/ui-map-init.skill.md

5. selector-map.skill.md

Purpose: Governs how to read and write selector maps — entry format, confidence levels, broken selector protocol, and incremental update rules.

Load when: Any task that reads ui-map.local.md or adds new selectors to it.

Read: ${CLAUDE_PLUGIN_ROOT}/skills/e2e/selector-map.skill.md

---

Platform-Specific Examples

For platform-specific navigation patterns and selector conventions, see the examples/ directory. These are reference implementations for developers — they show how the above skills apply to concrete platforms. The task-planner writes the relevant skill paths directly into VE task bodies after research.

${CLAUDE_PLUGIN_ROOT}/skills/e2e/examples/

---

Anti-Patterns Reference

The canonical E2E anti-pattern list lives at:

${CLAUDE_PLUGIN_ROOT}/references/e2e-anti-patterns.md

Read it before writing any browser code. The Navigation section is the highest-priority.