bmad-testarch-framework

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

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-testarch-framework-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-framework
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/bmad-testarch-framework
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-testarch-framework-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a test framework from scratch involves dozens of decisions—directory layout, config timeouts, fixture architecture, data factories, CI reporters—that are easy to get wrong and tedious to repeat. This Skill automates the entire initialization so a project gets a consistent, convention-following test setup in one guided run. ## Core Features & Use Cases - Stack Auto-Detection: Scans project manifests (package.json, pyproject.toml, go.mod, pom.xml, etc.) to detect frontend, backend, fullstack, or mobile stacks and selects the right framework (Playwright, Cypress, pytest, JUnit, Go test, xUnit, RSpec, Maestro). - Complete Scaffolding: Creates test directories, framework config with tuned timeouts and reporters, .env.example, fixture indexes with mergeTests, faker-based data factories with auto-cleanup, and sample tests following Given-When-Then structure. - Write-Time Enforcement: Installs a Claude Code hook (tea-enforce.cjs) that blocks hard-coded waits and other test-quality violations at write time, with stack-scoped globs in .tea/enforce-config.json. - Use Case: A team starting a React + Vite storefront runs the workflow and receives a Playwright setup with auth fixtures, an order factory, sample API and UI tests, package.json scripts, and a tests/README.md—validated against a built-in 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 in an existing 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 fixture and factory files plus a sample test.

Playwright vs Cypress: which does the framework setup choose?

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, and respects an explicit config.test_framework override.

Does the test framework setup support backend languages like Python or Go?

Yes. Backend stacks get idiomatic setups: pytest with pyproject.toml config for Python, JUnit 5 for Java, Go test conventions for Go, xUnit for .NET, and RSpec for Ruby, each with language-appropriate directories, scripts, and sample tests.

Can I resume an interrupted test framework setup?

Yes. The workflow saves progress with YAML frontmatter after each step. Selecting Resume mode loads the progress file, verifies previously created artifacts still exist on disk, and routes to the next incomplete step without re-running finished work.

What does the write-time enforcement hook block in test files?

The tea-enforce hook blocks patterns like hard-coded waits and oversized test files at write time, using globs scoped to your detected stack in .tea/enforce-config.json. It fails open on errors and individual rules can be disabled via disabledRules with a documented reason.