create-handover-test

Create Handover Test

Generate a ticket-driven handover test that validates specific acceptance criteria.

---

Workflow

1. Parse the ticket key and description from the user's request (e.g., PROJ-456 bulk export)
2. Check if a POM exists for the page under test in e2e/poms/
   • If yes, read it and add any new methods needed for this ticket's acceptance criteria
   • If no, create one first using the create-pom skill
3. Check if test data exists — create or update as needed
4. Create the spec file in e2e/tests/handover/
5. Run the test to verify it passes:

   npx playwright test --project="chromium:handover" {TICKET}-{description}.spec.ts
   

---

Naming Convention

Filename

{TICKET}-{short-description}.spec.ts

• {TICKET} — The ticket key exactly as it appears in the tracker (e.g., PROJ-456, MANT-123)
• {short-description} — Brief kebab-case summary (NOT the full ticket title)

Examples:

• PROJ-456-bulk-export.spec.ts
• MANT-123-vault-bulk-delete.spec.ts
• FEAT-789-user-avatar-upload.spec.ts

test.describe Block

The outer test.describe must include the ticket key for traceability:

test.describe('PROJ-456: Bulk Export', () => {

---

Spec Structure

import { test } from '../../fixtures/base';
import { getAuthFilePath } from '../../helpers/env-config';
import { FeaturePage } from '../../poms/feature.page';

const authFile = getAuthFilePath();

test.describe('PROJ-456: Bulk Export', () => {
    test.beforeAll(async ({ browser }) => {
        const context = await browser.newContext({
            storageState: authFile,
        });
        const page = await context.newPage();
        const pom = new FeaturePage(page);
        await pom.setUp();
        await page.close();
        await context.close();
    });

    test('should export selected items as CSV', async ({ page, testData }) => {
        const pom = new FeaturePage(page);
        const items = testData.feature.items;

        await pom.navigateToPage();
        // ... validate acceptance criteria from ticket
    });

    test('should show error when no items selected', async ({ page }) => {
        const pom = new FeaturePage(page);

        await pom.navigateToPage();
        // ... validate error handling criteria
    });
});