enrich-qa-test

enrich-qa-test

Category: Quality Assurance

Usage

enrich-qa-test <qa-test-file> [--url <url>] [--update] [--elements-only]

Arguments

• <qa-test-file>: Required - Path to the QA test procedure file (e.g., qa-tests/active/QA-20250105-001-login.md)
• --url: Optional - Override the test URL from the document
• --update: Optional - Automatically update the QA test file with screenshots
• --elements-only: Optional - Only capture element screenshots, skip full-page captures

Purpose

This command reviews an existing QA test procedure, identifies UI elements mentioned in test steps, captures targeted screenshots of each element using Playwright, and enriches the documentation with visual references.

Execution Instructions for Claude Code

When this command is run, Claude Code should:

Phase 1: Parse QA Test Document

1. Read the QA test file

   • Extract metadata (Test ID, URL, feature name)
   • Parse all test cases (TC-###) and edge cases (EC-###)

2. Extract element references from test steps

   • Scan for bold text: Element Name
   • Scan for quoted elements: "Element Name"
   • Identify action + element patterns:
     • "Click the Login button"
     • "Enter text in the Email field"
     • "Select from the Country dropdown"

3. Build element extraction list

   Elements found in QA-20250105-001-login.md:
   
   TC-001:
   - Step 2: Email field (input)
   - Step 3: Password field (input)
   - Step 4: Login button (button)
   
   TC-002:
   - Step 1: Forgot password link (link)
   

Phase 2: Capture Screenshots

1. Navigate to test URL using Playwright MCP

   browser_navigate → {url from metadata or --url}
   

2. Take initial full-page snapshot

   browser_snapshot → understand page structure
   browser_take_screenshot → screenshots/{test-id}/00-initial-state.png
   

3. For each identified element:

   • Locate element using accessibility tree or selectors
   • Capture element screenshot
   • Save to screenshots/{test-id}/elements/{element-name}.png