{"id":18168,"library":"bmad-method-test-architecture-enterprise","title":"BMAD Test Architecture Enterprise (TEA)","description":"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.","status":"active","version":"1.15.1","language":"javascript","source_language":"en","source_url":"https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise","tags":["javascript","bmad","test-architect","testing","quality","automation","playwright","test-engineering"],"install":[{"cmd":"npm install bmad-method-test-architecture-enterprise","lang":"bash","label":"npm"},{"cmd":"yarn add bmad-method-test-architecture-enterprise","lang":"bash","label":"yarn"},{"cmd":"pnpm add bmad-method-test-architecture-enterprise","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required runtime for BMAD installer and core workflows","package":"node","optional":false},{"reason":"Required for TEA agent scripts and knowledge base processing","package":"python","optional":false},{"reason":"Python package manager used for TEA dependencies","package":"uv","optional":false}],"imports":[{"note":"This package is not installed directly via npm. Install the 'bmad-method' CLI and select TEA interactively.","wrong":"npm install -g bmad-method-test-architecture-enterprise","symbol":"npx bmad-method install","correct":"Install via npx and select 'Test Architect' from module menu"},{"note":"TEA is a file-based agent system. There is no JavaScript importable module. Activation happens via BMAD workflow engine.","wrong":"Import from node_modules","symbol":"Test Architect agent activation","correct":"Workflow files in src/agents/bmad-tea/SKILL.md and src/workflows/testarch/"},{"note":"Customization is done via TOML files, not Node.js configuration files.","wrong":"Edit package.json or tsconfig.json","symbol":"customize.toml","correct":"Edit TEA customization via src/agents/bmad-tea/customize.toml or workflow-specific customize.toml"}],"quickstart":{"code":"# Install BMAD CLI\nnpx bmad-method install\n# Select 'Test Architect' from the module menu\n\n# After installation, invoke a TEA workflow from within BMAD context\n# Example: Teach Me Testing workflow\n# The agent 'Murat, Master Test Architect' will guide through steps\n\n# Verify installation\nls src/agents/bmad-tea/\nls src/workflows/testarch/","lang":"typescript","description":"Shows how to install TEA via BMAD CLI and verify the agent and workflow files are present."},"warnings":[{"fix":"Run: npx bmad-method install, then select 'Test Architect'.","message":"Package is not installed via npm install; must use npx bmad-method install and select TEA from menu.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Upgrade Node.js to >=20.0.0 and Python to >=3.10. Install uv package manager.","message":"Requires Node.js >=20.0.0 and Python >=3.10. Older versions of these runtimes will fail.","severity":"breaking","affected_versions":">=1.13.0"},{"fix":"Migrate customizations to TOML files under src/agents/bmad-tea/customize.toml or workflow-specific customize.toml.","message":"TOML customization replaced old customization pattern in v1.11.0. Existing customizations may break.","severity":"breaking","affected_versions":">=1.11.0"},{"fix":"Adopt the new TOML customization pattern; see docs at https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/","message":"old-TOML customization system removed in v1.12.3. Use new TOML customization pattern.","severity":"deprecated","affected_versions":">=1.12.3"},{"fix":"Follow workflow steps strictly in order. Do not skip step files.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use BMAD CLI to install and activate. No JS imports needed.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run: npx bmad-method install (requires Node.js >=20). If persists, clear npx cache: npx clear-cache.","cause":"BMAD CLI not installed globally or npx cache issue.","error":"Command 'npx bmad-method install' not found"},{"fix":"Update BMAD CLI: npx bmad-method update. Ensure internet access.","cause":"Outdated BMAD CLI version or network issue fetching module list.","error":"Module 'Test Architect' not displayed in installation menu"},{"fix":"Install Python 3.10+ via pyenv or system package manager. Set python3 as default.","cause":"System Python version is too old.","error":"Python version must be >=3.10"},{"fix":"Re-run the workflow from the beginning. Do not skip any step files. Ensure each step completes before proceeding.","cause":"User skipped steps or provided instructions that conflict with workflow.","error":"Model did not follow workflow steps correctly"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}