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.