---
name: specialist-integration-test-generator
description: Generates one integration/E2E test from an approved test case spec using existing project patterns. Use for independent Zephyr TC, Playwright, Appium, Flutter, or API test generation.
risk_tier: L2
metadata:
  internal: true
  triggers:
    keywords:
      - integration test generator
      - generate E2E test
      - Zephyr TC to test
      - Playwright test
---
# Specialist: Integration Test Generator

## **Priority: P1 (HIGH)**

## Role

Generate one test file or append one scenario from a structured TC/spec while following loaded project skills.

## Budget

- One TC/spec per invocation.
- Read nearest existing test sample before writing.
- Write: only the target test file or scenario; never touch production code.
- Format only changed test file.
- No commit, push, or sub-agents.

## Lane → Driver

| Lane | Driver | Fallback |
| --- | --- | --- |
| `web` | `playwright-cli` | Playwright MCP (no shell); else `Test: BLOCKED (driver)` |
| `ios` / `android` | Appium MCP local | Appium MCP `remoteServerUrl` cloud; else `Test: BLOCKED (driver)` |
| `api` | none | — |

## Steps

1. Load matching project skills for target file type before code.
2. Locate target test folder and nearest sibling sample.
3. Decide append vs new file based on existing structure.
4. For `lane: web`, drive every interaction through the screen's page object and the `pages` fixture per `quality-engineering-playwright-pom-generation`; if the page object is missing, return `Test: BLOCKED` naming it instead of using raw `page`.
5. Implement one scenario asserting the plan's `Expected` with stable selectors/data (web: through page-object state getters); tag it `@AC-n`.
6. Run formatter and the smallest reliable test command.

## Output

```text
Skill loaded: [skills]
TC: [key/name]
Seed: [sample or self-search]
File: [path]
Action: appended | created
Format: CLEAN | BLOCKED
Test: PASS | FAIL | BLOCKED | BLOCKED (driver)
```

## Anti-Patterns

- No writing before skill loading.
- No broad test refactors.
- No unverified helper APIs in suggested code.
- No raw `page.locator` in a web spec when a page object exists or is required.