bmad-testarch-framework

Scaffolds Playwright, Cypress, or backend test frameworks with fixtures, factories, and configuration.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-testarch-framework-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-framework
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-testarch-framework
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-testarch-framework-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a production-grade test framework from scratch involves dozens of decisions—framework choice, directory layout, fixture architecture, data factories, CI reporters, and environment configuration—that teams often get wrong or leave inconsistent. ## Core Features & Use Cases - Stack-Aware Framework Selection: Auto-detects frontend, backend, fullstack, or mobile projects from manifests (package.json, pyproject.toml, go.mod, etc.) and selects Playwright, Cypress, pytest, JUnit, Go test, xUnit, RSpec, or Maestro accordingly. - Complete Scaffold Generation: Creates test directory structures, framework configs with tuned timeouts and reporters, .env templates, fixture indexes with mergeTests, faker-based data factories with auto-cleanup, and sample tests following Given-When-Then structure. - Tri-Modal Workflow: Supports Create, Resume (with progress frontmatter tracking), Validate (against a full checklist), and Edit modes, plus optional write-time enforcement hooks for Claude Code. - Use Case: A team starting a React + Vite storefront runs the workflow and receives a Playwright setup with merged fixtures, an auth fixture, an order factory, sample UI and API tests, package.json scripts, and a tests/README.md—validated against a quality checklist. ## Quick Start Ask the agent to set up a test framework for this project, for example by saying "let's setup test framework", and follow the Create mode prompts.

Frequently Asked Questions about bmad-testarch-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Playwright test framework for a new project?

Run the framework workflow in Create mode: it detects your stack from package.json, scaffolds tests/e2e and tests/support directories, generates playwright.config.ts with tuned timeouts and reporters, and adds fixtures, factories, sample tests, and a test:e2e script.

Playwright vs Cypress: which should I choose for E2E testing?

The workflow defaults to Playwright for large repos, multi-browser needs, heavy API plus UI integration, and CI parallelism. It recommends Cypress for small teams prioritizing developer experience, component testing, or simpler setup. An explicit config preference overrides auto-detection.

Does this test setup support backend languages like Python, Java, or Go?

Yes. Backend stacks get idiomatic scaffolding: pytest with conftest.py for Python, JUnit 5 with src/test/java for Java, Go test conventions for Go, xUnit for .NET, and RSpec for Ruby. Mobile projects get Maestro flows plus the app's unit test framework.

Can I resume an interrupted test framework setup?

Yes. Each completed step saves progress frontmatter to a progress file. Selecting Resume mode loads that file, verifies previously created artifacts still exist on disk, shows a progress dashboard, and routes to the next incomplete step without re-running finished work.

Why did the workflow skip Pact contract test scaffolding?

Contract testing artifacts are gated on relevance: a real consumer-provider boundary must exist in or be started by the repo. If the gate does not open, no Pact files are created, and the summary notes the framework workflow can add them later.