generate-tests

Generate Tests

You are a senior Playwright automation engineer. Convert a JSON test plan into production-ready TypeScript files.

Inputs

• ${user_config.app_name} — slug for the app under test
• ${user_config.profile_path} — app profile JSON
• ${user_config.output_dir} — base output dir (default output/)
• ${user_config.use_storage_state_auth} — "true" if tests should use a Playwright storageState file
• ${user_config.storage_state_path} — path to that storageState file
• $ARGUMENTS — optional: explicit path to a plan JSON. If empty, use the most recently modified file in ${user_config.output_dir}/${user_config.app_name}/plans/.

Steps

1. Resolve the plan. If $ARGUMENTS is non-empty, use it. Otherwise list ${user_config.output_dir}/${user_config.app_name}/plans/*.json (Glob), pick the newest by mtime (Bash: ls -t), and read it.
2. Compute featureSlug = slugify(plan.feature).
3. Generate three files following the Code standards and Rules below:
   • <featureSlug>.spec.ts — main test file
   • pages/<featureSlug>.page.ts — Page Object class (skip only if interactions are trivial)
   • fixtures/<featureSlug>.fixtures.ts — test data and fixture helpers (skip only if no test-specific data is needed)
4. Write files under ${user_config.output_dir}/${user_config.app_name}/tests/ (create the directory tree first).
5. Write metadata to ${user_config.output_dir}/${user_config.app_name}/tests/<featureSlug>.meta.json:

   {
     "generatedAt": "<ISO timestamp>",
     "planFile": "<resolved plan path>",
     "featureSlug": "<slug>",
     "notes": "<any caveats>",
     "missingSelectors": ["<data-testids that must be added to the app>"],
     "mocksRequired": ["<mocks that must exist before tests can pass>"]
   }
   

6. Report the list of files written. If missingSelectors or mocksRequired is non-empty, surface them prominently — these block the test run.

Code standards

import { test, expect } from '@playwright/test';
import type { Page } from '@playwright/test';

test.describe('Feature Name', () => {
  test.beforeEach(async ({ page }) => {
    // If use_storage_state_auth=true, the storageState is applied at the project
    // level in playwright.config.ts — no per-test seeding needed.
    // Otherwise, seed auth here (e.g. via localStorage or a login helper).
    await page.goto('/');
    await page.waitForLoadState('networkidle');
  });

  test('TC-001: descriptive title', async ({ page }) => {
    // Arrange / Act / Assert
    await expect(page.locator('[data-testid="element"]')).toBeVisible();
  });
});