e2e-implementer

Category: Tools & Productivity | Uploader: davidgfolch | Downloads: 0 | Version: v1.0（Latest）

Create and run E2E tests using Playwright in the `apps/e2e` module.

Changelog: Source: GitHub https://github.com/davidgfolch/AI-job-search

Directory Structure

Current level: .agent/skills/e2e-implementer/

📄 SKILL.md 1.7 KB

SKILL.md

---
name: e2e-implementer
description: Create and run E2E tests using Playwright in the `apps/e2e` module.
---
# E2E Implementer Instructions

Use this skill when implementing or modifying End-to-End (E2E) tests. These tests are distinct from unit/integration tests and are housed in a dedicated module.

## 1. Location & Structure
-   **Module**: All E2E tests MUST be located in `apps/e2e`.
-   **Structure**:
    -   `specs/`: Contains test files (`*.spec.ts`).
    -   `pages/`: Page Object Models (POM).
    -   `utils/`: Helper functions.

## 2. Naming Conventions
-   **Test Files**: Must end in `.spec.ts` (Playwright standard).
-   **Page Objects**: Must end in `Page.ts` (e.g., `LoginPage.ts`).

## 3. Best Practices
- **Page Object Model**: ALWAYS use POM. Do not define selectors or logic inside specs.
- **Independence**: Tests should not depend on each other.
- **Selectors**: ALWAYS use IDs to locate DOM objects. Ensure target elements have unique `id` attributes in the source code. Avoid using text-based locators or CSS classes unless absolutely necessary.
- **Database**: Do NOT use the production database. Use the `scripts/run_e2e_tests.py` script which handles isolation.

## 4. Architecture Verification
-   Ensure `apps/e2e` does not import internal implementations from other apps directly (unless it's a shared type/constant). It should interact via the browser.
- Run commonlib/.../architecture_test.py to verify the architecture.

## Usage
-   **Preferred Method**: Run `python scripts/run_e2e_tests.py` from the root. This will:
    1. Setup a temporary isolation database.
    2. Start the backend on a free port.
    3. Run the tests.
-   Manual run: `npm test` inside `apps/e2e` (WARNING: Configured against local dev environment by default).

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

e2e-implementer

Directory Structure

SKILL.md

Report

Notice