bmad-method-test-architecture-enterprise 1.2.3 → 1.2.6

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to the Test Architect (TEA) module will be documented in thi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.4] - 2026-02-22
+
+### Changed
+
+- **All workflow descriptions optimized** for skill selection and display
+  - Descriptions shortened and made more concise for better UI rendering
+  - Added explicit trigger phrases (e.g., "Use when user says 'lets write acceptance tests'") to improve skill detection
+  - Affected workflows: `atdd`, `automate`, `ci`, `framework`, `nfr-assess`, `teach-me-testing`, `test-design`, `test-review`, `trace`
+  - Removed redundant `web_bundle: false` from workflow.yaml files
+
 ## [Unreleased]
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method-test-architecture-enterprise",
-  "version": "1.2.3",
+  "version": "1.2.6",
   "description": "Master Test Architect for quality strategy, test automation, and release gates",
   "keywords": [
     "bmad",
@@ -38,12 +38,14 @@
     "release:major": "gh workflow run manual-release.yaml -f version_bump=major",
     "release:minor": "gh workflow run manual-release.yaml -f version_bump=minor",
     "release:patch": "gh workflow run manual-release.yaml -f version_bump=patch",
-    "test": "npm run test:schemas && npm run test:install && npm run test:knowledge && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
+    "test": "npm run test:schemas && npm run test:install && npm run test:knowledge && npm run test:tea-workflow-descriptions && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
     "test:coverage": "c8 npm test",
     "test:install": "node test/test-installation-components.js",
     "test:knowledge": "node test/test-knowledge-base.js",
     "test:schemas": "node test/test-agent-schema.js",
-    "validate:schemas": "node tools/validate-agent-schema.js"
+    "test:tea-workflow-descriptions": "node tools/validate-tea-workflow-descriptions.js",
+    "validate:schemas": "node tools/validate-agent-schema.js",
+    "validate:tea-workflow-descriptions": "node tools/validate-tea-workflow-descriptions.js"
   },
   "lint-staged": {
     "*.{js,cjs,mjs}": [

package/release_notes.md

@@ -1,12 +1,7 @@
-## 🚀 What's New in v1.2.3
+## 🚀 What's New in v1.2.6
 
 ### 🐛 Bug Fixes
-- fix: issues 32 through 37
-
-### 📦 Other Changes
-- addressed PR comments
-- addressed PR comments2
-- Merge pull request #38 from bmad-code-org/fix/issues-32-33-34-35-35-36-37
+- fix: teach me testing for gemini
 
 
 ## 📦 Installation
@@ -16,4 +11,4 @@ npx bmad-method install
 # Select "Test Architect" from module menu
 ```
 
-**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.2.2...v1.2.3
+**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.2.5...v1.2.6

package/src/workflows/testarch/atdd/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-atdd
-description: 'Generate failing acceptance tests before implementation using TDD red-green-refactor cycle'
+description: Generate failing acceptance tests using TDD cycle. Use when user says 'lets write acceptance tests' or 'I want to do ATDD'
 web_bundle: true
 ---
 

package/src/workflows/testarch/atdd/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: atdd
 name: testarch-atdd
-description: "Generate failing acceptance tests before implementation using TDD red-green-refactor cycle"
-author: "BMad"
+description: 'Generate failing acceptance tests using TDD cycle. Use when the user says "lets write acceptance tests" or "I want to do ATDD"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -44,5 +43,3 @@ execution_hints:
   interactive: false # Minimize prompts
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/automate/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-automate
-description: 'Expand test automation coverage after implementation or analyze existing codebase to generate comprehensive test suite'
+description: Expand test automation coverage for codebase. Use when user says 'lets expand test coverage' or 'I want to automate tests'
 web_bundle: true
 ---
 

package/src/workflows/testarch/automate/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: automate
 name: testarch-automate
-description: "Expand test automation coverage after implementation or analyze existing codebase to generate comprehensive test suite"
-author: "BMad"
+description: 'Expand test automation coverage for codebase. Use when the user says "lets expand test coverage" or "I want to automate tests"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -51,5 +50,3 @@ execution_hints:
   interactive: false # Minimize prompts
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/ci/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-ci
-description: 'Scaffold CI/CD quality pipeline with test execution, burn-in loops, and artifact collection'
+description: Scaffold CI/CD quality pipeline with test execution. Use when user says 'lets setup CI pipeline' or 'I want to create quality gates'
 web_bundle: true
 ---
 

package/src/workflows/testarch/ci/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: ci
 name: testarch-ci
-description: "Scaffold CI/CD quality pipeline with test execution, burn-in loops, and artifact collection"
-author: "BMad"
+description: 'Scaffold CI/CD quality pipeline with test execution. Use when the user says "lets setup CI pipeline" or "I want to create quality gates"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -46,5 +45,3 @@ execution_hints:
   interactive: false # Minimize prompts, auto-detect when possible
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/framework/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-framework
-description: 'Initialize production-ready test framework architecture (Playwright or Cypress) with fixtures, helpers, and configuration'
+description: Initialize test framework with Playwright or Cypress. Use when user says 'lets setup test framework' or 'I want to initialize testing framework'
 web_bundle: true
 ---
 

package/src/workflows/testarch/framework/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: framework
 name: testarch-framework
-description: "Initialize production-ready test framework architecture (Playwright or Cypress) with fixtures, helpers, and configuration"
-author: "BMad"
+description: 'Initialize test framework with Playwright or Cypress. Use when the user says "lets setup test framework" or "I want to initialize testing framework"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -46,5 +45,3 @@ execution_hints:
   interactive: false # Minimize prompts; auto-detect when possible
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/nfr-assess/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-nfr
-description: 'Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation'
+description: Assess NFRs like performance security and reliability. Use when user says 'lets assess NFRs' or 'I want to evaluate non-functional requirements'
 web_bundle: true
 ---
 

package/src/workflows/testarch/nfr-assess/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: nfr-assess
 name: testarch-nfr
-description: "Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation"
-author: "BMad"
+description: 'Assess NFRs like performance security and reliability. Use when the user says "lets assess NFRs" or "I want to evaluate non-functional requirements"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -46,5 +45,3 @@ execution_hints:
   interactive: false # Minimize prompts
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/teach-me-testing/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: teach-me-testing
-description: 'Multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence'
+description: 'Teach testing progressively through structured sessions. Use when user says "lets learn testing" or "I want to study test practices"'
 web_bundle: true
 ---
 

package/src/workflows/testarch/test-design/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-test-design
-description: 'Epic-level test plan (Phase 4)'
+description: Create system-level or epic-level test plans. Use when user says 'lets design test plan' or 'I want to create test strategy'
 web_bundle: true
 ---
 

package/src/workflows/testarch/test-design/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: test-design
 name: testarch-test-design
-description: "Dual-mode workflow: (1) System-level testability review in Solutioning phase, or (2) Epic-level test planning in Implementation phase. Auto-detects mode based on project phase."
-author: "BMad"
+description: 'Create system-level or epic-level test plans. Use when the user says "lets design test plan" or "I want to create test strategy"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -75,5 +74,3 @@ execution_hints:
   interactive: false # Minimize prompts
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/src/workflows/testarch/test-review/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-test-review
-description: 'Review test quality using comprehensive knowledge base and best practices validation'
+description: Review test quality using best practices validation. Use when user says 'lets review tests' or 'I want to evaluate test quality'
 web_bundle: true
 ---
 

package/src/workflows/testarch/test-review/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: test-review
 name: testarch-test-review
-description: "Review test quality using comprehensive knowledge base and best practices validation"
-author: "BMad"
+description: 'Review test quality using best practices validation. Use when the user says "lets review tests" or "I want to evaluate test quality"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -47,4 +46,3 @@ execution_hints:
   autonomous: true # Proceed without user input unless blocked
   iterative: true # Can review multiple files
 
-web_bundle: false

package/src/workflows/testarch/trace/workflow.md

@@ -1,6 +1,6 @@
 ---
 name: testarch-trace
-description: 'Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)'
+description: Generate traceability matrix and quality gate decision. Use when user says 'lets create traceability matrix' or 'I want to analyze test coverage'
 web_bundle: true
 ---
 

package/src/workflows/testarch/trace/workflow.yaml

@@ -1,7 +1,6 @@
 # Test Architect workflow: trace (enhanced with gate decision)
 name: testarch-trace
-description: "Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)"
-author: "BMad"
+description: 'Generate traceability matrix and quality gate decision. Use when the user says "lets create traceability matrix" or "I want to analyze test coverage"'
 
 # Critical variables from config
 config_source: "{project-root}/_bmad/tea/config.yaml"
@@ -54,5 +53,3 @@ execution_hints:
   interactive: false # Minimize prompts
   autonomous: true # Proceed without user input unless blocked
   iterative: true
-
-web_bundle: false

package/tools/validate-tea-workflow-descriptions.js

@@ -0,0 +1,122 @@
+/**
+ * Validate TEA workflow description quote style for Gemini compatibility.
+ *
+ * Rules for TEA workflow definitions under src/workflows/testarch/<workflow>/workflow.yaml
+ * and teach-me-testing frontmatter in src/workflows/testarch/teach-me-testing/workflow.md:
+ * - `description:` must be a single-line YAML scalar on one line
+ * - the raw YAML scalar must be wrapped in single quotes
+ * - parsed description text must not contain single-quote characters
+ *   (use double quotes for examples, e.g. "quote here")
+ *
+ * Usage: node tools/validate-tea-workflow-descriptions.js [project_root]
+ * Exit codes: 0 = success, 1 = validation failures
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { glob } = require('glob');
+const yaml = require('yaml');
+
+/**
+ * @param {string} filePath
+ * @param {string} projectRoot
+ * @returns {string[]}
+ */
+function validateFile(filePath, projectRoot) {
+  const errors = [];
+  const relativePath = path.relative(projectRoot, filePath).replaceAll('\\', '/');
+  let content;
+  try {
+    content = fs.readFileSync(filePath, 'utf8');
+  } catch (error) {
+    return [`${relativePath}: Failed to read file: ${error.message}`];
+  }
+  let yamlDoc = content;
+  if (filePath.endsWith('.md')) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---(?:\n|$)/);
+    if (!frontmatterMatch) {
+      return [`${relativePath}: Missing YAML frontmatter block`];
+    }
+    yamlDoc = frontmatterMatch[1];
+  }
+  /** @type {string | undefined} */
+  let parsedDescription;
+
+  try {
+    const parsed = yaml.parse(yamlDoc);
+    if (!parsed || typeof parsed.description !== 'string') {
+      errors.push('YAML parsed but `description` is missing or not a string');
+    } else {
+      parsedDescription = parsed.description;
+    }
+  } catch (error) {
+    errors.push(`YAML parse error: ${error.message}`);
+    return [`${relativePath}: ${errors[0]}`];
+  }
+
+  const descriptionMatch = yamlDoc.match(/^\s*description:\s*(?:'((?:''|[^'])*)'|"((?:\\"|[^"])*)")\s*(?:#.*)?$/m);
+  if (descriptionMatch) {
+    const singleQuotedInner = descriptionMatch[1];
+    const doubleQuotedInner = descriptionMatch[2];
+    const quote = singleQuotedInner === undefined ? '"' : "'";
+
+    if (quote !== "'") {
+      errors.push('`description:` value must be wrapped in single quotes');
+    }
+  } else {
+    if (/^\s*description:\s*/m.test(yamlDoc)) {
+      errors.push('`description:` value must be wrapped in single quotes');
+    } else {
+      errors.push('Missing single-line `description:` field');
+    }
+  }
+
+  if (typeof parsedDescription === 'string' && parsedDescription.includes("'")) {
+    errors.push('Parsed `description` contains a single quote character; use double quotes for examples');
+  }
+
+  return errors.map((error) => `${relativePath}: ${error}`);
+}
+
+async function main(customProjectRoot) {
+  const projectRoot = customProjectRoot || path.join(__dirname, '..');
+  const yamlFiles = await glob('src/workflows/testarch/*/workflow.yaml', {
+    cwd: projectRoot,
+    absolute: true,
+  });
+  const mdFiles = await glob('src/workflows/testarch/teach-me-testing/workflow.md', {
+    cwd: projectRoot,
+    absolute: true,
+  });
+  const files = [...yamlFiles, ...mdFiles];
+
+  if (files.length === 0) {
+    console.error('No TEA workflow definitions found under src/workflows/testarch/');
+    process.exit(1);
+  }
+
+  /** @type {string[]} */
+  const failures = [];
+
+  for (const filePath of files.sort()) {
+    failures.push(...validateFile(filePath, projectRoot));
+  }
+
+  if (failures.length > 0) {
+    console.error('TEA workflow description quote validation failed:\n');
+    for (const failure of failures) {
+      console.error(`- ${failure}`);
+    }
+    console.error('\nExpected format example:');
+    console.error(`description: 'Generate traceability, example "quote here"'`);
+    process.exit(1);
+  }
+
+  console.log(`Validated TEA workflow description quoting in ${files.length} file(s).`);
+}
+
+const customProjectRoot = process.argv[2];
+main(customProjectRoot).catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});