BMAD Test Architecture Enterprise (TEA)

1.15.1 verified Sat Apr 25 auth: no javascript

TEA (Test Engineering Architect) is a standalone BMAD module for risk-based test strategy, test automation guidance, and release gate decisions. Current stable version is 1.15.1, with bi-weekly releases. It provides a single expert agent (Murat, Master Test Architect) and nine workflows covering test education, framework setup, ATDD, automation, traceability, NFR assessment, CI guidance, and test review. Key differentiators: knowledge-base-driven consistent outputs, risk-based P0-P3 prioritization, optional Playwright Utils/CLI/MCP browser automation, and fully context-window-executed workflow engine without external orchestrator. Requires Node.js >=20.0.0, Python >=3.10, and uv package manager.

Common errors

error Command 'npx bmad-method install' not found ↓

cause BMAD CLI not installed globally or npx cache issue.

fix

Run: npx bmad-method install (requires Node.js >=20). If persists, clear npx cache: npx clear-cache.

error Module 'Test Architect' not displayed in installation menu ↓

cause Outdated BMAD CLI version or network issue fetching module list.

fix

Update BMAD CLI: npx bmad-method update. Ensure internet access.

error Python version must be >=3.10 ↓

cause System Python version is too old.

fix

Install Python 3.10+ via pyenv or system package manager. Set python3 as default.

error Model did not follow workflow steps correctly ↓

cause User skipped steps or provided instructions that conflict with workflow.

fix

Re-run the workflow from the beginning. Do not skip any step files. Ensure each step completes before proceeding.

Warnings

breaking Package is not installed via npm install; must use npx bmad-method install and select TEA from menu. ↓

fix Run: npx bmad-method install, then select 'Test Architect'.

breaking Requires Node.js >=20.0.0 and Python >=3.10. Older versions of these runtimes will fail. ↓

fix Upgrade Node.js to >=20.0.0 and Python to >=3.10. Install uv package manager.

breaking TOML customization replaced old customization pattern in v1.11.0. Existing customizations may break. ↓

fix Migrate customizations to TOML files under src/agents/bmad-tea/customize.toml or workflow-specific customize.toml.

deprecated old-TOML customization system removed in v1.12.3. Use new TOML customization pattern. ↓

fix Adopt the new TOML customization pattern; see docs at https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/

gotcha TEA runs entirely inside LLM context window — no external orchestrator. All steps are sequential and just-in-time. Skipping or reordering steps may produce inconsistent results. ↓

fix Follow workflow steps strictly in order. Do not skip step files.

gotcha The package is not a JavaScript library; it's a set of Markdown/Toml/Python files for AI agent consumption. Do not attempt to import it as a Node module. ↓

fix Use BMAD CLI to install and activate. No JS imports needed.

Install

npm install bmad-method-test-architecture-enterprise

yarn add bmad-method-test-architecture-enterprise

pnpm add bmad-method-test-architecture-enterprise

Imports

npx bmad-method install
wrong
```
npm install -g bmad-method-test-architecture-enterprise
```
correct
```
Install via npx and select 'Test Architect' from module menu
```
This package is not installed directly via npm. Install the 'bmad-method' CLI and select TEA interactively.
Test Architect agent activation
wrong
```
Import from node_modules
```
correct
```
Workflow files in src/agents/bmad-tea/SKILL.md and src/workflows/testarch/
```
TEA is a file-based agent system. There is no JavaScript importable module. Activation happens via BMAD workflow engine.

customize.toml

wrong

Edit package.json or tsconfig.json

correct

Edit TEA customization via src/agents/bmad-tea/customize.toml or workflow-specific customize.toml

Customization is done via TOML files, not Node.js configuration files.

Quickstart

Shows how to install TEA via BMAD CLI and verify the agent and workflow files are present.

# Install BMAD CLI
npx bmad-method install
# Select 'Test Architect' from the module menu

# After installation, invoke a TEA workflow from within BMAD context
# Example: Teach Me Testing workflow
# The agent 'Murat, Master Test Architect' will guide through steps

# Verify installation
ls src/agents/bmad-tea/
ls src/workflows/testarch/