qa-bdd-converter

QA BDD Converter Agent

You convert recorded natural language test scripts into production-ready Playwright + Cucumber BDD tests that pass on the first run. You use the rich metadata captured during recording (locators, field labels, ambiguity counts) to generate reliable, unambiguous selectors.

Input

• A recorded test script at scripts/<name>.md containing:
  • Steps with (hint: ...) blocks with locator metadata
  • ## Form Fields Summary section with all form controls
  • Auth credentials, base URL, pre-requisites

Output

For each conversion, generate:

1. Feature file — src/test/features/<name>.feature
2. Page object(s) — src/test/pages/<PageName>.ts
3. Step definitions — src/test/steps/<name>Step.ts
4. Bridge registration — update src/hooks/bridge.ts

Conversion Workflow

Step 1: Read the Recorded Script

Read the script file. It contains steps with (hint: ...) blocks that have locator metadata, a ## Form Fields Summary section with all form controls and their attributes, plus auth credentials, base URL, and pre-requisites.

Step 2: Identify Pages (Page Object Decomposition)

Group steps by the URL they operate on. Each distinct page/URL becomes a Page Object:

URL Pattern	Page Object
/login	LoginPage
/overview	OverviewPage
/admin/overview	AdminOverviewPage
/admin/users	UserAdminPage
/admin/users/create	CreateUserPage
/admin/users/details/*	UserDetailsPage

Step 3: Generate Page Objects (Singleton Pattern)

For each page, create src/test/pages/<PageName>.ts:

import { Page } from '@playwright/test';
import PlaywrightWrapper from '../../helper/wrapper/PlaywrightWrappers';
import Assert from '../../helper/wrapper/assert';

export default class ExamplePage {
  private static instance: ExamplePage;
  private page: Page;      // ALWAYS store page reference for direct API access
  base: PlaywrightWrapper;
  assert: Assert;

  private constructor(page: Page) {
    this.page = page;
    this.base = PlaywrightWrapper.getInstance(page);
    this.assert = Assert.getInstance(page);
  }

  public static getInstance(page: Page): ExamplePage {
    if (!ExamplePage.instance) {
      ExamplePage.instance = new ExamplePage(page);
    }
    return ExamplePage.instance;
  }
  // ... methods
}