bmad-method-test-architecture-enterprise 1.6.0 → 1.7.1

package/CHANGELOG.md

@@ -212,16 +212,6 @@ All workflows implement the **trivariate step pattern** (Create/Edit/Validate):
 - Agent schema validation for module independence
 - Pre-commit hook compatibility with documentation build process
 
-### Migration Guide
-
-For users migrating from BMM-embedded TEA, see [`docs/MIGRATION.md`](docs/MIGRATION.md) for:
-
-- Command namespace updates
-- Installation instructions
-- Configuration changes
-- Path reference updates
-- Troubleshooting common issues
-
 ### Documentation
 
 - Website: [test-architect.bmad-method.org](https://test-architect.bmad-method.org) (upcoming)
@@ -249,5 +239,3 @@ For users migrating from BMM-embedded TEA, see [`docs/MIGRATION.md`](docs/MIGRAT
   - Complete documentation suite
 
 ---
-
-_For detailed migration instructions, see [docs/MIGRATION.md](docs/MIGRATION.md)_

package/README.md

@@ -29,7 +29,7 @@ Each workflow directory contains these files, and each has a specific job:
 
 | File              | What it does                                                                                                        | When it loads                                                             |
 | ----------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| `tea.agent.yaml`  | Expert persona — identity, principles, critical actions, menu of triggers                                           | First — always in context                                                 |
+| `SKILL.md`        | Expert persona — identity, principles, critical actions, capabilities table                                         | First — always in context                                                 |
 | `workflow.yaml`   | Machine-readable metadata — config variables, required tools, tags                                                  | Second — resolves `{project-root}`, `{config_source}`, `{test_artifacts}` |
 | `workflow.md`     | Human-readable entry point — goals, mode menu (Create/Edit/Validate), routes to first step                          | Second — presents mode choice                                             |
 | `instructions.md` | Workflow-specific rules and context (optional, supplements workflow.md)                                             | On demand                                                                 |
@@ -54,8 +54,8 @@ flowchart LR
 
 ### How It Works at Runtime
 
-1. **Trigger** — Direct commands are `/bmad:tea:automate` (Claude/Cursor/Windsurf) and `$bmad-tea-testarch-automate` (Codex). `TA` is an agent-menu trigger available only after TEA is activated; the menu in `tea.agent.yaml` maps `TA` to `automate/workflow.yaml`.
-2. **Agent loads** — `tea.agent.yaml` injects the persona (identity, principles, critical actions) into the context window.
+1. **Trigger** — Direct commands are `/bmad:tea:automate` (Claude/Cursor/Windsurf) and `$bmad-tea-testarch-automate` (Codex). Load the conversational TEA menu with `$bmad-tea` in Codex. `TA` is an agent-menu trigger available only after TEA is activated; the capabilities table in `SKILL.md` maps `TA` to the `bmad-testarch-automate` skill.
+2. **Agent loads** — `SKILL.md` injects the persona (identity, principles, critical actions) into the context window.
 3. **Workflow loads** — `workflow.yaml` resolves config variables and `workflow.md` presents the mode menu (Create / Edit / Validate), then routes to the first step file.
 4. **Step-by-step execution** — Only the current step file is in context (just-in-time loading). Each step explicitly names the next one (`nextStepFile: './step-02-...'`). The LLM reads, executes, saves output, then loads the next step. No future steps are ever preloaded.
 5. **Knowledge injection** — Step-01 reads `tea-index.csv` and selectively loads fragments by **tier** (core = always, extended = on-demand, specialized = only when relevant) and **config flags** (e.g., `tea_use_pactjs_utils`). This is deliberate context engineering: a backend project loads ~1,800 lines of fragments; a fullstack project loads ~4,500 lines. Conditional loading cuts context usage by 40-50%.
@@ -85,7 +85,7 @@ The key insight is that there is **no external runtime engine** — the LLM _is_
 
 ```text
 .claude/commands/                         # Generated by installer
-├── bmad-agent-tea-tea.md                 # /tea → loads agent persona + menu
+├── bmad-tea.md                           # /tea → loads agent persona + menu
 ├── bmad-tea-testarch-automate.md         # /automate → loads workflow.xml + workflow.yaml
 ├── bmad-tea-testarch-test-design.md      # /test-design → ...
 ├── bmad-bmm-create-prd.md               # /create-prd → BMM workflow
@@ -105,19 +105,20 @@ npx bmad-method install
 
 ### Tool-specific invocation
 
-| Tool                            | Invocation style                | Example                       |
-| ------------------------------- | ------------------------------- | ----------------------------- |
-| Claude Code / Cursor / Windsurf | Slash command                   | `/bmad:tea:automate`          |
-| Codex                           | `$` skill from `.agents/skills` | `$bmad-tea-testarch-automate` |
+| Tool                            | Invocation style                | Example                                      |
+| ------------------------------- | ------------------------------- | -------------------------------------------- |
+| Claude Code / Cursor / Windsurf | Slash command                   | `/bmad:tea:automate`                         |
+| Codex                           | `$` skill from `.agents/skills` | `$bmad-tea` or `$bmad-tea-testarch-automate` |
 
 ## Quickstart
 
 1. Install TEA (above)
-2. Run one of the core workflows:
+2. Load the TEA menu with `$bmad-tea` if you want a conversational entrypoint.
+3. Run one of the core workflows:
    - `TD` / `/bmad:tea:test-design` / `$bmad-tea-testarch-test-design` — test design and risk assessment
    - `AT` / `/bmad:tea:atdd` / `$bmad-tea-testarch-atdd` — failing acceptance tests first (TDD red phase)
    - `TA` / `/bmad:tea:automate` / `$bmad-tea-testarch-automate` — expand automation coverage
-3. Or use in party mode: `/party` to include TEA with other agents
+4. Or use in party mode: `/party` to include TEA with other agents
 
 ## Engagement Models
 
@@ -170,18 +171,18 @@ Workflows load only the fragments required for the current task to stay focused
 src/
 ├── module.yaml
 ├── agents/
-│   └── tea.agent.yaml
+│   └── bmad-tea/              # Native skill: SKILL.md + bmad-skill-manifest.yaml
 ├── workflows/
 │   └── testarch/
-│       ├── atdd/
-│       ├── automate/
-│       ├── ci/
-│       ├── framework/
-│       ├── nfr-assess/
-│       ├── teach-me-testing/
-│       ├── test-design/
-│       ├── test-review/
-│       └── trace/
+│       ├── bmad-teach-me-testing/
+│       ├── bmad-testarch-atdd/
+│       ├── bmad-testarch-automate/
+│       ├── bmad-testarch-ci/
+│       ├── bmad-testarch-framework/
+│       ├── bmad-testarch-nfr/
+│       ├── bmad-testarch-test-design/
+│       ├── bmad-testarch-test-review/
+│       └── bmad-testarch-trace/
 └── testarch/
     ├── tea-index.csv
     └── knowledge/

package/docs/reference/troubleshooting.md

@@ -149,16 +149,16 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
 
 **Solutions**:
 
-1. Verify TEA agent file exists:
+1. Verify TEA agent skill exists:
 
    ```bash
-   ls -la _bmad/tea/agents/tea.agent.yaml
+   ls -la _bmad/tea/agents/bmad-tea/SKILL.md
    ```
 
-2. Validate agent YAML syntax:
+2. Validate agent schema:
 
    ```bash
-   # Check for YAML syntax errors
+   # Check for schema errors
    node tools/validate-agent-schema.js
    ```
 
@@ -191,7 +191,7 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
 
    ```bash
    # Check each workflow
-   cat _bmad/tea/workflows/testarch/test-design/workflow.yaml
+   cat _bmad/tea/workflows/testarch/bmad-testarch-test-design/workflow.yaml
    ```
 
 3. Test workflow trigger directly:
@@ -262,7 +262,7 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
 
    ```bash
    # For automate workflow
-   ls -la _bmad/tea/workflows/testarch/automate/steps-c/step-03*.md
+   ls -la _bmad/tea/workflows/testarch/bmad-testarch-automate/steps-c/step-03*.md
    # Should show: step-03a-*.md, step-03b-*.md, step-03c-aggregate.md
    ```
 
@@ -328,7 +328,7 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
 4. Check workflow manifest:
    ```bash
    # Each workflow.yaml should specify knowledge_fragments
-   grep -A 5 "knowledge_fragments" _bmad/tea/workflows/testarch/test-design/workflow.yaml
+   grep -A 5 "knowledge_fragments" _bmad/tea/workflows/testarch/bmad-testarch-test-design/workflow.yaml
    ```
 
 ---
@@ -682,7 +682,6 @@ When reporting issues, include:
 1. **Documentation**: [test-architect.bmad-method.org](https://test-architect.bmad-method.org)
 2. **GitHub Issues**: [Report a bug](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/issues/new?template=issue.md)
 3. **GitHub Discussions**: [Ask a question](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/discussions)
-4. **Migration Guide**: [docs/MIGRATION.md](/docs/MIGRATION.md) for upgrade issues
 
 ### Before Reporting an Issue
 
@@ -715,7 +714,7 @@ Check these first:
 
 ### "Workflow 'test-design' failed at step 3"
 
-**Fix**: Check step file exists: `_bmad/tea/workflows/testarch/test-design/steps-c/step-03-*`
+**Fix**: Check step file exists: `_bmad/tea/workflows/testarch/bmad-testarch-test-design/steps-c/step-03-*`
 
 ### "Agent YAML validation failed"
 
@@ -737,11 +736,11 @@ Run this validation script:
 #!/bin/bash
 echo "Validating TEA Installation..."
 
-# Check agent file
-if [ -f "_bmad/tea/agents/tea.agent.yaml" ]; then
-  echo "✓ Agent file exists"
+# Check agent skill directory
+if [ -f "_bmad/tea/agents/bmad-tea/SKILL.md" ]; then
+  echo "✓ Agent skill exists"
 else
-  echo "✗ Agent file missing"
+  echo "✗ Agent skill missing"
 fi
 
 # Check workflows

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method-test-architecture-enterprise",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "Master Test Architect for quality strategy, test automation, and release gates",
   "keywords": [
     "bmad",

package/release_notes.md

@@ -1,13 +1,16 @@
-## 🚀 What's New in v1.6.0
+## 🚀 What's New in v1.7.1
 
 ### ✨ New Features
-- feat: refine pactjs automate
+- feat: convert agent to native skill format
+
+### 🐛 Bug Fixes
+- fix: PR comments
+- fix: tea agent start
 
 ### 📦 Other Changes
-- pactjs knowledge base refinements
-- addressed PR comments
-- addressed augment comments
-- Merge pull request #53 from bmad-code-org/feat/refine-pactjs-automate
+- Merge pull request #56 from bmad-code-org/feature/convert-agents-to-skills
+- docs: remove migration
+- Merge pull request #57 from bmad-code-org/fix/tea-agent-start
 
 
 ## 📦 Installation
@@ -17,4 +20,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.5.3...v1.6.0
+**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.7.0...v1.7.1

package/src/agents/bmad-tea/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: bmad-tea
+description: Master Test Architect and Quality Advisor. Use when the user asks to talk to Murat or requests the Test Architect.
+---
+
+# Murat
+
+## Overview
+
+This skill provides a Master Test Architect and Quality Advisor specializing in risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, and scalable quality gates. Act as Murat — data-driven, strong opinions weakly held, speaking in risk calculations and impact assessments.
+
+## Identity
+
+Test architect specializing in risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, and scalable quality gates. Equally proficient in pure API/service-layer testing (pytest, JUnit, Go test, xUnit, RSpec) as in browser-based E2E testing (Playwright, Cypress), consumer driven contract testing (Pact) and performance/load/chaos testing (k6). Supports GitHub Actions, GitLab CI, Jenkins, Azure DevOps, and Harness CI platforms.
+
+## Communication Style
+
+Blends data with gut instinct. "Strong opinions, weakly held" is their mantra. Speaks in risk calculations and impact assessments.
+
+## Principles
+
+- Risk-based testing - depth scales with impact
+- Quality gates backed by data
+- Tests mirror usage patterns (API, UI, or both)
+- Flakiness is critical technical debt
+- Tests first AI implements suite validates
+- Calculate risk vs value for every testing decision
+- Prefer lower test levels (unit > integration > E2E) when possible
+- API tests are first-class citizens, not just UI support
+
+## Critical Actions
+
+- Consult `{project-root}/_bmad/tea/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/tea/testarch/knowledge/` before giving recommendations
+- Cross-check recommendations with the current official Playwright, Cypress, Pact, k6, pytest, JUnit, Go test, and CI platform documentation
+
+You must fully embody this persona so the user gets the best experience and help they need, therefore its important to remember you must not break character until the users dismisses this persona.
+
+When you are in this persona and the user calls a skill, this persona must carry through and remain active.
+
+## Capabilities
+
+| Code | Description                                                                                                                        | Skill                     |
+| ---- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| TMT  | Teach Me Testing: Interactive learning companion - 7 progressive sessions teaching testing fundamentals through advanced practices | bmad-teach-me-testing     |
+| TF   | Test Framework: Initialize production-ready test framework architecture                                                            | bmad-testarch-framework   |
+| AT   | ATDD: Generate failing acceptance tests plus an implementation checklist before development                                        | bmad-testarch-atdd        |
+| TA   | Test Automation: Generate prioritized API/E2E tests, fixtures, and DoD summary for a story or feature                              | bmad-testarch-automate    |
+| TD   | Test Design: Risk assessment plus coverage strategy for system or epic scope                                                       | bmad-testarch-test-design |
+| TR   | Trace Requirements: Map requirements to tests (Phase 1) and make quality gate decision (Phase 2)                                   | bmad-testarch-trace       |
+| NR   | Non-Functional Requirements: Assess NFRs and recommend actions                                                                     | bmad-testarch-nfr         |
+| CI   | Continuous Integration: Recommend and Scaffold CI/CD quality pipeline                                                              | bmad-testarch-ci          |
+| RV   | Review Tests: Perform a quality check against written tests using comprehensive knowledge base and best practices                  | bmad-testarch-test-review |
+
+## On Activation
+
+1. **Load config via bmad-init skill** — Store all returned vars for use:
+   - Use `{user_name}` from config for greeting
+   - Use `{communication_language}` from config for all communications
+   - Store any other config variables as `{var-name}` and use appropriately
+
+2. **Continue with steps below:**
+   - **Load project context** — Search for `**/project-context.md`. If found, load as foundational reference for project standards and conventions. If not found, continue without it.
+   - **Greet and present capabilities** — Greet `{user_name}` warmly by name, always speaking in `{communication_language}` and applying your persona throughout the session.
+
+3. Remind the user they can invoke the `bmad-help` skill at any time for advice and then present the capabilities table from the Capabilities section above.
+
+   **STOP and WAIT for user input** — Do NOT execute menu items automatically. Accept a capability code, skill name, or fuzzy description match from the Capabilities table.
+
+**CRITICAL Handling:** When user responds with a capability code (e.g., TMT, TF, AT), an exact registered skill name, or a fuzzy description match (e.g., "teach me testing", "continuous integration", "test framework"), invoke the corresponding skill from the Capabilities table. DO NOT invent capabilities on the fly or attempt to map arbitrary numeric inputs to skills.

package/src/agents/bmad-tea/bmad-skill-manifest.yaml

@@ -0,0 +1,14 @@
+type: agent
+name: bmad-tea
+displayName: Murat
+title: Master Test Architect and Quality Advisor
+icon: "🧪"
+capabilities: "risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, scalable quality gates, consumer-driven contract testing, performance/load/chaos testing"
+role: Master Test Architect
+identity: "Test architect specializing in risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, and scalable quality gates. Equally proficient in pure API/service-layer testing (pytest, JUnit, Go test, xUnit, RSpec) as in browser-based E2E testing (Playwright, Cypress), consumer driven contract testing (Pact) and performance/load/chaos testing (k6). Supports GitHub Actions, GitLab CI, Jenkins, Azure DevOps, and Harness CI platforms."
+communicationStyle: "Blends data with gut instinct. 'Strong opinions, weakly held' is their mantra. Speaks in risk calculations and impact assessments."
+principles: "Risk-based testing - depth scales with impact. Quality gates backed by data. Tests mirror usage patterns (API, UI, or both). Flakiness is critical technical debt. Tests first AI implements suite validates. Calculate risk vs value for every testing decision. Prefer lower test levels (unit > integration > E2E) when possible. API tests are first-class citizens, not just UI support."
+module: tea
+canonicalId: bmad-tea
+webskip: true
+hasSidecar: false

package/src/module-help.csv

@@ -1,10 +1,10 @@
 module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
-tea,0-learning,Teach Me Testing,TMT,10,_bmad/tea/workflows/testarch/teach-me-testing/workflow.md,bmad-tea-teach-me-testing,false,tea,Create Mode,"Teach testing fundamentals through 7 sessions (TEA Academy)",test_artifacts,"progress file|session notes|certificate",
-tea,3-solutioning,Test Design,TD,10,_bmad/tea/workflows/testarch/test-design/workflow.yaml,bmad-tea-testarch-test-design,false,tea,Create Mode,"Risk-based test planning",test_artifacts,"test design document",
-tea,3-solutioning,Test Framework,TF,20,_bmad/tea/workflows/testarch/framework/workflow.yaml,bmad-tea-testarch-framework,false,tea,Create Mode,"Initialize production-ready test framework",test_artifacts,"framework scaffold",
-tea,3-solutioning,CI Setup,CI,30,_bmad/tea/workflows/testarch/ci/workflow.yaml,bmad-tea-testarch-ci,false,tea,Create Mode,"Configure CI/CD quality pipeline",test_artifacts,"ci config",
-tea,4-implementation,ATDD,AT,10,_bmad/tea/workflows/testarch/atdd/workflow.yaml,bmad-tea-testarch-atdd,false,tea,Create Mode,"Generate failing tests (TDD red phase)",test_artifacts,"atdd tests",
-tea,4-implementation,Test Automation,TA,20,_bmad/tea/workflows/testarch/automate/workflow.yaml,bmad-tea-testarch-automate,false,tea,Create Mode,"Expand test coverage",test_artifacts,"test suite",
-tea,4-implementation,Test Review,RV,30,_bmad/tea/workflows/testarch/test-review/workflow.yaml,bmad-tea-testarch-test-review,false,tea,Validate Mode,"Quality audit (0-100 scoring)",test_artifacts,"review report",
-tea,4-implementation,NFR Assessment,NR,40,_bmad/tea/workflows/testarch/nfr-assess/workflow.yaml,bmad-tea-testarch-nfr,false,tea,Create Mode,"Non-functional requirements",test_artifacts,"nfr report",
-tea,4-implementation,Traceability,TR,50,_bmad/tea/workflows/testarch/trace/workflow.yaml,bmad-tea-testarch-trace,false,tea,Create Mode,"Coverage traceability and gate",test_artifacts,"traceability matrix|gate decision",
+tea,0-learning,Teach Me Testing,TMT,10,skill:bmad-teach-me-testing,bmad-tea-teach-me-testing,false,tea,Create Mode,"Teach testing fundamentals through 7 sessions (TEA Academy)",test_artifacts,"progress file|session notes|certificate",
+tea,3-solutioning,Test Design,TD,10,skill:bmad-testarch-test-design,bmad-tea-testarch-test-design,false,tea,Create Mode,"Risk-based test planning",test_artifacts,"test design document",
+tea,3-solutioning,Test Framework,TF,20,skill:bmad-testarch-framework,bmad-tea-testarch-framework,false,tea,Create Mode,"Initialize production-ready test framework",test_artifacts,"framework scaffold",
+tea,3-solutioning,CI Setup,CI,30,skill:bmad-testarch-ci,bmad-tea-testarch-ci,false,tea,Create Mode,"Configure CI/CD quality pipeline",test_artifacts,"ci config",
+tea,4-implementation,ATDD,AT,10,skill:bmad-testarch-atdd,bmad-tea-testarch-atdd,false,tea,Create Mode,"Generate failing tests (TDD red phase)",test_artifacts,"atdd tests",
+tea,4-implementation,Test Automation,TA,20,skill:bmad-testarch-automate,bmad-tea-testarch-automate,false,tea,Create Mode,"Expand test coverage",test_artifacts,"test suite",
+tea,4-implementation,Test Review,RV,30,skill:bmad-testarch-test-review,bmad-tea-testarch-test-review,false,tea,Validate Mode,"Quality audit (0-100 scoring)",test_artifacts,"review report",
+tea,4-implementation,NFR Assessment,NR,40,skill:bmad-testarch-nfr,bmad-tea-testarch-nfr,false,tea,Create Mode,"Non-functional requirements",test_artifacts,"nfr report",
+tea,4-implementation,Traceability,TR,50,skill:bmad-testarch-trace,bmad-tea-testarch-trace,false,tea,Create Mode,"Coverage traceability and gate",test_artifacts,"traceability matrix|gate decision",

package/src/workflows/testarch/bmad-teach-me-testing/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-teach-me-testing
+description: 'Teach testing progressively through structured sessions. Use when user says "lets learn testing" or "I want to study test practices"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

package/src/workflows/testarch/bmad-teach-me-testing/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

package/src/workflows/testarch/{teach-me-testing → bmad-teach-me-testing}/workflow-plan-teach-me-testing.md

@@ -60,7 +60,7 @@ Create an ongoing learning companion that teaches testing progressively through
 ## Classification Decisions
 
 **Workflow Name:** teach-me-testing
-**Target Path:** {project-root}/src/workflows/testarch/teach-me-testing/
+**Target Path:** {project-root}/src/workflows/testarch/bmad-teach-me-testing/
 
 **4 Key Decisions:**
 
@@ -927,7 +927,7 @@ teach-me-testing/
 `{external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing/`
 
 **Target (Production):**
-`{project-root}/src/workflows/testarch/teach-me-testing/`
+`{project-root}/src/workflows/testarch/bmad-teach-me-testing/`
 
 **Command:**
 

package/src/workflows/testarch/{teach-me-testing → bmad-teach-me-testing}/workflow.md

@@ -1,5 +1,5 @@
 ---
-name: teach-me-testing
+name: bmad-teach-me-testing
 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/bmad-testarch-atdd/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-testarch-atdd
+description: 'Generate failing acceptance tests using TDD cycle. Use when the user says "lets write acceptance tests" or "I want to do ATDD"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

package/src/workflows/testarch/bmad-testarch-atdd/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

package/src/workflows/testarch/{atdd → bmad-testarch-atdd}/instructions.md

@@ -2,7 +2,7 @@
 
 # Acceptance Test-Driven Development (ATDD)
 
-**Workflow ID**: `_bmad/tea/testarch/atdd`
+**Workflow ID**: `_bmad/tea/testarch/bmad-testarch-atdd`
 **Version**: 5.0 (Step-File Architecture)
 
 ---
@@ -35,11 +35,11 @@ From `workflow.yaml`, resolve:
 ### 2. First Step
 
 Load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/atdd/steps-c/step-01-preflight-and-context.md`
+`./steps-c/step-01-preflight-and-context.md`
 
 ### 3. Resume Support
 
 If the user selects **Resume** mode, load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/atdd/steps-c/step-01b-resume.md`
+`./steps-c/step-01b-resume.md`
 
 This checks the output document for progress tracking frontmatter and routes to the next incomplete step.

package/src/workflows/testarch/{atdd → bmad-testarch-atdd}/validation-report-20260127-095021.md

@@ -1,7 +1,7 @@
 ---
 validationDate: 2026-01-27
 workflowName: testarch-atdd
-workflowPath: {project-root}/src/workflows/testarch/atdd
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-atdd
 validationStatus: COMPLETE
 completionDate: 2026-01-27 10:03:10
 ---

package/src/workflows/testarch/{atdd → bmad-testarch-atdd}/validation-report-20260127-102401.md

@@ -1,7 +1,7 @@
 ---
 validationDate: 2026-01-27
 workflowName: testarch-atdd
-workflowPath: {project-root}/src/workflows/testarch/atdd
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-atdd
 validationStatus: COMPLETE
 completionDate: 2026-01-27 10:24:01
 ---

package/src/workflows/testarch/{atdd → bmad-testarch-atdd}/workflow.md

@@ -1,5 +1,5 @@
 ---
-name: testarch-atdd
+name: bmad-testarch-atdd
 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 → bmad-testarch-atdd}/workflow.yaml

@@ -1,5 +1,5 @@
-# Test Architect workflow: atdd
-name: testarch-atdd
+# Test Architect workflow: bmad-testarch-atdd
+name: bmad-testarch-atdd
 # prettier-ignore
 description: 'Generate failing acceptance tests using TDD cycle. Use when the user says "lets write acceptance tests" or "I want to do ATDD"'
 
@@ -13,10 +13,10 @@ document_output_language: "{config_source}:document_output_language"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/_bmad/tea/workflows/testarch/atdd"
-instructions: "{installed_path}/instructions.md"
-validation: "{installed_path}/checklist.md"
-template: "{installed_path}/atdd-checklist-template.md"
+installed_path: "."
+instructions: "./instructions.md"
+validation: "./checklist.md"
+template: "./atdd-checklist-template.md"
 
 # Variables and inputs
 variables:

package/src/workflows/testarch/bmad-testarch-automate/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-testarch-automate
+description: 'Expand test automation coverage for codebase. Use when user says "lets expand test coverage" or "I want to automate tests"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

package/src/workflows/testarch/bmad-testarch-automate/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

package/src/workflows/testarch/{automate → bmad-testarch-automate}/instructions.md

@@ -2,7 +2,7 @@
 
 # Test Automation Expansion
 
-**Workflow ID**: `_bmad/tea/testarch/automate`
+**Workflow ID**: `_bmad/tea/testarch/bmad-testarch-automate`
 **Version**: 5.0 (Step-File Architecture)
 
 ---
@@ -40,11 +40,11 @@ From `workflow.yaml`, resolve:
 ### 2. First Step
 
 Load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/automate/steps-c/step-01-preflight-and-context.md`
+`./steps-c/step-01-preflight-and-context.md`
 
 ### 3. Resume Support
 
 If the user selects **Resume** mode, load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/automate/steps-c/step-01b-resume.md`
+`./steps-c/step-01b-resume.md`
 
 This checks the output document for progress tracking frontmatter and routes to the next incomplete step.

package/src/workflows/testarch/{automate → bmad-testarch-automate}/validation-report-20260127-095021.md

@@ -1,7 +1,7 @@
 ---
 validationDate: 2026-01-27
 workflowName: testarch-automate
-workflowPath: {project-root}/src/workflows/testarch/automate
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-automate
 validationStatus: COMPLETE
 completionDate: 2026-01-27 10:03:10
 ---

package/src/workflows/testarch/{automate → bmad-testarch-automate}/validation-report-20260127-102401.md

@@ -1,7 +1,7 @@
 ---
 validationDate: 2026-01-27
 workflowName: testarch-automate
-workflowPath: {project-root}/src/workflows/testarch/automate
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-automate
 validationStatus: COMPLETE
 completionDate: 2026-01-27 10:24:01
 ---

package/src/workflows/testarch/{automate → bmad-testarch-automate}/workflow.md

@@ -1,5 +1,5 @@
 ---
-name: testarch-automate
+name: bmad-testarch-automate
 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 → bmad-testarch-automate}/workflow.yaml

@@ -1,5 +1,5 @@
-# Test Architect workflow: automate
-name: testarch-automate
+# Test Architect workflow: bmad-testarch-automate
+name: bmad-testarch-automate
 # prettier-ignore
 description: 'Expand test automation coverage for codebase. Use when the user says "lets expand test coverage" or "I want to automate tests"'
 
@@ -13,9 +13,9 @@ document_output_language: "{config_source}:document_output_language"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/_bmad/tea/workflows/testarch/automate"
-instructions: "{installed_path}/instructions.md"
-validation: "{installed_path}/checklist.md"
+installed_path: "."
+instructions: "./instructions.md"
+validation: "./checklist.md"
 template: false
 
 # Variables and inputs

package/src/workflows/testarch/bmad-testarch-ci/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-testarch-ci
+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"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

package/src/workflows/testarch/bmad-testarch-ci/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

package/src/workflows/testarch/{ci → bmad-testarch-ci}/instructions.md

@@ -2,7 +2,7 @@
 
 # CI/CD Pipeline Setup
 
-**Workflow ID**: `_bmad/tea/testarch/ci`
+**Workflow ID**: `_bmad/tea/testarch/bmad-testarch-ci`
 **Version**: 5.0 (Step-File Architecture)
 
 ---
@@ -35,11 +35,11 @@ From `workflow.yaml`, resolve:
 ### 2. First Step
 
 Load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/ci/steps-c/step-01-preflight.md`
+`./steps-c/step-01-preflight.md`
 
 ### 3. Resume Support
 
 If the user selects **Resume** mode, load, read completely, and execute:
-`{project-root}/_bmad/tea/workflows/testarch/ci/steps-c/step-01b-resume.md`
+`./steps-c/step-01b-resume.md`
 
 This checks the output document for progress tracking frontmatter and routes to the next incomplete step.

package/src/workflows/testarch/{ci → bmad-testarch-ci}/steps-c/step-02-generate-pipeline.md

@@ -106,16 +106,16 @@ Resolution precedence:
 
 Determine the pipeline output file path based on the detected `ci_platform`:
 
-| CI Platform      | Output Path                                 | Template File                                       |
-| ---------------- | ------------------------------------------- | --------------------------------------------------- |
-| `github-actions` | `{project-root}/.github/workflows/test.yml` | `{installed_path}/github-actions-template.yaml`     |
-| `gitlab-ci`      | `{project-root}/.gitlab-ci.yml`             | `{installed_path}/gitlab-ci-template.yaml`          |
-| `jenkins`        | `{project-root}/Jenkinsfile`                | `{installed_path}/jenkins-pipeline-template.groovy` |
-| `azure-devops`   | `{project-root}/azure-pipelines.yml`        | `{installed_path}/azure-pipelines-template.yaml`    |
-| `harness`        | `{project-root}/.harness/pipeline.yaml`     | `{installed_path}/harness-pipeline-template.yaml`   |
-| `circle-ci`      | `{project-root}/.circleci/config.yml`       | _(no template; generate from first principles)_     |
-
-Use templates from `{installed_path}` when available. Adapt the template to the project's `test_stack_type` and `test_framework`.
+| CI Platform      | Output Path                                 | Template File                                   |
+| ---------------- | ------------------------------------------- | ----------------------------------------------- |
+| `github-actions` | `{project-root}/.github/workflows/test.yml` | `./github-actions-template.yaml`                |
+| `gitlab-ci`      | `{project-root}/.gitlab-ci.yml`             | `./gitlab-ci-template.yaml`                     |
+| `jenkins`        | `{project-root}/Jenkinsfile`                | `./jenkins-pipeline-template.groovy`            |
+| `azure-devops`   | `{project-root}/azure-pipelines.yml`        | `./azure-pipelines-template.yaml`               |
+| `harness`        | `{project-root}/.harness/pipeline.yaml`     | `./harness-pipeline-template.yaml`              |
+| `circle-ci`      | `{project-root}/.circleci/config.yml`       | _(no template; generate from first principles)_ |
+
+Use templates from `./` when available. Adapt the template to the project's `test_stack_type` and `test_framework`.
 
 ---
 

package/src/workflows/testarch/{ci → bmad-testarch-ci}/validation-report-20260127-095021.md

@@ -1,7 +1,7 @@
 ---
 validationDate: 2026-01-27
 workflowName: testarch-ci
-workflowPath: {project-root}/src/workflows/testarch/ci
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-ci
 validationStatus: COMPLETE
 completionDate: 2026-01-27 10:03:10
 ---