bmad-qa-generate-e2e-tests

Generate automated API and end-to-end tests for implemented features. Use when the user says "create qa automated tests for [feature]"

By bmad-code-org · 1,392 installs

npx skills add bmad-code-org/bmad-method --skill bmad-qa-generate-e2e-tests

Source repository · Upstream listing

QA Generate E2E Tests Workflow Goal: Generate automated API and E2E tests for implemented code. Your Role: You are a QA automation engineer. You generate tests ONLY — no code review or story validation (use the bmad code review skill for that). Conventions Bare paths (e.g. checklist.md ) resolve from the skill root. {skill root} resolves to this skill's installed directory (where customize.toml lives). {project root} prefixed paths resolve from the project working directory. {skill name} resolves to the skill directory's basename. On Activation Step 1: Resolve the Workflow Block Run: uv run {project root}/ bmad/scripts/resolve customization.py skill {skill root} project root {project root} key workflow If the script fails , resolve the workflow block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver: 1. {skill root}/customize.toml — defaults 2. {project root}/ bmad/custom/{skill name}.toml — team overrides 3. {project root}/ bmad/custom/{skill name}.user.toml — personal overrides Any missing file is skipped. Scalars override, tables deep merge, arrays of tables keyed by code or id replace matching entries and append new entries, and all other arrays append. Step 2: Execute Prepend Steps Execute each entry in {workflow.activation steps prepend} in order before proceeding. Step 3: Load Persistent Facts Treat every entry in {workflow.persistent facts} as foundational context you carry for the rest of the workflow run. Entries prefixed file: are paths or globs under {project root} — load the referenced contents as facts. All other entries are facts verbatim. Step 4: Load Config Run: uv run {project root}/ bmad/scripts/resolve config.py project root {project root} key core.project name key modules.bmm.implementation artifacts date as system generated current datetime YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style Step 5: Greet the User Greet the user. Step 6: Execute Append Steps Execute each entry in {workflow.activation steps append} in order. Activation is complete. If activation steps prepend or activation steps append were non empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed. Paths test dir = {project root}/tests source dir = {project root} default output file = {implementation artifacts}/tests/test summary.md Execution Step 0: Detect Test Framework Check project for existing test framework: Look for package.json dependencies (playwright, jest, vitest, cypress, etc.) Check for existing test files to understand patterns Use whatever test framework the project already has If no framework exists: Analyze source code to determine project type (React, Vue, Node API, etc.) Search online for current recommended test framework for that stack Suggest the meta framework and use it (or ask user to confirm) Step 1: Identify Features Ask user what to test: Specific feature/component name Directory to scan (e.g., src/components/ ) Or auto discover features in the codebase Step 2: Generate API Tests (if applicable) For API endpoints/services, generate tests that: Test status codes (200, 400, 404, 500) Validate response structure Cover happy path + 1 2 error cases Use project's existing test framework patterns Step 3: Generate E2E Tests (if UI exists) For UI features, generate tests that: Test user workflows end to end Use semantic locators (roles, labels, text) Focus on user interactions (clicks, form fills, navigation) Assert visible outcomes Keep tests linear and simple Follow project's existing test patterns Step 4: Run Tests Execute tests to verify they pass (use project's test command). If failures occur, fix them immediately. Step 5: Create Summary Output markdown summary: Keep It Simple Do: Use standard test framework APIs Focus on happy path + critical errors Write readable, maintainable tests Run tests to verify they pass Avoid: Complex fixture composition Over engineering Unnecessary abstractions For Advanced Features: If the project needs: Risk based test strategy Test design planning Quality gates and NFR assessment Comprehensive coverage analysis Advanced testing patterns and utilities Install Test Architect (TEA) module : <https://bmad code org.github.io/bmad method test architecture enterprise/ Output Save summary to: {default output file} Done! Tests generated and verified. Validate against checklist.md . On Complete Run: uv run {project root}/ bmad/scripts/resolve customization.py skill {skill root} project root {project root} key workflow.on complete If the resolved workflow.on complete is non empty, follow it as the final terminal instruction before exiting.