ma-agents 2.22.1 → 3.0.0

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/steps-c/step-04-session-07.md

@@ -14,7 +14,7 @@ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 
 ## STEP GOAL:
 
-To provide menu-driven exploration of 35 TEA knowledge fragments organized by category, allowing deep-dive into specific advanced topics on-demand.
+To provide menu-driven exploration of 42 TEA knowledge fragments organized by category, allowing deep-dive into specific advanced topics on-demand.
 
 ## MANDATORY EXECUTION RULES (READ FIRST):
 
@@ -48,7 +48,7 @@ To provide menu-driven exploration of 35 TEA knowledge fragments organized by ca
 
 "🧪 **Session 7: Advanced Patterns** (Ongoing Exploration)
 
-**Objective:** Deep-dive into 34 TEA knowledge fragments
+**Objective:** Deep-dive into 42 TEA knowledge fragments
 
 **This session is different:**
 
@@ -57,7 +57,7 @@ To provide menu-driven exploration of 35 TEA knowledge fragments organized by ca
 - Can revisit this session anytime
 - No quiz - this is reference learning
 
-**35 Knowledge Fragments organized by category:**
+**42 Knowledge Fragments organized by category:**
 
 Let's explore!"
 
@@ -81,7 +81,7 @@ Set session-07-advanced `status: 'in-progress'` (only first time).
 - selector-resilience.md - Robust selectors
 - timing-debugging.md - Race condition fixes
 
-**2. Playwright Utils (11 fragments)**
+**2. Playwright Utils (19 fragments)**
 
 - overview.md - Playwright Utils overview
 - api-request.md - Typed HTTP client
@@ -93,6 +93,14 @@ Set session-07-advanced `status: 'in-progress'` (only first time).
 - burn-in.md - Smart test selection
 - network-error-monitor.md - HTTP error detection
 - contract-testing.md - Pact integration
+- pactjs-utils-overview.md - Pact.js Utils overview
+- pactjs-utils-consumer-helpers.md - Consumer-side Pact helpers
+- pactjs-utils-provider-verifier.md - Provider verification
+- pactjs-utils-request-filter.md - Auth injection request filter
+- pact-mcp.md - SmartBear MCP for PactFlow
+- pact-consumer-framework-setup.md - Consumer CDC framework setup
+- pact-consumer-di.md - DI pattern for Pact consumers
+- playwright-cli.md - CLI for AI browser automation
 - visual-debugging.md - Trace viewer workflows
 
 **3. Configuration & Governance (6 fragments)**
@@ -118,7 +126,7 @@ Set session-07-advanced `status: 'in-progress'` (only first time).
 - auth-session.md - Token persistence
 - error-handling.md - Exception handling
 
-**GitHub Repository:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge>
+**GitHub Repository:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>
 
 **Select a category (1-5) or specific fragment to explore, or [X] to finish:**"
 
@@ -159,7 +167,7 @@ After user selects X (finish exploration):
 
 **Remember:** You can return to Session 7 anytime to explore more fragments!
 
-**GitHub Knowledge Base:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge>"
+**GitHub Knowledge Base:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>"
 
 ### 6. Generate Session Notes
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/steps-c/step-05-completion.md

@@ -210,14 +210,14 @@ All session notes and progress tracking available at:
 1. **Apply TEA to your project:** Start with Framework setup workflow
 2. **Run TEA workflows:** Test Design → ATDD/Automate → Test Review
 3. **Share knowledge:** Help team members through TEA Academy
-4. **Explore knowledge fragments:** 35 fragments for just-in-time learning
+4. **Explore knowledge fragments:** 42 fragments for just-in-time learning
 5. **Contribute improvements:** Share feedback on TEA methodology
 
 **TEA Resources:**
 
 - **Documentation:** https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/
 - **Knowledge Base:** https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/knowledge-base/
-- **GitHub Fragments:** https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge
+- **GitHub Fragments:** https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge
 
 ---
 
@@ -291,7 +291,7 @@ You've successfully completed the entire TEA Academy curriculum!
 - Apply risk-based testing (P0-P3 prioritization)
 - Implement architecture patterns (fixtures, network-first)
 - Maintain quality through Test Review and Trace
-- Explore 35 knowledge fragments as needed
+- Explore 42 knowledge fragments as needed
 
 **Next Steps:**
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/templates/certificate-template.md

@@ -54,7 +54,7 @@ average_score: { { average_score } }
 - ✅ **Test Design:** Risk assessment, coverage planning, P0-P3 prioritization
 - ✅ **Test Development:** ATDD red-green approach, test automation
 - ✅ **Quality Assurance:** Test review, traceability, NFR assessment
-- ✅ **Advanced Techniques:** 35 knowledge fragments explored
+- ✅ **Advanced Techniques:** 42 knowledge fragments explored
 
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/workflow-plan-teach-me-testing.md

@@ -21,7 +21,7 @@ foundationCompletedDate: 2026-01-28
 ## Discovery Notes
 
 **User's Vision:**
-Create an ongoing learning companion that teaches testing progressively through a structured curriculum. Users at the company (and beyond) lack testing knowledge regardless of experience level - from hobbyist beginners to experienced VPs. The TEA (Test Architecture Enterprise) module has extensive documentation (~24k lines, 200 files, 9 workflows, 35 knowledge fragments), but manual teaching doesn't scale. This workflow solves that by providing self-paced, structured learning with state persistence across multiple sessions.
+Create an ongoing learning companion that teaches testing progressively through a structured curriculum. Users at the company (and beyond) lack testing knowledge regardless of experience level - from hobbyist beginners to experienced VPs. The TEA (Test Architecture Enterprise) module has extensive documentation (~24k lines, 200 files, 9 workflows, 42 knowledge fragments), but manual teaching doesn't scale. This workflow solves that by providing self-paced, structured learning with state persistence across multiple sessions.
 
 **Who It's For:**
 
@@ -163,7 +163,7 @@ Create an ongoing learning companion that teaches testing progressively through
 **LLM Features:**
 
 - **Web-Browsing:** Included - Use case: Safety net for framework updates (Cypress, Jest, newer Playwright versions) and frameworks not covered in TEA docs. Motto: "Only reach out when you don't have the info"
-- **File I/O:** Included - Operations: Read TEA docs (/docs/_.md), read knowledge fragments (/src/testarch/knowledge/_.md), write progress file ({user}-tea-progress.yaml), write session notes, write completion certificate
+- **File I/O:** Included - Operations: Read TEA docs (/docs/_.md), read knowledge fragments (/src/agents/bmad-tea/resources/knowledge/_.md), write progress file ({user}-tea-progress.yaml), write session notes, write completion certificate
 - **Sub-Agents:** Excluded - Sessions are linear teaching steps handled by TEA agent, not complex specialized tasks requiring delegation
 - **Sub-Processes:** Excluded - Learning is sequential (one session at a time), no parallel processing needed
 
@@ -384,7 +384,7 @@ teach-me-testing/
 **Expertise:**
 
 - Deep knowledge of testing principles (risk-based, test pyramid, types)
-- Expert in TEA methodology (9 workflows, architecture patterns, 35 knowledge fragments)
+- Expert in TEA methodology (9 workflows, architecture patterns, 42 knowledge fragments)
 - Familiar with Playwright, test automation, CI/CD
 - Teaching pedagogy: progressive learning, knowledge validation, role-based examples
 
@@ -459,13 +459,13 @@ teach-me-testing/
 
 **Session 7 Special Handling:**
 
-- Exploratory menu-driven deep-dive into 35 knowledge fragments
+- Exploratory menu-driven deep-dive into 42 knowledge fragments
 - Organized by categories (Testing Patterns, Playwright Utils, Config/Governance, etc.)
 - Links to GitHub for browsing
 
 **Content Sources (Triple Reference System):**
 
-- Local files: `/docs/*.md`, `/src/testarch/knowledge/*.md`
+- Local files: `/docs/*.md`, `/src/agents/bmad-tea/resources/knowledge/*.md`
 - Online docs: `<https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/`>
 - GitHub fragments: Direct links to knowledge fragment source files
 
@@ -720,7 +720,7 @@ teach-me-testing/
 **Teaching Topics:**
 
 - What is TEA and why it exists
-- 9 workflows + 35 knowledge fragments
+- 9 workflows + 42 knowledge fragments
 - Quality standards (Definition of Done)
 - Risk-based testing (P0-P3 matrix)
 - TEA engagement models (Lite/Solo/Integrated/Enterprise/Brownfield)
@@ -788,7 +788,7 @@ teach-me-testing/
 **Created:** 2026-01-28
 **Files:** `steps-c/step-04-session-07.md` ✓
 **Session:** Advanced Patterns (ongoing)
-**Format:** Menu-driven exploration of 35 knowledge fragments
+**Format:** Menu-driven exploration of 42 knowledge fragments
 **Categories:** Testing Patterns (9), Playwright Utils (11), Config/Governance (6), Quality Frameworks (5), Auth/Security (3)
 **No Quiz:** Exploratory session, score: 100 on completion
 **Special:** Repeatable, user can explore multiple fragments, returns to hub
@@ -840,7 +840,7 @@ teach-me-testing/
 2. `data/role-paths.yaml` ✓ - Role customizations for QA/Dev/Lead/VP with focus areas and teaching adaptations
 3. `data/session-content-map.yaml` ✓ - Maps sessions to TEA docs, knowledge fragments, online URLs, workflows
 4. `data/quiz-questions.yaml` ✓ - Question bank for sessions 1-6 (session 7 is exploratory, no quiz)
-5. `data/tea-resources-index.yaml` ✓ - Comprehensive index of 32 docs + 35 knowledge fragments with GitHub links
+5. `data/tea-resources-index.yaml` ✓ - Comprehensive index of 32 docs + 42 knowledge fragments with GitHub links
 
 **All 5 data files complete.**
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-atdd/atdd-checklist-template.md

@@ -364,7 +364,7 @@ See `tea-index.csv` for complete knowledge fragment mapping.
 - Ask in team standup
 - Tag @{tea_agent_username} in Slack/Discord
 - Refer to `./bmm/docs/tea-README.md` for workflow documentation
-- Consult `./bmm/testarch/knowledge` for testing best practices
+- Consult `_bmad/tea/agents/bmad-tea/resources/knowledge` for testing best practices
 
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-atdd/steps-c/step-01-preflight-and-context.md

@@ -3,7 +3,7 @@ name: 'step-01-preflight-and-context'
 description: 'Verify prerequisites and load story, framework, and knowledge base'
 outputFile: '{test_artifacts}/atdd-checklist-{story_id}.md'
 nextStepFile: './step-02-generation-mode.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 ---
 
 # Step 1: Preflight & Context Loading
@@ -117,7 +117,7 @@ Load fragments based on their `tier` classification in `tea-index.csv`:
 
 **If `tea_use_pactjs_utils` is enabled** (and `{detected_stack}` is `backend` or `fullstack`, or microservices indicators detected):
 
-Load: `pactjs-utils-overview.md`, `pactjs-utils-consumer-helpers.md`, `pactjs-utils-provider-verifier.md`, `pactjs-utils-request-filter.md`
+Load: `pactjs-utils-overview.md`, `pactjs-utils-consumer-helpers.md`, `pactjs-utils-provider-verifier.md`, `pactjs-utils-request-filter.md`, `pact-consumer-di.md`
 
 **If `tea_use_pactjs_utils` is disabled** but contract testing is relevant:
 
@@ -170,7 +170,7 @@ Use `{knowledgeIndex}` to load:
 
 **Pact.js Utils (if enabled):**
 
-- `pactjs-utils-overview.md`, `pactjs-utils-consumer-helpers.md`, `pactjs-utils-provider-verifier.md`, `pactjs-utils-request-filter.md`
+- `pactjs-utils-overview.md`, `pactjs-utils-consumer-helpers.md`, `pactjs-utils-provider-verifier.md`, `pactjs-utils-request-filter.md`, `pact-consumer-di.md`
 
 **Contract Testing (if pactjs-utils disabled but relevant):**
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-atdd/steps-c/step-04a-subagent-api-failing.md

@@ -19,6 +19,8 @@ This is an **isolated subagent** running in parallel with E2E failing test gener
 - Config: test framework, Playwright Utils enabled/disabled, Pact.js Utils enabled/disabled (`use_pactjs_utils`), Pact MCP mode (`pact_mcp`)
 - Provider Endpoint Map (if `use_pactjs_utils` enabled and provider source accessible)
 
+**If `use_pactjs_utils` is enabled:** Also generate consumer contract tests alongside API tests. Use the loaded pactjs-utils fragments (`pactjs-utils-overview`, `pactjs-utils-consumer-helpers`, `pactjs-utils-provider-verifier`, `pactjs-utils-request-filter`, `pact-consumer-di`) for patterns. If `pact_mcp` is `"mcp"`, use SmartBear MCP tools (Fetch Provider States, Generate Pact Tests) to inform test generation.
+
 **Your task:** Generate API tests that will FAIL because the feature is not implemented yet (TDD RED PHASE).
 
 ---
@@ -227,7 +229,13 @@ Write JSON to temp file: `/tmp/tea-atdd-api-tests-{{timestamp}}.json`
     }
   ],
   "fixture_needs": ["userDataFactory"],
-  "knowledge_fragments_used": ["api-request", "data-factories", "api-testing-patterns"],
+  "knowledge_fragments_used": [
+    "api-request",
+    "data-factories",
+    "api-testing-patterns",
+    "pactjs-utils-consumer-helpers",
+    "pact-consumer-di"
+  ],
   "test_count": 3,
   "tdd_phase": "RED",
   "provider_scrutiny": "completed",

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-automate/steps-c/step-01-preflight-and-context.md

@@ -3,7 +3,7 @@ name: 'step-01-preflight-and-context'
 description: 'Determine mode, verify framework, and load context and knowledge'
 outputFile: '{test_artifacts}/automation-summary.md'
 nextStepFile: './step-02-identify-targets.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 ---
 
 # Step 1: Preflight & Context Loading

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-automate/steps-c/step-03b-subagent-e2e.md

@@ -14,7 +14,7 @@ This is an **isolated subagent** running in parallel with API test generation.
 **What you have from parent workflow:**
 
 - Target features/user journeys identified in Step 2
-- Knowledge fragments loaded: fixture-architecture, network-first, selector-resilience
+- Knowledge fragments loaded: fixture-architecture, network-first, selector-resilience, playwright-cli
 - Config: test framework, Playwright Utils enabled/disabled
 - Coverage plan: which user journeys need E2E testing
 
@@ -160,7 +160,7 @@ Write JSON to temp file: `/tmp/tea-automate-e2e-tests-{{timestamp}}.json`
     }
   ],
   "fixture_needs": ["authenticatedUserFixture", "paymentMockFixture", "checkoutDataFixture"],
-  "knowledge_fragments_used": ["fixture-architecture", "network-first", "selector-resilience"],
+  "knowledge_fragments_used": ["fixture-architecture", "network-first", "selector-resilience", "playwright-cli"],
   "test_count": 15,
   "summary": "Generated 15 E2E test cases covering 5 user journeys"
 }

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-ci/steps-c/step-02-generate-pipeline.md

@@ -2,6 +2,7 @@
 name: 'step-02-generate-pipeline'
 description: 'Generate CI pipeline configuration with adaptive orchestration (agent-team, subagent, or sequential)'
 nextStepFile: './step-03-configure-quality-gates.md'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/ci-pipeline-progress.md'
 ---
 
@@ -188,6 +189,11 @@ Write the selected pipeline configuration to the resolved output path from step
 
 ### Contract Testing Pipeline (if `tea_use_pactjs_utils` enabled)
 
+**If `tea_use_pactjs_utils` is enabled**, use `{knowledgeIndex}` to load:
+
+- `pactjs-utils-provider-verifier.md` — `buildVerifierOptions`, broker config, and breaking change patterns for CI provider verification
+- `pactjs-utils-request-filter.md` — `createRequestFilter` auth injection patterns for CI pipeline auth setup
+
 When `tea_use_pactjs_utils` is enabled, add a `contract-test` stage after `test`:
 
 **Required env block** (add to the generated pipeline):

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-ci/steps-c/step-03-configure-quality-gates.md

@@ -2,7 +2,7 @@
 name: 'step-03-configure-quality-gates'
 description: 'Configure burn-in, quality gates, and notifications'
 nextStepFile: './step-04-validate-and-summary.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/ci-pipeline-progress.md'
 ---
 
@@ -83,6 +83,11 @@ Define:
 
 **Contract testing gate** (if `tea_use_pactjs_utils` is enabled):
 
+Use `{knowledgeIndex}` to load:
+
+- `pactjs-utils-provider-verifier.md` — `buildVerifierOptions`, broker config, and breaking change patterns for provider verification gates
+- `pactjs-utils-request-filter.md` — `createRequestFilter` auth injection patterns for CI pipeline auth setup
+
 - **can-i-deploy must pass** before any deployment to staging or production
 - Block the deployment pipeline if contract verification fails
 - Treat consumer pact publishing failures as CI failures (contracts must stay up-to-date)

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-framework/steps-c/step-03-scaffold-framework.md

@@ -2,7 +2,7 @@
 name: 'step-03-scaffold-framework'
 description: 'Create framework scaffold with adaptive orchestration (agent-team, subagent, or sequential)'
 nextStepFile: './step-04-docs-and-scripts.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/framework-setup-progress.md'
 ---
 
@@ -202,7 +202,8 @@ Read `{config_source}` and use `{knowledgeIndex}` to load fragments based on `co
 
 **If Playwright Utils enabled:**
 
-- `overview.md`, `fixtures-composition.md`, `auth-session.md`, `api-request.md`, `burn-in.md`, `network-error-monitor.md`, `data-factories.md`
+- `overview.md`, `fixtures-composition.md`, `auth-session.md`, `api-request.md`, `recurse.md`, `log.md`, `burn-in.md`, `network-error-monitor.md`, `data-factories.md`
+- If `{detected_stack}` is `frontend` or `fullstack`, also load `intercept-network-call.md`
 - Recommend installing `@seontechnologies/playwright-utils`
 
 **If disabled:**

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-nfr/steps-c/step-01-load-context.md

@@ -2,7 +2,7 @@
 name: 'step-01-load-context'
 description: 'Load NFR requirements, evidence sources, and knowledge base'
 nextStepFile: './step-02-define-thresholds.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/nfr-assessment.md'
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/steps-c/step-02-load-context.md

@@ -2,7 +2,7 @@
 name: 'step-02-load-context'
 description: 'Load documents, configuration, and knowledge fragments for the chosen mode'
 nextStepFile: './step-03-risk-and-testability.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/test-design-progress.md'
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-review/steps-c/step-01-load-context.md

@@ -2,7 +2,7 @@
 name: 'step-01-load-context'
 description: 'Load knowledge base, determine scope, and gather context'
 nextStepFile: './step-02-discover-tests.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/test-review.md'
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-review/test-review-template.md

@@ -257,19 +257,19 @@ Grade:                   {grade}
 
 This review consulted the following knowledge base fragments:
 
-- **[test-quality.md](../../../testarch/knowledge/test-quality.md)** - Definition of Done for tests (no hard waits, <300 lines, <1.5 min, self-cleaning)
-- **[fixture-architecture.md](../../../testarch/knowledge/fixture-architecture.md)** - Pure function → Fixture → mergeTests pattern
-- **[network-first.md](../../../testarch/knowledge/network-first.md)** - Route intercept before navigate (race condition prevention)
-- **[data-factories.md](../../../testarch/knowledge/data-factories.md)** - Factory functions with overrides, API-first setup
-- **[test-levels-framework.md](../../../testarch/knowledge/test-levels-framework.md)** - E2E vs API vs Component vs Unit appropriateness
-- **[tdd-cycles.md](../../../testarch/knowledge/tdd-cycles.md)** - Red-Green-Refactor patterns
-- **[selective-testing.md](../../../testarch/knowledge/selective-testing.md)** - Duplicate coverage detection
-- **[ci-burn-in.md](../../../testarch/knowledge/ci-burn-in.md)** - Flakiness detection patterns (10-iteration loop)
-- **[test-priorities.md](../../../testarch/knowledge/test-priorities.md)** - P0/P1/P2/P3 classification framework
+- **[test-quality.md](../../../agents/bmad-tea/resources/knowledge/test-quality.md)** - Definition of Done for tests (no hard waits, <300 lines, <1.5 min, self-cleaning)
+- **[fixture-architecture.md](../../../agents/bmad-tea/resources/knowledge/fixture-architecture.md)** - Pure function → Fixture → mergeTests pattern
+- **[network-first.md](../../../agents/bmad-tea/resources/knowledge/network-first.md)** - Route intercept before navigate (race condition prevention)
+- **[data-factories.md](../../../agents/bmad-tea/resources/knowledge/data-factories.md)** - Factory functions with overrides, API-first setup
+- **[test-levels-framework.md](../../../agents/bmad-tea/resources/knowledge/test-levels-framework.md)** - E2E vs API vs Component vs Unit appropriateness
+- **[component-tdd.md](../../../agents/bmad-tea/resources/knowledge/component-tdd.md)** - Red-Green-Refactor patterns
+- **[selective-testing.md](../../../agents/bmad-tea/resources/knowledge/selective-testing.md)** - Duplicate coverage detection
+- **[ci-burn-in.md](../../../agents/bmad-tea/resources/knowledge/ci-burn-in.md)** - Flakiness detection patterns (10-iteration loop)
+- **[test-priorities-matrix.md](../../../agents/bmad-tea/resources/knowledge/test-priorities-matrix.md)** - P0/P1/P2/P3 classification framework
 
 For coverage mapping, consult `trace` workflow outputs.
 
-See [tea-index.csv](../../../testarch/tea-index.csv) for complete knowledge base.
+See [tea-index.csv](../../../agents/bmad-tea/resources/tea-index.csv) for complete knowledge base.
 
 ---
 
@@ -379,7 +379,7 @@ See [tea-index.csv](../../../testarch/tea-index.csv) for complete knowledge base
 
 If you have questions or feedback on this review:
 
-1. Review patterns in knowledge base: `testarch/knowledge/`
+1. Review patterns in knowledge base: `../../../agents/bmad-tea/resources/knowledge/`
 2. Consult tea-index.csv for detailed guidance
 3. Request clarification on specific violations
 4. Pair with QA engineer to apply patterns

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/steps-c/step-01-load-context.md

@@ -2,7 +2,7 @@
 name: 'step-01-load-context'
 description: 'Load requirements, knowledge base, and related artifacts'
 nextStepFile: './step-02-discover-tests.md'
-knowledgeIndex: '{project-root}/_bmad/tea/testarch/tea-index.csv'
+knowledgeIndex: '{project-root}/_bmad/tea/agents/bmad-tea/resources/tea-index.csv'
 outputFile: '{test_artifacts}/traceability-report.md'
 ---
 

package/lib/bmad-cache/tea/test/test-installation-components.js

@@ -75,6 +75,16 @@ async function runTests() {
     assert(moduleYaml.name === 'Test Architect', 'module.yaml has correct name');
     assert(typeof moduleYaml.description === 'string' && moduleYaml.description.length > 0, 'module.yaml has description');
     assert(typeof moduleYaml.default_selected === 'boolean', 'module.yaml has boolean default_selected');
+    assert(moduleYaml.tea_use_pactjs_utils.default === false, 'module.yaml defaults Pact.js Utils to false');
+    assert(moduleYaml.tea_pact_mcp.default === 'none', 'module.yaml defaults Pact MCP to none');
+    assert(
+      moduleYaml.tea_use_pactjs_utils.prompt.includes('consumer-driven contract testing'),
+      'module.yaml Pact.js Utils prompt explains CDC intent',
+    );
+    assert(
+      moduleYaml.tea_pact_mcp.prompt.includes('Only needed if you already use a broker'),
+      'module.yaml Pact MCP prompt explains broker prerequisite',
+    );
   } catch (error) {
     assert(false, 'module.yaml loads and validates', error.message);
   }
@@ -82,34 +92,72 @@ async function runTests() {
   console.log('');
 
   // ============================================================
-  // Test 2: TEA Agent YAML Structure
+  // Test 2: TEA Agent Native Skill Structure
   // ============================================================
-  console.log(`${colors.yellow}Test Suite 2: TEA Agent Structure${colors.reset}\n`);
+  console.log(`${colors.yellow}Test Suite 2: TEA Agent Native Skill Structure${colors.reset}\n`);
 
   try {
-    const teaAgentPath = path.join(projectRoot, 'src/agents/tea.agent.yaml');
-
-    if (await pathExists(teaAgentPath)) {
-      const teaAgent = yaml.load(await fs.readFile(teaAgentPath, 'utf8'));
-
-      assert(teaAgent.agent !== undefined, 'tea.agent.yaml has agent root key');
-      assert(teaAgent.agent.metadata !== undefined, 'TEA agent has metadata section');
-      assert(teaAgent.agent.metadata.module === 'tea', 'TEA agent metadata has module: tea');
-      assert(teaAgent.agent.metadata.id.includes('_bmad/tea/'), 'TEA agent id references _bmad/tea/ path');
-      assert(teaAgent.agent.persona !== undefined, 'TEA agent has persona section');
-      assert(teaAgent.agent.critical_actions !== undefined, 'TEA agent has critical_actions');
-      assert(teaAgent.agent.menu !== undefined, 'TEA agent has menu');
-      assert(Array.isArray(teaAgent.agent.menu) && teaAgent.agent.menu.length === 9, 'TEA agent menu has 9 workflows');
+    const skillDir = path.join(projectRoot, 'src/agents/bmad-tea');
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    const manifestPath = path.join(skillDir, 'bmad-skill-manifest.yaml');
+
+    // Validate SKILL.md exists and has required sections
+    if (await pathExists(skillMdPath)) {
+      const skillContent = await fs.readFile(skillMdPath, 'utf8');
+
+      assert(skillContent.includes('name: bmad-tea'), 'SKILL.md has correct skill name in frontmatter');
+      assert(skillContent.includes('## Identity'), 'SKILL.md has Identity section');
+      assert(skillContent.includes('## Principles'), 'SKILL.md has Principles section');
+      assert(skillContent.includes('## Critical Actions'), 'SKILL.md has Critical Actions section');
+      assert(skillContent.includes('## Capabilities'), 'SKILL.md has Capabilities section');
+      assert(skillContent.includes('## On Activation'), 'SKILL.md has On Activation section');
+
+      // Verify all 9 capability codes are present in the capabilities table
+      const capabilityCodes = ['TMT', 'TF', 'AT', 'TA', 'TD', 'TR', 'NR', 'CI', 'RV'];
+      for (const code of capabilityCodes) {
+        const codePattern = new RegExp(`\\|\\s*${code}\\s*\\|`);
+        assert(codePattern.test(skillContent), `SKILL.md has capability code ${code}`);
+      }
 
       // Verify no BMM references
-      const yamlContent = await fs.readFile(teaAgentPath, 'utf8');
-      assert(!yamlContent.includes('_bmad/bmm/'), 'TEA agent has no _bmad/bmm/ references');
-      assert(!yamlContent.includes('module: bmm'), 'TEA agent has no module: bmm references');
+      assert(!skillContent.includes('_bmad/bmm/'), 'SKILL.md has no _bmad/bmm/ references');
+      assert(!skillContent.includes('module: bmm'), 'SKILL.md has no module: bmm references');
     } else {
-      assert(false, 'TEA agent YAML exists', 'src/agents/tea.agent.yaml not found - run Phase 2 first');
+      assert(false, 'SKILL.md exists', 'src/agents/bmad-tea/SKILL.md not found');
+    }
+
+    // Validate bmad-skill-manifest.yaml
+    if (await pathExists(manifestPath)) {
+      const manifest = yaml.load(await fs.readFile(manifestPath, 'utf8'));
+
+      assert(manifest.type === 'agent', 'Manifest has type: agent');
+      assert(manifest.name === 'bmad-tea', 'Manifest has correct name');
+      assert(manifest.module === 'tea', 'Manifest has module: tea');
+      assert(manifest.canonicalId === 'bmad-tea', 'Manifest has correct canonicalId');
+      assert(manifest.webskip === true, 'Manifest has webskip: true');
+      assert(manifest.hasSidecar === false, 'Manifest has hasSidecar: false');
+
+      // Verify all 9 capability skill IDs reference real workflow directories
+      const expectedSkillDirs = [
+        'bmad-teach-me-testing',
+        'bmad-testarch-framework',
+        'bmad-testarch-atdd',
+        'bmad-testarch-automate',
+        'bmad-testarch-test-design',
+        'bmad-testarch-trace',
+        'bmad-testarch-nfr',
+        'bmad-testarch-ci',
+        'bmad-testarch-test-review',
+      ];
+      for (const skillDir of expectedSkillDirs) {
+        const workflowDir = path.join(projectRoot, `src/workflows/testarch/${skillDir}`);
+        assert(await pathExists(workflowDir), `Capability skill ${skillDir} has matching workflow directory`);
+      }
+    } else {
+      assert(false, 'bmad-skill-manifest.yaml exists', 'src/agents/bmad-tea/bmad-skill-manifest.yaml not found');
     }
   } catch (error) {
-    assert(false, 'TEA agent structure validates', error.message);
+    assert(false, 'TEA agent native skill structure validates', error.message);
   }
 
   console.log('');
@@ -120,7 +168,7 @@ async function runTests() {
   console.log(`${colors.yellow}Test Suite 3: Knowledge Base${colors.reset}\n`);
 
   try {
-    const teaIndexPath = path.join(projectRoot, 'src/testarch/tea-index.csv');
+    const teaIndexPath = path.join(projectRoot, 'src/agents/bmad-tea/resources/tea-index.csv');
 
     if (await pathExists(teaIndexPath)) {
       const csvContent = await fs.readFile(teaIndexPath, 'utf8');
@@ -186,6 +234,22 @@ async function runTests() {
     }
   }
 
+  const frameworkScaffoldStepPath = path.join(
+    projectRoot,
+    'src/workflows/testarch/bmad-testarch-framework/steps-c/step-03-scaffold-framework.md',
+  );
+  try {
+    const frameworkScaffoldStep = await fs.readFile(frameworkScaffoldStepPath, 'utf8');
+    assert(frameworkScaffoldStep.includes('recurse.md'), 'framework scaffold step loads recurse.md when Playwright Utils is enabled');
+    assert(frameworkScaffoldStep.includes('log.md'), 'framework scaffold step loads log.md when Playwright Utils is enabled');
+    assert(
+      frameworkScaffoldStep.includes('intercept-network-call.md'),
+      'framework scaffold step conditionally loads intercept-network-call.md',
+    );
+  } catch (error) {
+    assert(false, 'framework scaffold fragment list validates', error.message);
+  }
+
   console.log('');
 
   // ============================================================

package/lib/bmad-cache/tea/test/test-knowledge-base.js

@@ -75,7 +75,7 @@ function runTests() {
   console.log(`========================================${colors.reset}\n`);
 
   const projectRoot = path.join(__dirname, '..');
-  const kbRoot = path.join(projectRoot, 'src', 'testarch');
+  const kbRoot = path.join(projectRoot, 'src', 'agents', 'bmad-tea', 'resources');
   const indexPath = path.join(kbRoot, 'tea-index.csv');
 
   // ============================================================