bmad-method-test-architecture-enterprise 2.0.1-next.3 → 2.0.1-next.5

package/.claude-plugin/marketplace.json

@@ -30,8 +30,8 @@
     {
       "name": "bmad-method-test-architecture-enterprise",
       "source": "./",
-      "description": "Master Test Architect module for quality strategy, test automation, combined framework and CI setup, CI/CD quality gates, and structured testing education. The CI skill remains a compatibility entry. Part of the BMad Method ecosystem.",
-      "version": "2.0.1-next.3",
+      "description": "Master Test Architect module for quality strategy, test generation in red and expand modes with automatic run-and-heal, combined framework and CI setup, CI/CD quality gates, and structured testing education. The CI and ATDD commands remain available with existing customizations. Part of the BMad Method ecosystem.",
+      "version": "2.0.1-next.5",
       "author": {
         "name": "Murat K Ozcan (TEA Creator) & Brian (BMad) Madison"
       },

package/README.md

@@ -3,7 +3,7 @@
 [Documentation](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/) · [Getting started](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/tea-lite-quickstart/) · [Contributing](./CONTRIBUTING.md) · [MIT license](./LICENSE)
 
 TEA is a BMad module for test planning, automation, evaluation, and release decisions.
-Its agent, Murat, uses ten workflows and a shared testing knowledge base to turn requirements and risks into tests and evidence.
+Its agent, Murat, uses eight skills and a shared testing knowledge base to turn requirements and risks into tests and evidence.
 You can use TEA on its own or alongside BMad Method.
 
 TEA helps you:
@@ -46,31 +46,38 @@ To install a tagged release, replace `<version>` with the release number:
 npx skills add https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/v<version>/skills
 ```
 
-## Start with one workflow
+<a id="start-with-one-workflow"></a>
+
+## Start with one skill
+
+Ten commands start the eight skills: Framework includes CI setup; Automate includes red and expand modes.
 
 In Claude Code, Cursor, and Windsurf, type `/bmad-testarch-test-design` in chat.
 In Codex, type `$bmad-testarch-test-design`.
 You can also load `/bmad-tea` or `$bmad-tea` and choose a menu code.
-Each workflow can run directly in a fresh session.
-
-| Workflow                                                                                                                           | Command                      | Menu | Use it to                                              |
-| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---- | ------------------------------------------------------ |
-| [Teach Me Testing](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/teach-me-testing/)    | `/bmad-teach-me-testing`     | TMT  | Learn testing through seven sessions                   |
-| [Test Design](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/)          | `/bmad-testarch-test-design` | TD   | Plan risks, coverage, and NFR evidence                 |
-| [Framework Setup](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/setup-test-framework/) | `/bmad-testarch-framework`   | TF   | Set up a test framework, CI, or both                   |
-| [CI Setup](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/setup-ci/)                    | `/bmad-testarch-ci`          | CI   | Connect tests and quality checks to CI                 |
-| [ATDD](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-atdd/)                        | `/bmad-testarch-atdd`        | AT   | Write acceptance scaffolds before implementation       |
-| [Automate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/)                | `/bmad-testarch-automate`    | TA   | Add coverage to implemented features                   |
-| [Test Review](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/)          | `/bmad-testarch-test-review` | RV   | Audit test quality and score findings                  |
-| [NFR Evidence Audit](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-nfr-assess/)    | `/bmad-testarch-nfr`         | NR   | Assess performance, security, and reliability evidence |
-| [Evaluate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/evaluate-your-first-skill/)          | `/bmad-testarch-evaluate`    | EV   | Build and run a behavioral evaluation                  |
-| [Trace](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/)                      | `/bmad-testarch-trace`       | TR   | Map requirements to tests and decide a release gate    |
+Each skill can run directly in a fresh session.
+
+| Skill                                                                                                                           | Command                      | Menu | Use it to                                            |
+| ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---- | ---------------------------------------------------- |
+| [Test Review](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/)       | `/bmad-testarch-test-review` | RV   | Audit test quality and score findings                |
+| [Automate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/)             | `/bmad-testarch-automate`    | TA   | Generate red acceptance scaffolds or expand coverage |
+| [Test Design](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/)       | `/bmad-testarch-test-design` | TD   | Plan risks, coverage, and NFR evidence               |
+| [Framework](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/setup-test-framework/)    | `/bmad-testarch-framework`   | TF   | Set up a test framework, CI, or both                 |
+| [NFR](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-nfr-assess/)                | `/bmad-testarch-nfr`         | NR   | Audit implemented NFR evidence                       |
+| [Teach Me Testing](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/teach-me-testing/) | `/bmad-teach-me-testing`     | TMT  | Learn testing through seven sessions                 |
+
+Additional skills:
+
+- [Trace](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/): `/bmad-testarch-trace`, menu `TR`. Map requirements to tests and decide a release gate.
+- [Evaluate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/evaluate-your-first-skill/): `/bmad-testarch-evaluate`, menu `EV`. Build and run a behavioral evaluation.
 
 Framework and CI setup share one skill, `bmad-testarch-framework`.
 Ask for framework only, CI only, or both; TEA infers the scope from your prompt and asks "Do you want CI too?" once when CI scope is unclear in an interactive session. An unattended request with unclear scope runs framework setup only and states that CI was excluded.
 `/bmad-testarch-ci` and the `CI` menu code still work and start the same skill's CI setup, with your existing CI customizations.
 Create, Resume, Validate, and Edit remain available for the selected setup scope.
 
+Automation uses `red` mode before implementation and `expand` mode for existing code. Your prompt selects the mode. `/bmad-testarch-atdd` and `AT` default to red; `/bmad-testarch-automate` and `TA` default to expand. Existing commands and customization files keep working. Create runs execute the generated tests and repair test issues for up to three rounds. Red confirms the intended missing behavior; expand aims for passing coverage and reports product defects.
+
 For Codex, replace the leading `/` in the table with `$`.
 The agent menu also accepts `GATE` to route you through test review, NFR evidence audit, and trace Phase 2.
 
@@ -78,15 +85,15 @@ Choose a starting path:
 
 - [TEA Lite](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/tea-lite-quickstart/) for an existing project that needs more test coverage.
 - [TEA Academy](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/learn-testing-tea-academy/) to learn testing.
-- [TEA Overview](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/tea-overview/) for the lifecycle and workflow order.
+- [TEA Overview](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/tea-overview/) for the lifecycle and skill order.
 - [Evaluate Your First Skill](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/evaluate-your-first-skill/) for a runnable evaluation tutorial.
 
 ## How it works
 
-Each workflow loads one step file at a time.
+Each skill loads one step file at a time.
 The steps define the task, the evidence to collect, and when to stop.
 They load the knowledge fragments needed for that task from `skills/bmod-tea/knowledge/tea-index.csv`.
-Workflows can delegate independent tasks when the assistant supports workers; execution mode is configurable.
+Skills can delegate independent tasks when the assistant supports workers; execution mode is configurable.
 
 Review findings use fixed criteria and severity rules.
 Trace applies coverage thresholds and evidence checks to the release decision.
@@ -106,7 +113,7 @@ It requires Node.js 22.20.0 or later:
 npm install --save-dev bmad-method-test-architecture-enterprise
 ```
 
-- [`tea-test-review`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-test-review-cli/) runs the review workflow against changed tests and returns a gate verdict.
+- [`tea-test-review`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-test-review-cli/) runs the review skill against changed tests and returns a gate verdict.
 - [`tea-evaluate`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-evaluate-cli/) checks, runs, scores, and compares behavioral evaluations.
 
 For `tea-evaluate`, install `eval-quality` alongside TEA in the evaluations folder:
@@ -116,7 +123,7 @@ npm install --prefix evals bmad-method-test-architecture-enterprise eval-quality
 npm exec --prefix evals -- tea-evaluate --help
 ```
 
-The npm package includes the workflow skills used by the tools.
+The npm package includes the skills used by the tools.
 See the [CI examples](./cli/examples/README.md) for test-review integration.
 
 ## Contributing

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method-test-architecture-enterprise",
-  "version": "2.0.1-next.3",
+  "version": "2.0.1-next.5",
   "description": "Master Test Architect for quality strategy, test automation, and release gates",
   "keywords": [
     "bmad",
@@ -88,7 +88,7 @@
     "release:minor": "gh workflow run publish.yaml -f channel=latest -f bump=minor",
     "release:next": "gh workflow run publish.yaml -f channel=next",
     "release:patch": "gh workflow run publish.yaml -f channel=latest -f bump=patch",
-    "test": "npm run test:conflict-markers && npm run test:schemas && npm run test:install && npm run test:evaluate-guidance && npm run test:evaluate-authoring && npm run test:evaluate-gap-loop && npm run test:evaluate-dogfood && npm run test:evaluate-check && npm run test:evaluate-compare && npm run test:evaluate-before-state && npm run test:evaluate-ci-gates && npm run test:evaluate-ci-tiers && npm run test:evaluate-ci-repositories:tagged-release-pr && npm run test:evaluate-ci-repositories:tagged-release-merge && npm run test:evaluate-ci-repositories:tagged-release-release && npm run test:evaluate-ci-repositories:nightly-deploy-pr && npm run test:evaluate-ci-repositories:nightly-deploy-merge && npm run test:evaluate-ci-repositories:nightly-deploy-scheduled && npm run test:evaluate-ci-repositories:nightly-deploy-release && npm run test:evaluate-ci-render && npm run test:evaluate-pr-mcp && npm run test:evaluate-pr-api && npm run test:evaluate-pr-suite && npm run test:evaluate-pr-workflow && npm run test:evaluate-pr-tool-use && npm run test:evaluate-pr-promptfoo && npm run test:evaluate-pr-ai-feature && npm run test:evaluate-pr-test-review && npm run test:evaluate-pr-gap-loop && npm run test:evaluate-pr-learn && npm run test:evaluate-pr-tutorial && npm run test:evaluate-partitions && npm run test:evaluate-partition-plans-views-and-check && npm run test:evaluate-partition-plans-preflight-and-run && npm run test:evaluate-partition-plans-score && npm run test:evaluate-partition-plans-attempts-seal-and-mappings && npm run test:evaluate-partition-plans-attempts-records && npm run test:evaluate-partition-plans-attempts-gameability && npm run test:evaluate-interpret && npm run test:evaluate-calibration && npm run test:evaluate-boundaries && npm run test:evaluate-preflight && npm run test:evaluate-isolation-conformance && npm run test:evaluate-mutation:qualification-basics && npm run test:evaluate-mutation:qualification-guards && npm run test:evaluate-mutation:recovery && npm run test:evaluate-mutation:journals && npm run test:evaluate-run && npm run test:evaluate-aggregate && npm run test:evaluate-confinement && npm run test:evaluate-confinement-audit && npm run test:evaluate-confinement-history && npm run test:evaluate-confinement-git-state && npm run test:evaluate-confinement-network && npm run test:evaluate-held-inputs && npm run test:evaluate-arms-historical && npm run test:evaluate-arms-deployments && npm run test:evaluate-evaluators && npm run test:evaluate-evaluators-agent-version && npm run test:evaluate-agents && npm run test:evaluate-agents-importers && npm run test:evaluate-agents-sealed-brief && npm run test:evaluate-held-attempts && npm run test:evaluate-private && npm run test:evaluate-records && npm run test:evaluate-mcp && npm run test:evaluate-api && npm run test:evaluate-workflow && npm run test:evaluate-tool-use && npm run test:evaluate-promptfoo && npm run test:evaluate-learned-framework && npm run test:docs-tutorial && npm run test:knowledge && npm run test:criteria-fragments && npm run test:doc-count-sources && npm run test:planning-doc-sources && npm run test:doc-counts && npm run test:doc-claim-sources && npm run test:doc-claims && npm run test:doc-invocation-entry && npm run test:doc-invocations && npm run test:docs-build-names && npm run test:docs-evaluate-sidebar && npm run test:docs-gap-reader && npm run test:enforce-hook && npm run test:framework-scaffold && npm run test:isolation-primitives && npm run test:atdd-isolation && npm run test:atdd-net-guard && npm run test:atdd-scoring && npm run test:atdd-workflow-guidance && npm run test:framework-scaffold-install-isolation && npm run test:transcript-harness && npm run test:suite-manifest && npm run test:teach-me-testing-scoring && npm run test:eval-data && npm run test:eval-atdd-data && npm run test:eval-ci-data && npm run test:eval-framework-scaffold-data && npm run test:eval-nfr-data && npm run test:nfr-validate-corpus && npm run test:nfr-evidence-guidance && npm run test:eval-test-design-data && npm run test:eval-trace-data && npm run test:eval-routing-data && npm run test:eval-routing-boundaries && npm run test:eval-routing-evidence && npm run test:eval-transcript-data && npm run test:eval-teach-me-testing-data && npm run test:eval-schemas && npm run test:eval-diagnostics && npm run test:eval-replay && npm run test:eval-quality-corpus && npm run test:schema-versions && npm run test:contract-sources && npm run test:contracts && npm run test:contract-oracles && npm run test:probe-sources && npm run test:test-design-qualification && npm run test:test-review-qualification && npm run test:trace-qualification && npm run test:nfr-qualification && npm run test:ci-qualification && npm run test:probe-corpus && npm run test:compare-dominance && npm run test:compare-eval-runs && npm run test:trial-set-scoring && npm run test:automate-eval-fixture && npm run test:eval-automate-data && npm run test:clock-port && npm run test:probe-conformance && npm run test:corpus-conformance && npm run test:file-system-conformance && npm run test:file-system-port && npm run test:probe-targets && npm run test:port-totality && npm run test:ci-coverage && npm run test:ci-coverage-filters && npm run test:install-actionlint && npm run test:workflows-lint && npm run test:install-linux-sandbox && npm run test:shards && npm run test:groups && npm run test:cli && npm run test:test-review-pr-scope && npm run test:test-review-report && npm run test:test-review-rubric && npm run test:bmad-output-gated && npm run test:release-metadata && npm run test:release-notes && npm run test:lockfile-age && npm run test:lockfile-age-cache && npm run test:licences && npm run test:supply-chain && npm run test:boundary && npm run test:direction && npm run test:lineage && npm run test:guard-publish && npm run test:layering-boundary-lineage && npm run test:changelog && npm run test:tea-workflow-descriptions && npm run test:docs-mermaid && npm run test:llms-headroom && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
+    "test": "npm run test:conflict-markers && npm run test:schemas && npm run test:install && npm run test:evaluate-guidance && npm run test:evaluate-authoring && npm run test:evaluate-gap-loop && npm run test:evaluate-dogfood && npm run test:evaluate-check && npm run test:evaluate-compare && npm run test:evaluate-before-state && npm run test:evaluate-ci-gates && npm run test:evaluate-ci-tiers && npm run test:evaluate-ci-repositories:tagged-release-pr && npm run test:evaluate-ci-repositories:tagged-release-merge && npm run test:evaluate-ci-repositories:tagged-release-release && npm run test:evaluate-ci-repositories:nightly-deploy-pr && npm run test:evaluate-ci-repositories:nightly-deploy-merge && npm run test:evaluate-ci-repositories:nightly-deploy-scheduled && npm run test:evaluate-ci-repositories:nightly-deploy-release && npm run test:evaluate-ci-render && npm run test:evaluate-pr-mcp && npm run test:evaluate-pr-api && npm run test:evaluate-pr-suite && npm run test:evaluate-pr-workflow && npm run test:evaluate-pr-tool-use && npm run test:evaluate-pr-promptfoo && npm run test:evaluate-pr-ai-feature && npm run test:evaluate-pr-test-review && npm run test:evaluate-pr-gap-loop && npm run test:evaluate-pr-learn && npm run test:evaluate-pr-tutorial && npm run test:evaluate-partitions && npm run test:evaluate-partition-plans-views-and-check && npm run test:evaluate-partition-plans-preflight-and-run && npm run test:evaluate-partition-plans-score && npm run test:evaluate-partition-plans-attempts-seal-and-mappings && npm run test:evaluate-partition-plans-attempts-records && npm run test:evaluate-partition-plans-attempts-gameability && npm run test:evaluate-interpret && npm run test:evaluate-calibration && npm run test:evaluate-boundaries && npm run test:evaluate-preflight && npm run test:evaluate-isolation-conformance && npm run test:evaluate-mutation:qualification-basics && npm run test:evaluate-mutation:qualification-guards && npm run test:evaluate-mutation:recovery && npm run test:evaluate-mutation:journals && npm run test:evaluate-run && npm run test:evaluate-aggregate && npm run test:evaluate-confinement && npm run test:evaluate-confinement-audit && npm run test:evaluate-confinement-history && npm run test:evaluate-confinement-git-state && npm run test:evaluate-confinement-network && npm run test:evaluate-held-inputs && npm run test:evaluate-arms-historical && npm run test:evaluate-arms-deployments && npm run test:evaluate-evaluators && npm run test:evaluate-evaluators-agent-version && npm run test:evaluate-agents && npm run test:evaluate-agents-importers && npm run test:evaluate-agents-sealed-brief && npm run test:evaluate-held-attempts && npm run test:evaluate-private && npm run test:evaluate-records && npm run test:evaluate-mcp && npm run test:evaluate-api && npm run test:evaluate-workflow && npm run test:evaluate-tool-use && npm run test:evaluate-promptfoo && npm run test:evaluate-learned-framework && npm run test:docs-tutorial && npm run test:knowledge && npm run test:criteria-fragments && npm run test:doc-count-sources && npm run test:planning-doc-sources && npm run test:doc-counts && npm run test:doc-claim-sources && npm run test:doc-claims && npm run test:doc-invocation-entry && npm run test:doc-invocations && npm run test:doc-link-anchors && npm run test:docs-build-names && npm run test:docs-evaluate-sidebar && npm run test:docs-gap-reader && npm run test:enforce-hook && npm run test:framework-scaffold && npm run test:isolation-primitives && npm run test:atdd-isolation && npm run test:atdd-net-guard && npm run test:atdd-scoring && npm run test:atdd-workflow-guidance && npm run test:generation-healing && npm run test:framework-scaffold-install-isolation && npm run test:transcript-harness && npm run test:suite-manifest && npm run test:teach-me-testing-scoring && npm run test:eval-data && npm run test:eval-atdd-data && npm run test:eval-ci-data && npm run test:eval-framework-scaffold-data && npm run test:eval-nfr-data && npm run test:nfr-validate-corpus && npm run test:nfr-evidence-guidance && npm run test:eval-test-design-data && npm run test:eval-trace-data && npm run test:eval-routing-data && npm run test:eval-routing-boundaries && npm run test:eval-routing-evidence && npm run test:eval-transcript-data && npm run test:eval-teach-me-testing-data && npm run test:eval-schemas && npm run test:eval-diagnostics && npm run test:eval-replay && npm run test:eval-quality-corpus && npm run test:schema-versions && npm run test:contract-sources && npm run test:contracts && npm run test:contract-oracles && npm run test:probe-sources && npm run test:test-design-qualification && npm run test:test-review-qualification && npm run test:trace-qualification && npm run test:nfr-qualification && npm run test:ci-qualification && npm run test:probe-corpus && npm run test:compare-dominance && npm run test:compare-eval-runs && npm run test:trial-set-scoring && npm run test:automate-eval-fixture && npm run test:eval-automate-data && npm run test:clock-port && npm run test:probe-conformance && npm run test:corpus-conformance && npm run test:file-system-conformance && npm run test:file-system-port && npm run test:probe-targets && npm run test:port-totality && npm run test:ci-coverage && npm run test:ci-coverage-filters && npm run test:install-actionlint && npm run test:workflows-lint && npm run test:install-linux-sandbox && npm run test:shards && npm run test:groups && npm run test:cli && npm run test:test-review-pr-scope && npm run test:test-review-report && npm run test:test-review-rubric && npm run test:bmad-output-gated && npm run test:release-metadata && npm run test:release-notes && npm run test:lockfile-age && npm run test:lockfile-age-cache && npm run test:licences && npm run test:supply-chain && npm run test:boundary && npm run test:direction && npm run test:lineage && npm run test:guard-publish && npm run test:layering-boundary-lineage && npm run test:changelog && npm run test:tea-workflow-descriptions && npm run test:docs-mermaid && npm run test:llms-headroom && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
     "test:atdd-isolation": "node test/test-atdd-isolation.js",
     "test:atdd-net-guard": "node test/test-atdd-net-guard.js",
     "test:atdd-scoring": "node test/test-atdd-scoring.js",
@@ -118,9 +118,11 @@
     "test:doc-counts": "eval-quality-gates doc-counts",
     "test:doc-invocation-entry": "node test/test-doc-invocation-entry.js",
     "test:doc-invocations": "eval-quality-gates doc-invocations",
+    "test:doc-link-anchors": "node test/test-doc-link-anchors.js",
     "test:docs-build-names": "node test/test-docs-build-names.js",
     "test:docs-evaluate-sidebar": "node test/test-docs-evaluate-sidebar.js",
     "test:docs-gap-reader": "node test/test-docs-gap-reader.js",
+    "test:docs-layout": "node test/test-docs-layout.js",
     "test:docs-mermaid": "node test/test-docs-mermaid.js",
     "test:docs-tutorial": "node test/test-docs-tutorial.js",
     "test:enforce-hook": "node test/test-enforce-hook.js",
@@ -215,6 +217,7 @@
     "test:file-system-port": "node test/test-file-system-port.js",
     "test:framework-scaffold": "node test/test-framework-scaffold.js",
     "test:framework-scaffold-install-isolation": "node test/test-framework-scaffold-install-isolation.js",
+    "test:generation-healing": "node test/test-generation-healing.js",
     "test:groups": "node test/test-test-groups.js",
     "test:guard-publish": "node test/test-guard-publish.js",
     "test:install": "node test/test-installation-components.js",

package/skills/bmad-tea/SKILL.md

@@ -80,6 +80,10 @@ Dispatch on a clear match by invoking the item's `skill` or executing its `promp
 
 TF invokes `bmad-testarch-framework`, the canonical owner of framework and CI setup. CI invokes the installed `bmad-testarch-ci` compatibility entry with CI scope preset. Preserve both codes, names, custom menu overrides, requested scope and operation. A request for framework and pipeline setup routes directly to TF with `setup_scope = both`. The shared router asks “Do you want CI too?” once when setup leaves CI intent unclear.
 
+### Test Generation Routing
+
+AT invokes `bmad-testarch-atdd`, the red-mode entry of the canonical `bmad-testarch-automate` skill. TA invokes `bmad-testarch-automate` with expand as its default. Preserve both menu codes, both invocation names, custom menu overrides, the requested operation and any explicit red or expand intent. Red writes acceptance tests before implementation and checks the intended failure; expand adds passing coverage for implemented code. Create runs run-and-heal by default in both modes. Validate and Edit report their own checks without repair. A mixed implemented/unimplemented request still needs the deciding scope or sequence when the user has supplied neither.
+
 ### Routing Ambiguity Boundaries
 
 Before dispatching, list the menu items directly supported by facts in the user's message. One supported item is a clear route. Two or more supported items require the missing deciding information when the user has supplied no priority, sequence, or requested deliverable that selects one.

package/skills/bmad-tea/customize.toml

@@ -79,12 +79,12 @@ skill = "bmad-testarch-ci"
 
 [[agent.menu]]
 code = "AT"
-description = "ATDD — generate failing acceptance tests plus an implementation checklist before development"
+description = "ATDD: generate and verify failing acceptance tests in red mode before development"
 skill = "bmad-testarch-atdd"
 
 [[agent.menu]]
 code = "TA"
-description = "Test Automation — generate prioritized API/E2E tests, fixtures, and DoD summary for a story or feature"
+description = "Test Automation: generate prioritized tests in expand mode, run and heal test defects, and report product defects"
 skill = "bmad-testarch-automate"
 
 [[agent.menu]]

package/skills/bmad-teach-me-testing/data/curriculum.yaml

@@ -54,7 +54,7 @@ sessions:
     duration: "60 min"
     difficulty: intermediate
     objective: "Generate tests with TDD red-green approach"
-    description: "ATDD workflow (red phase), Automate workflow, component TDD, API testing"
+    description: "Automation red (ATDD) and expand modes, run and heal, component TDD, API testing"
     recommended_for:
       - intermediate
       - experienced

package/skills/bmad-teach-me-testing/data/quiz-questions.yaml

@@ -147,12 +147,12 @@ session-05-atdd-automate:
       explanation: "Red phase: Tests fail because the code doesn't exist yet. Write tests first, then implement."
 
     - id: q2-atdd-vs-automate
-      question: "What's the difference between ATDD and Automate workflows?"
+      question: "What's the difference between automation red/expand modes?"
       options:
         A: "ATDD generates E2E, Automate generates API tests"
         B: "ATDD writes tests first (red phase), Automate tests existing code"
         C: "ATDD is faster than Automate"
-        D: "They're the same workflow"
+        D: "Both modes require implemented code before generating tests"
       correct: B
       explanation: "ATDD writes failing tests first (red phase), then you implement. Automate generates tests for existing code (coverage expansion)."
 

package/skills/bmad-teach-me-testing/data/role-paths.yaml

@@ -25,7 +25,7 @@ roles:
       session-02-concepts: "Emphasize P0-P3 for defending coverage decisions"
       session-03-architecture: "Fixture patterns for maintainable test suites"
       session-04-test-design: "Test design for planning coverage expansion"
-      session-05-atdd-automate: "ATDD and Automate for test generation"
+      session-05-atdd-automate: "Automation red and expand modes for test generation"
       session-06-quality-trace: "Test Review for quality metrics reporting"
       session-07-advanced: "Playwright Utils for advanced testing patterns"
 

package/skills/bmad-teach-me-testing/data/session-content-map.yaml

@@ -17,7 +17,7 @@ sessions:
         title: "TEA Overview"
         url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/tea-overview/"
       - path: "/docs/how-to/workflows/run-automate.md"
-        title: "Run Automate Workflow"
+        title: "Run Automation Expand Mode"
         url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/"
     knowledge_fragments: []
     online_references:
@@ -28,7 +28,7 @@ sessions:
       - "What is TEA"
       - "TEA Lite approach"
       - "Engagement models"
-      - "10 workflows overview"
+      - "8 workflows overview"
 
   session-02-concepts:
     docs:
@@ -108,10 +108,10 @@ sessions:
   session-05-atdd-automate:
     docs:
       - path: "/docs/how-to/workflows/run-atdd.md"
-        title: "Run ATDD Workflow"
+        title: "Run Automation Red Mode (ATDD)"
         url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-atdd/"
       - path: "/docs/how-to/workflows/run-automate.md"
-        title: "Run Automate Workflow"
+        title: "Run Automation Expand Mode"
         url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/"
     knowledge_fragments:
       - path: "{tea-knowledge}/component-tdd.md"
@@ -127,9 +127,9 @@ sessions:
       - atdd
       - automate
     key_concepts:
-      - "ATDD workflow (red phase)"
+      - "Automation red mode (ATDD)"
       - "TDD red-green-refactor"
-      - "Automate workflow (coverage expansion)"
+      - "Automation expand mode (coverage expansion)"
       - "API testing without browser"
 
   session-06-quality-trace:

package/skills/bmad-teach-me-testing/instructions.md

@@ -43,7 +43,7 @@ The workflow automatically detects existing progress and resumes where you left
 2. **Core Concepts (45 min)** - Risk-based testing, DoD, philosophy
 3. **Architecture (60 min)** - Fixtures, network patterns, framework
 4. **Test Design (60 min)** - Risk assessment workflow
-5. **ATDD & Automate (60 min)** - ATDD + Automate workflows
+5. **ATDD & Automate (60 min)** - Automation red/expand modes
 6. **Quality & Trace (45 min)** - Test review + Trace workflows
 7. **Advanced Patterns (ongoing)** - Menu-driven knowledge fragment exploration
 

package/skills/bmad-teach-me-testing/resources/tea-completion-summary.example.md

@@ -45,7 +45,7 @@ average_score: 92
 Dana Whitfield has demonstrated proficiency in:
 
 - ✅ **Testing Fundamentals:** Risk-based testing, test pyramid, test types, P0-P3 prioritization
-- ✅ **TEA Methodology:** 10 workflows (Teach Me Testing, Framework, Test Design, ATDD, Automate, Test Review, Trace, NFR, CI, Evaluate)
+- ✅ **TEA Methodology:** 8 workflows (Teach Me Testing, Framework and CI Setup, Test Design, Automation, Test Review, Trace, NFR, Evaluate)
 - ✅ **Architecture Patterns:** Fixture composition, network-first patterns, data factories, step-file architecture
 - ✅ **Test Design:** Risk assessment (Probability × Impact), coverage planning, test levels framework
 - ✅ **Test Development:** ATDD red-green TDD approach, test automation, API testing patterns

package/skills/bmad-teach-me-testing/steps-c/step-03-session-menu.md

@@ -110,7 +110,7 @@ Display:
 {if in-progress: Started: {started_date}}
 
 **Session 5: ATDD & Automate (60 min)**
-{status_indicator} ATDD + Automate workflows, TDD approach
+{status_indicator} Automation red/expand modes, TDD approach
 {if completed: Score: {score}/100 | Completed: {completed_date}}
 {if in-progress: Started: {started_date}}
 

package/skills/bmad-teach-me-testing/steps-c/step-04-session-01.md

@@ -93,7 +93,7 @@ Present this content (mostly autonomous, clear and educational):
 
 TEA is a comprehensive test architecture framework that provides:
 
-- **10 Workflows:** Teach Me Testing, Test Design, Framework, CI, ATDD, Automate, Test Review, NFR Evidence Audit, Trace, Evaluate
+- **8 Workflows:** Teach Me Testing, Test Design, Framework and CI Setup, Automation (red and expand modes), Test Review, NFR Evidence Audit, Trace, Evaluate. The CI and ATDD commands and their menu codes remain available.
 - **Framework and CI setup:** One `bmad-testarch-framework` skill handles framework only, CI only, or both. The `bmad-testarch-ci` command and `CI` menu code start its CI setup. TEA infers the scope from your prompt and asks "Do you want CI too?" once when unclear in an interactive session. An unattended request with unclear scope sets up the framework only. Create, Resume, Validate, and Edit choose the operation.
 - **59 Knowledge Fragments:** Distilled expertise on patterns, best practices, Playwright Utils
 - **Quality Standards:** Definition of Done with execution limits (no flaky tests, no hard waits, etc.)
@@ -123,7 +123,7 @@ Present this content (adapt examples based on user role from progress file):
 
 "### 🚀 TEA Lite: Your First Workflow
 
-The **Automate workflow** generates tests for your application automatically.
+The **automation skill** generates tests in two modes: red writes acceptance tests before implementation; expand adds coverage to existing code. This quick start uses expand. Create runs execute generated tests and repair test issues for up to three rounds, while reporting real product defects. Existing ATDD and automate commands and menu codes keep working.
 
 **How it works:**
 
@@ -307,7 +307,7 @@ duration: '30 min'
 
 ## Key Concepts Covered
 
-1. **TEA Framework:** 10 workflows + 59 knowledge fragments + quality standards
+1. **TEA Framework:** 8 workflows + 59 knowledge fragments + quality standards
 2. **Risk-Based Testing:** P0-P3 prioritization matrix
 3. **Quality Standards:** Definition of Done (no flaky tests, no hard waits, stateless, self-cleaning)
 4. **Engagement Models:** Lite, Solo, Integrated, Enterprise, Brownfield

package/skills/bmad-teach-me-testing/steps-c/step-04-session-05.md

@@ -49,8 +49,8 @@ To teach ATDD (red-green TDD) and Automate workflows for test generation in a 60
 
 **What you'll learn:**
 
-- ATDD workflow (failing tests first)
-- Automate workflow (expand coverage)
+- Automation red mode (failing tests first)
+- Automation expand mode (expand coverage)
 - Component TDD
 - API testing patterns
 
@@ -65,18 +65,21 @@ Load {progressFile} and update session-05-atdd-automate:
 
 Save the updated progress file.
 
-### 3. Teaching: ATDD Workflow
+### 3. Teaching: Automation Red Mode (ATDD)
 
 "### 🔴 ATDD: Acceptance-Driven Test Development
 
 **TDD Red Phase:** Write failing tests FIRST
 
-**ATDD Workflow:**
+**Automation red mode:** `/bmad-testarch-atdd` and `AT` select red by default. `/bmad-testarch-automate` also supports an explicit red request.
+
+**Create sequence:**
 
 1. **Preflight:** Check prerequisites
 2. **Test Strategy:** Define what to test
 3. **Generate FAILING Tests:** Red phase (tests fail because code doesn't exist yet)
-4. **Implement Code:** Green phase (make tests pass)
+4. **Run and Heal:** Confirm each failure matches missing behavior; repair test errors for up to three rounds
+5. **Implement Code:** Green phase (make tests pass)
 
 **Why Failing Tests First:**
 
@@ -88,22 +91,27 @@ Save the updated progress file.
 
 **Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-atdd/>"
 
-### 4. Teaching: Automate Workflow
+### 4. Teaching: Automation Expand Mode
 
 "### 🤖 Automate: Expand Test Coverage
 
 **Purpose:** Generate tests for existing features
 
-**Automate Workflow:**
+**Automation expand mode:** `/bmad-testarch-automate` and `TA` select expand by default. An explicit mode in the prompt selects red or expand. Unattended runs keep the invoked command's default when mode is unclear.
+
+**Create sequence:**
 
 1. **Identify Targets:** What needs testing
 2. **Generate Tests:** API and/or E2E tests
-3. **Review & Run:** Tests should pass (code already exists)
+3. **Run and Heal:** Execute generated tests, classify failures, repair test issues, and rerun up to three rounds
+4. **Review Results:** Passing tests establish coverage; real product defects retain their assertions and remain findings
 
-**Difference from ATDD:**
+**Two modes in one automation skill:**
 
 - ATDD: Tests first, then code (red → green)
-- Automate: Code first, then tests (coverage expansion)
+- Expand: Code first, then tests (coverage expansion)
+
+Create runs execute and heal by default. Validate reports findings and Edit checks the requested changes; neither operation repairs tests. Each mode keeps its original customization hooks and output folder.
 
 {Role-adapted example}
 
@@ -176,11 +184,11 @@ D) Tests are deleted"
 
 Correct: A
 
-**Q2:** "What's the difference between ATDD and Automate workflows?
+**Q2:** "What's the difference between automation red/expand modes?
 A) ATDD generates E2E, Automate generates API tests
 B) ATDD writes tests first (red phase), Automate tests existing code
 C) ATDD is faster than Automate
-D) They're the same workflow"
+D) Both modes require implemented code before generating tests"
 
 Correct: B
 
@@ -198,8 +206,8 @@ Calculate score, handle <70% retry.
 
 Create {sessionNotesFile} with Session 5 content:
 
-- ATDD workflow (red-green TDD)
-- Automate workflow (coverage expansion)
+- Automation red mode (ATDD, red-green TDD)
+- Automation expand mode (coverage expansion)
 - Component TDD
 - API testing patterns
 - Docs: ATDD, Automate

package/skills/bmad-teach-me-testing/steps-c/step-05-completion.md

@@ -170,7 +170,7 @@ average_score: { average_score }
 {user_name} has demonstrated proficiency in:
 
 - ✅ **Testing Fundamentals:** Risk-based testing, test pyramid, test types, P0-P3 prioritization
-- ✅ **TEA Methodology:** 10 workflows (Teach Me Testing, Framework, Test Design, ATDD, Automate, Test Review, Trace, NFR, CI, Evaluate)
+- ✅ **TEA Methodology:** 8 workflows (Teach Me Testing, Framework and CI Setup, Test Design, Automation, Test Review, Trace, NFR, Evaluate)
 - ✅ **Architecture Patterns:** Fixture composition, network-first patterns, data factories, step-file architecture
 - ✅ **Test Design:** Risk assessment (Probability × Impact), coverage planning, test levels framework
 - ✅ **Test Development:** ATDD red-green TDD approach, test automation, API testing patterns
@@ -283,7 +283,7 @@ You've successfully completed the entire TEA Academy curriculum!
 **You're now equipped to:**
 
 - Write high-quality tests following TEA principles
-- Use all 10 TEA workflows effectively
+- Use all 8 TEA workflows effectively
 - Apply risk-based testing (P0-P3 prioritization)
 - Implement architecture patterns (fixtures, network-first)
 - Maintain quality through Test Review and Trace

package/skills/bmad-teach-me-testing/templates/completion-summary-template.md

@@ -45,7 +45,7 @@ average_score: { { average_score } }
 {{user_name}} has demonstrated proficiency in:
 
 - ✅ **Testing Fundamentals:** Risk-based testing, test pyramid, test types
-- ✅ **TEA Methodology:** 10 workflows, engagement models, quality standards
+- ✅ **TEA Methodology:** 8 workflows, engagement models, quality standards
 - ✅ **Architecture Patterns:** Fixtures, network-first patterns, data factories
 - ✅ **Test Design:** Risk assessment, coverage planning, P0-P3 prioritization
 - ✅ **Test Development:** ATDD red-green approach, test automation

package/skills/bmad-testarch-atdd/SKILL.md

@@ -3,85 +3,14 @@ name: bmad-testarch-atdd
 description: 'Generate red-phase acceptance test scaffolds using the TDD cycle. Use when the user says "lets write acceptance tests" or "I want to do ATDD"'
 ---
 
-# Acceptance Test-Driven Development (ATDD)
+# Acceptance Test Generation
 
-**Goal:** Generate red-phase acceptance test scaffolds before implementation using TDD red-green-refactor cycle.
+`bmad-testarch-automate` owns test generation in red and expand modes.
+This entry preserves the ATDD command and AT menu code, with red as its default.
 
-**Role:** You are the Master Test Architect.
+1. Preserve the original request, supplied artifacts and Create, Resume, Validate or Edit operation. Set `test_entry = bmad-testarch-atdd`; default to red only when the task has no explicit mode signal.
+2. Set `skill-root` to the sibling `bmad-testarch-automate` directory. Require its `SKILL.md`, `resources/test-generation-routing.md`, `resources/run-and-heal.md`, and `red/steps-c/step-01-preflight-and-context.md`. If any are missing, explain that the canonical skill is missing or older than combined test generation and offer `npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-testarch-automate`. Continue only after installation succeeds and all required files exist.
+3. Read `{skill-root}/SKILL.md` completely and execute its router and activation with the original request. Keep `{skill-root}` canonical throughout. Run only the selected mode's customization hooks; do not activate twice or repeat its operation menu.
 
-You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
-
-## Conventions
-
-- Bare paths (e.g. `instructions.md`) resolve from the skill root.
-- `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
-- `{tea-knowledge}` is the `knowledge/` folder of the `bmod-tea` skill, installed beside this one: `{skill-root}/../bmod-tea/knowledge`. `tea-index.csv` there lists every fragment by a path relative to that folder.
-- `{skill-name}` resolves to the skill directory's basename.
-- Resolve sibling workflow files such as `instructions.md`, `checklist.md`, `steps-c/...`, `steps-e/...`, `steps-v/...`, and templates from `{skill-root}`.
-
-## On Activation
-
-### Step 1: Resolve the Workflow Block
-
-Run: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`
-
-**If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
-
-1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_bmad/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_bmad/custom/{skill-name}.user.toml` — personal overrides
-
-Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
-
-### Step 2: Execute Prepend Steps
-
-Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
-
-### Step 3: Load Persistent Facts
-
-Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs resolved from `{project-root}` — expand them and load every matching file in lexical path order as facts. All other entries are facts verbatim.
-
-### Step 4: Load Config
-
-Run `uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea`. If the script fails, merge `{project-root}/_bmad/config.toml`, `{project-root}/_bmad/custom/config.toml` and `{project-root}/_bmad/custom/config.user.toml` yourself, in that order, with the merge rules above. If `_bmad/config.toml` is missing or has no `modules.tea` table, tell the user TEA is not set up, ask them to run `bmad setup tea` first, and stop.
-
-Each `core` and `modules.tea` key is available as `{<key>}`, and as `config.<key>` in later steps. Replace `{project-root}` inside a value with the project root. Setup answers are strings: read `"true"` and `"false"` as booleans.
-
-If `{tea-knowledge}/tea-index.csv` does not exist, the TEA knowledge base is not installed. Tell the user, offer to install it with `npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea`, run that on a yes, and stop until it is there.
-
-### Step 5: Greet the User
-
-Greet `{user_name}`, speaking in `{communication_language}`.
-
-### Step 6: Execute Append Steps
-
-Execute each entry in `{workflow.activation_steps_append}` in order.
-
-Activation is complete. Begin the workflow below.
-
-## Workflow Architecture
-
-This workflow uses **tri-modal step-file architecture**:
-
-- **Create mode (steps-c/)**: primary execution flow for new runs and resume continuation
-- **Validate mode (steps-v/)**: validation against checklist
-- **Edit mode (steps-e/)**: revise existing outputs
-
-## Initialization Sequence
-
-### 1. Mode Determination
-
-"Welcome to the workflow. What would you like to do?"
-
-- **[C] Create** — Run the workflow from the beginning
-- **[R] Resume** — Resume an interrupted Create workflow
-- **[V] Validate** — Validate existing outputs
-- **[E] Edit** — Edit existing outputs
-
-### 2. Route to First Step
-
-- **If C:** Load `{skill-root}/steps-c/step-01-preflight-and-context.md`
-- **If R:** Load `{skill-root}/steps-c/step-01b-resume.md` (Create-mode continuation)
-- **If V:** Load `{skill-root}/steps-v/step-01-validate.md`
-- **If E:** Load `{skill-root}/steps-e/step-01-assess.md`
+Existing ATDD customization files and checklist paths keep working.
+Resume accepts interrupted 2.0.0 checklists and preserves their story identity and saved next step.

package/skills/bmad-testarch-atdd/bmod.toml

@@ -1,3 +1,4 @@
 [skill]
 bmod = "bmod-tea"
 source = "github:bmad-code-org/bmad-method-test-architecture-enterprise/skills"
+required_skills = ["bmad-testarch-automate"]

package/skills/bmad-testarch-atdd/workflow.yaml

@@ -7,10 +7,10 @@ description: 'Generate red-phase acceptance test scaffolds using TDD cycle. Use
 date: system-generated
 
 # Workflow components
-installed_path: "."
-instructions: "./instructions.md"
-validation: "./checklist.md"
-template: "./atdd-checklist-template.md"
+installed_path: "../bmad-testarch-automate/red"
+instructions: "../bmad-testarch-automate/red/instructions.md"
+validation: "../bmad-testarch-automate/red/checklist.md"
+template: "../bmad-testarch-automate/red/atdd-checklist-template.md"
 
 # Variables and inputs
 variables: