Test Engineering Architect (TEA)

Test Engineering Architect (TEA)

TEA is a BMad module for test strategy and automation. Its eight skills cover learning, test design, setup, automation, evaluation, review, and release decisions. You can use it on its own or alongside BMad Method.

Risk assessment, NFR planning, traceability, and release gates apply across stacks. Generation and execution support vary by target. See the execution-target matrix for the supported stacks and their limits.

Install

npx skills add bmad-code-org/bmad-method-test-architecture-enterprise

Setup needs uv and BMad Method’s bmad and bmod-core-tools skills. If those skills are missing, install them:

npx skills add bmad-code-org/BMAD-METHOD --skill bmad bmod-core-tools

Then type bmad setup tea in your assistant chat to answer TEA’s setup questions. See Configuration for the settings and output folders.

Run /bmad-tea-test-design in Claude Code, Cursor, or Windsurf, or $bmad-tea-test-design in Codex. For the agent menu, load /bmad-tea or $bmad-tea and type TD. Each skill also works directly in a fresh session. Test Design asks whether to plan the system or one epic, then writes its plan to test-design/ under your test_artifacts folder.

Choose a starting point

• TEA Lite adds coverage to an existing project.
• TEA Academy teaches testing through seven sessions.
• TEA Overview shows the skill order and BMad lifecycle.
• Evaluate Your First Skill runs an evaluation from requirements to an accepted baseline.
• Enterprise projects and existing test suites have their own guides.
• Custom skills explains how to extend the agent menu.

Skills

Use the command in chat. On Codex, replace the leading / with $. Menu codes work after loading bmad-tea. Eight direct capability commands start the eight workflows. See Commands for every invocation and menu code.

• Automate: Generate red acceptance scaffolds or expand coverage.
• Test Review: Audit test quality and score findings.
• Test Design: Plan risks, coverage, and NFR evidence.
• Framework: Set up a test framework, CI, or both.
• NFR: Audit implemented NFR evidence.
• Trace: Map requirements to tests and decide a release gate.
• Teach Me Testing: Learn testing through seven sessions.
• Evaluate: Build and run a behavioral evaluation.

The agent’s AT code selects Automate red mode for acceptance tests before implementation, and CI selects Framework CI setup for pipelines.

The agent menu’s GATE intent routes you through test review, NFR evidence audit, and trace Phase 2. It produces no artifact of its own.

Report problems through GitHub Issues.