diff --git a/src/modules/bmm/agents/tea.agent.yaml b/src/modules/bmm/agents/tea.agent.yaml index 543001bd..6d84d27a 100644 --- a/src/modules/bmm/agents/tea.agent.yaml +++ b/src/modules/bmm/agents/tea.agent.yaml @@ -17,9 +17,9 @@ agent: - Testing is feature work. Prioritize unit/integration over E2E. Flakiness is critical debt. ATDD tests first, AI implements, suite validates. critical_actions: - - "Consult {project-root}/bmad/bmm/testarch/tea-index.csv to select knowledge fragments under `knowledge/` and load only the files needed for the current task" - - "Load the referenced fragment(s) from `{project-root}/bmad/bmm/testarch/knowledge/` before giving recommendations" - - "Cross-check recommendations with the current official Playwright, Cypress, Pact, and CI platform documentation; fall back to {project-root}/bmad/bmm/testarch/test-resources-for-ai-flat.txt only when deeper sourcing is required" + - "Consult {project-root}/bmad/bmm/knowledge/tea/tea-index.csv to select knowledge fragments under `knowledge/` and load only the files needed for the current task" + - "Load the referenced fragment(s) from `{project-root}/bmad/bmm/knowledge/tea/knowledge/` before giving recommendations" + - "Cross-check recommendations with the current official Playwright, Cypress, Pact, and CI platform documentation; fall back to {project-root}/bmad/bmm/knowledge/tea/test-resources-for-ai-flat.txt only when deeper sourcing is required" menu: - trigger: workflow-status diff --git a/src/modules/bmm/docs/agents-guide.md b/src/modules/bmm/docs/agents-guide.md index 331a5008..947fa4ef 100644 --- a/src/modules/bmm/docs/agents-guide.md +++ b/src/modules/bmm/docs/agents-guide.md @@ -299,7 +299,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age **Special Capabilities:** -- **Knowledge Base Access:** Consults comprehensive testing best practices from `testarch/knowledge/` directory +- **Knowledge Base Access:** Consults comprehensive testing best practices from `knowledge/tea/` directory - **Framework Selection:** Smart framework selection (Playwright vs Cypress) with fixture architecture - **Cross-Platform Testing:** Supports testing across web, mobile, and API layers diff --git a/src/modules/bmm/testarch/tea-index.csv b/src/modules/bmm/knowledge/tea-index.csv similarity index 100% rename from src/modules/bmm/testarch/tea-index.csv rename to src/modules/bmm/knowledge/tea-index.csv diff --git a/src/modules/bmm/testarch/knowledge/ci-burn-in.md b/src/modules/bmm/knowledge/tea/ci-burn-in.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/ci-burn-in.md rename to src/modules/bmm/knowledge/tea/ci-burn-in.md diff --git a/src/modules/bmm/testarch/knowledge/component-tdd.md b/src/modules/bmm/knowledge/tea/component-tdd.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/component-tdd.md rename to src/modules/bmm/knowledge/tea/component-tdd.md diff --git a/src/modules/bmm/testarch/knowledge/contract-testing.md b/src/modules/bmm/knowledge/tea/contract-testing.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/contract-testing.md rename to src/modules/bmm/knowledge/tea/contract-testing.md diff --git a/src/modules/bmm/testarch/knowledge/data-factories.md b/src/modules/bmm/knowledge/tea/data-factories.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/data-factories.md rename to src/modules/bmm/knowledge/tea/data-factories.md diff --git a/src/modules/bmm/testarch/knowledge/email-auth.md b/src/modules/bmm/knowledge/tea/email-auth.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/email-auth.md rename to src/modules/bmm/knowledge/tea/email-auth.md diff --git a/src/modules/bmm/testarch/knowledge/error-handling.md b/src/modules/bmm/knowledge/tea/error-handling.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/error-handling.md rename to src/modules/bmm/knowledge/tea/error-handling.md diff --git a/src/modules/bmm/testarch/knowledge/feature-flags.md b/src/modules/bmm/knowledge/tea/feature-flags.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/feature-flags.md rename to src/modules/bmm/knowledge/tea/feature-flags.md diff --git a/src/modules/bmm/testarch/knowledge/fixture-architecture.md b/src/modules/bmm/knowledge/tea/fixture-architecture.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/fixture-architecture.md rename to src/modules/bmm/knowledge/tea/fixture-architecture.md diff --git a/src/modules/bmm/testarch/knowledge/network-first.md b/src/modules/bmm/knowledge/tea/network-first.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/network-first.md rename to src/modules/bmm/knowledge/tea/network-first.md diff --git a/src/modules/bmm/testarch/knowledge/nfr-criteria.md b/src/modules/bmm/knowledge/tea/nfr-criteria.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/nfr-criteria.md rename to src/modules/bmm/knowledge/tea/nfr-criteria.md diff --git a/src/modules/bmm/testarch/knowledge/playwright-config.md b/src/modules/bmm/knowledge/tea/playwright-config.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/playwright-config.md rename to src/modules/bmm/knowledge/tea/playwright-config.md diff --git a/src/modules/bmm/testarch/knowledge/probability-impact.md b/src/modules/bmm/knowledge/tea/probability-impact.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/probability-impact.md rename to src/modules/bmm/knowledge/tea/probability-impact.md diff --git a/src/modules/bmm/testarch/knowledge/risk-governance.md b/src/modules/bmm/knowledge/tea/risk-governance.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/risk-governance.md rename to src/modules/bmm/knowledge/tea/risk-governance.md diff --git a/src/modules/bmm/testarch/knowledge/selective-testing.md b/src/modules/bmm/knowledge/tea/selective-testing.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/selective-testing.md rename to src/modules/bmm/knowledge/tea/selective-testing.md diff --git a/src/modules/bmm/testarch/knowledge/selector-resilience.md b/src/modules/bmm/knowledge/tea/selector-resilience.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/selector-resilience.md rename to src/modules/bmm/knowledge/tea/selector-resilience.md diff --git a/src/modules/bmm/testarch/knowledge/test-healing-patterns.md b/src/modules/bmm/knowledge/tea/test-healing-patterns.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/test-healing-patterns.md rename to src/modules/bmm/knowledge/tea/test-healing-patterns.md diff --git a/src/modules/bmm/testarch/knowledge/test-levels-framework.md b/src/modules/bmm/knowledge/tea/test-levels-framework.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/test-levels-framework.md rename to src/modules/bmm/knowledge/tea/test-levels-framework.md diff --git a/src/modules/bmm/testarch/knowledge/test-priorities-matrix.md b/src/modules/bmm/knowledge/tea/test-priorities-matrix.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/test-priorities-matrix.md rename to src/modules/bmm/knowledge/tea/test-priorities-matrix.md diff --git a/src/modules/bmm/testarch/knowledge/test-quality.md b/src/modules/bmm/knowledge/tea/test-quality.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/test-quality.md rename to src/modules/bmm/knowledge/tea/test-quality.md diff --git a/src/modules/bmm/testarch/knowledge/timing-debugging.md b/src/modules/bmm/knowledge/tea/timing-debugging.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/timing-debugging.md rename to src/modules/bmm/knowledge/tea/timing-debugging.md diff --git a/src/modules/bmm/testarch/knowledge/visual-debugging.md b/src/modules/bmm/knowledge/tea/visual-debugging.md similarity index 100% rename from src/modules/bmm/testarch/knowledge/visual-debugging.md rename to src/modules/bmm/knowledge/tea/visual-debugging.md diff --git a/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md b/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md index a64c4969..6b9bb2f8 100644 --- a/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +++ b/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md @@ -356,7 +356,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 `./bmm/knowledge/tea` for testing best practices --- diff --git a/src/modules/bmm/workflows/testarch/atdd/instructions.md b/src/modules/bmm/workflows/testarch/atdd/instructions.md index 1660e150..ef37592f 100644 --- a/src/modules/bmm/workflows/testarch/atdd/instructions.md +++ b/src/modules/bmm/workflows/testarch/atdd/instructions.md @@ -2,7 +2,7 @@ # Acceptance Test-Driven Development (ATDD) -**Workflow ID**: `bmad/bmm/testarch/atdd` +**Workflow ID**: `bmad/bmm/knowledge/tea/atdd` **Version**: 4.0 (BMad v6) --- @@ -50,7 +50,7 @@ Generates failing acceptance tests BEFORE implementation following TDD's red-gre 4. **Load Knowledge Base Fragments** - **Critical:** Consult `{project-root}/bmad/bmm/testarch/tea-index.csv` to load: + **Critical:** Consult `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv` to load: - `fixture-architecture.md` - Test fixture patterns with auto-cleanup (pure function → fixture → mergeTests composition, 406 lines, 5 examples) - `data-factories.md` - Factory patterns using faker (override patterns, nested factories, API seeding, 498 lines, 5 examples) - `component-tdd.md` - Component test strategies (red-green-refactor, provider isolation, accessibility, visual regression, 480 lines, 4 examples) diff --git a/src/modules/bmm/workflows/testarch/automate/instructions.md b/src/modules/bmm/workflows/testarch/automate/instructions.md index a7d2f3a4..19af1a6e 100644 --- a/src/modules/bmm/workflows/testarch/automate/instructions.md +++ b/src/modules/bmm/workflows/testarch/automate/instructions.md @@ -2,7 +2,7 @@ # Test Automation Expansion -**Workflow ID**: `bmad/bmm/testarch/automate` +**Workflow ID**: `bmad/bmm/knowledge/tea/automate` **Version**: 4.0 (BMad v6) --- @@ -83,7 +83,7 @@ Expands test automation coverage by generating comprehensive test suites at appr 5. **Load Knowledge Base Fragments** - **Critical:** Consult `{project-root}/bmad/bmm/testarch/tea-index.csv` to load: + **Critical:** Consult `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv` to load: - `test-levels-framework.md` - Test level selection (E2E vs API vs Component vs Unit with decision matrix, 467 lines, 4 examples) - `test-priorities-matrix.md` - Priority classification (P0-P3 with automated scoring, risk mapping, 389 lines, 2 examples) - `fixture-architecture.md` - Test fixture patterns (pure function → fixture → mergeTests, auto-cleanup, 406 lines, 5 examples) diff --git a/src/modules/bmm/workflows/testarch/ci/instructions.md b/src/modules/bmm/workflows/testarch/ci/instructions.md index 28e742c2..02af3ed6 100644 --- a/src/modules/bmm/workflows/testarch/ci/instructions.md +++ b/src/modules/bmm/workflows/testarch/ci/instructions.md @@ -2,7 +2,7 @@ # CI/CD Pipeline Setup -**Workflow ID**: `bmad/bmm/testarch/ci` +**Workflow ID**: `bmad/bmm/knowledge/tea/ci` **Version**: 4.0 (BMad v6) --- @@ -353,7 +353,7 @@ Scaffolds a production-ready CI/CD quality pipeline with test execution, burn-in ### Knowledge Base Integration -**Critical:** Consult `{project-root}/bmad/bmm/testarch/tea-index.csv` to identify and load relevant knowledge fragments: +**Critical:** Consult `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv` to identify and load relevant knowledge fragments: - `ci-burn-in.md` - Burn-in loop patterns: 10-iteration detection, GitHub Actions workflow, shard orchestration, selective execution (678 lines, 4 examples) - `selective-testing.md` - Changed test detection strategies: tag-based, spec filters, diff-based selection, promotion rules (727 lines, 4 examples) diff --git a/src/modules/bmm/workflows/testarch/framework/instructions.md b/src/modules/bmm/workflows/testarch/framework/instructions.md index 47cc9922..63926e2c 100644 --- a/src/modules/bmm/workflows/testarch/framework/instructions.md +++ b/src/modules/bmm/workflows/testarch/framework/instructions.md @@ -2,7 +2,7 @@ # Test Framework Setup -**Workflow ID**: `bmad/bmm/testarch/framework` +**Workflow ID**: `bmad/bmm/knowledge/tea/framework` **Version**: 4.0 (BMad v6) --- @@ -189,7 +189,7 @@ Initialize a production-ready test framework architecture (Playwright or Cypress 6. **Implement Fixture Architecture** - **Knowledge Base Reference**: `testarch/knowledge/fixture-architecture.md` + **Knowledge Base Reference**: `knowledge/tea/fixture-architecture.md` Create `tests/support/fixtures/index.ts`: @@ -214,7 +214,7 @@ Initialize a production-ready test framework architecture (Playwright or Cypress 7. **Implement Data Factories** - **Knowledge Base Reference**: `testarch/knowledge/data-factories.md` + **Knowledge Base Reference**: `knowledge/tea/data-factories.md` Create `tests/support/fixtures/factories/user-factory.ts`: @@ -349,7 +349,7 @@ The generated `tests/README.md` should include: ### Knowledge Base Integration -**Critical:** Consult `{project-root}/bmad/bmm/testarch/tea-index.csv` to identify and load relevant knowledge fragments: +**Critical:** Consult `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv` to identify and load relevant knowledge fragments: - `fixture-architecture.md` - Pure function → fixture → `mergeTests` composition with auto-cleanup (406 lines, 5 examples) - `data-factories.md` - Faker-based factories with overrides, nested factories, API seeding, auto-cleanup (498 lines, 5 examples) diff --git a/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md b/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md index fe4fc8e6..8c344c1f 100644 --- a/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md +++ b/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md @@ -50,7 +50,7 @@ This workflow performs a comprehensive assessment of non-functional requirements **Actions:** -1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/testarch/tea-index.csv`: +1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv`: - `nfr-criteria.md` - Non-functional requirements criteria and thresholds (security, performance, reliability, maintainability with code examples, 658 lines, 4 examples) - `ci-burn-in.md` - CI/CD burn-in patterns for reliability validation (10-iteration detection, sharding, selective execution, 678 lines, 4 examples) - `test-quality.md` - Test quality expectations for maintainability (deterministic, isolated, explicit assertions, length/time limits, 658 lines, 5 examples) diff --git a/src/modules/bmm/workflows/testarch/test-design/instructions.md b/src/modules/bmm/workflows/testarch/test-design/instructions.md index 551e30fb..5c6caac6 100644 --- a/src/modules/bmm/workflows/testarch/test-design/instructions.md +++ b/src/modules/bmm/workflows/testarch/test-design/instructions.md @@ -2,7 +2,7 @@ # Test Design and Risk Assessment -**Workflow ID**: `bmad/bmm/testarch/test-design` +**Workflow ID**: `bmad/bmm/knowledge/tea/test-design` **Version**: 4.0 (BMad v6) --- @@ -48,7 +48,7 @@ Plans comprehensive test coverage strategy with risk assessment, priority classi 4. **Load Knowledge Base Fragments** - **Critical:** Consult `{project-root}/bmad/bmm/testarch/tea-index.csv` to load: + **Critical:** Consult `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv` to load: - `risk-governance.md` - Risk classification framework (6 categories: TECH, SEC, PERF, DATA, BUS, OPS), automated scoring, gate decision engine, owner tracking (625 lines, 4 examples) - `probability-impact.md` - Risk scoring methodology (probability × impact matrix, automated classification, dynamic re-assessment, gate integration, 604 lines, 4 examples) - `test-levels-framework.md` - Test level selection guidance (E2E vs API vs Component vs Unit with decision matrix, characteristics, when to use each, 467 lines, 4 examples) diff --git a/src/modules/bmm/workflows/testarch/test-design/test-design-template.md b/src/modules/bmm/workflows/testarch/test-design/test-design-template.md index 3751acca..ffae1765 100644 --- a/src/modules/bmm/workflows/testarch/test-design/test-design-template.md +++ b/src/modules/bmm/workflows/testarch/test-design/test-design-template.md @@ -281,5 +281,5 @@ --- **Generated by**: BMad TEA Agent - Test Architect Module -**Workflow**: `bmad/bmm/testarch/test-design` +**Workflow**: `bmad/bmm/knowledge/tea/test-design` **Version**: 4.0 (BMad v6) diff --git a/src/modules/bmm/workflows/testarch/test-review/instructions.md b/src/modules/bmm/workflows/testarch/test-review/instructions.md index 01d4f0cc..212d5da2 100644 --- a/src/modules/bmm/workflows/testarch/test-review/instructions.md +++ b/src/modules/bmm/workflows/testarch/test-review/instructions.md @@ -49,7 +49,7 @@ This workflow performs comprehensive test quality reviews using TEA's knowledge **Actions:** -1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/testarch/tea-index.csv`: +1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv`: - `test-quality.md` - Definition of Done (deterministic tests, isolated with cleanup, explicit assertions, <300 lines, <1.5 min, 658 lines, 5 examples) - `fixture-architecture.md` - Pure function → Fixture → mergeTests composition with auto-cleanup (406 lines, 5 examples) - `network-first.md` - Route intercept before navigate to prevent race conditions (intercept before navigate, HAR capture, deterministic waiting, 489 lines, 5 examples) diff --git a/src/modules/bmm/workflows/testarch/test-review/test-review-template.md b/src/modules/bmm/workflows/testarch/test-review/test-review-template.md index 79bf9dea..4ed1a224 100644 --- a/src/modules/bmm/workflows/testarch/test-review/test-review-template.md +++ b/src/modules/bmm/workflows/testarch/test-review/test-review-template.md @@ -259,16 +259,16 @@ 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 -- **[traceability.md](../../../testarch/knowledge/traceability.md)** - Requirements-to-tests mapping +- **[test-quality.md](../../../knowledge/tea/test-quality.md)** - Definition of Done for tests (no hard waits, <300 lines, <1.5 min, self-cleaning) +- **[fixture-architecture.md](../../../knowledge/tea/fixture-architecture.md)** - Pure function → Fixture → mergeTests pattern +- **[network-first.md](../../../knowledge/tea/network-first.md)** - Route intercept before navigate (race condition prevention) +- **[data-factories.md](../../../knowledge/tea/data-factories.md)** - Factory functions with overrides, API-first setup +- **[test-levels-framework.md](../../../knowledge/tea/test-levels-framework.md)** - E2E vs API vs Component vs Unit appropriateness +- **[tdd-cycles.md](../../../knowledge/tea/tdd-cycles.md)** - Red-Green-Refactor patterns +- **[selective-testing.md](../../../knowledge/tea/selective-testing.md)** - Duplicate coverage detection +- **[ci-burn-in.md](../../../knowledge/tea/ci-burn-in.md)** - Flakiness detection patterns (10-iteration loop) +- **[test-priorities.md](../../../knowledge/tea/test-priorities.md)** - P0/P1/P2/P3 classification framework +- **[traceability.md](../../../knowledge/tea/traceability.md)** - Requirements-to-tests mapping See [tea-index.csv](../../../testarch/tea-index.csv) for complete knowledge base. @@ -380,7 +380,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: `knowledge/tea/` 2. Consult tea-index.csv for detailed guidance 3. Request clarification on specific violations 4. Pair with QA engineer to apply patterns diff --git a/src/modules/bmm/workflows/testarch/trace/instructions.md b/src/modules/bmm/workflows/testarch/trace/instructions.md index 96015430..e3308ecf 100644 --- a/src/modules/bmm/workflows/testarch/trace/instructions.md +++ b/src/modules/bmm/workflows/testarch/trace/instructions.md @@ -64,7 +64,7 @@ This phase focuses on mapping requirements to tests, analyzing coverage, and ide **Actions:** -1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/testarch/tea-index.csv`: +1. Load relevant knowledge fragments from `{project-root}/bmad/bmm/knowledge/tea/tea-index.csv`: - `test-priorities-matrix.md` - P0/P1/P2/P3 risk framework with automated priority calculation, risk-based mapping, tagging strategy (389 lines, 2 examples) - `risk-governance.md` - Risk-based testing approach: 6 categories (TECH, SEC, PERF, DATA, BUS, OPS), automated scoring, gate decision engine, coverage traceability (625 lines, 4 examples) - `probability-impact.md` - Risk scoring methodology: probability × impact matrix, automated classification, dynamic re-assessment, gate integration (604 lines, 4 examples)