bmad-method-test-architecture-enterprise 1.5.0 → 1.5.1

package/README.md

@@ -54,7 +54,7 @@ flowchart LR
 
 ### How It Works at Runtime
 
-1. **Trigger** — User types `/bmad:tea:automate` (or shorthand `TA`). The agent menu in `tea.agent.yaml` maps the trigger to `automate/workflow.yaml`.
+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.
 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.
@@ -81,9 +81,9 @@ BMad workflows and Claude Code Skills solve different problems at different scal
 
 The key insight is that there is **no external runtime engine** — the LLM _is_ the engine. BMad workflows are structured markdown that the LLM follows as instructions: "read this file, execute it completely, save your output, load the next file." Skills are a single tool in a toolbox; BMad workflows are a workshop with a process manual.
 
-**How workflows become commands.** When you run `npx bmad-method install`, the installer converts every workflow and agent into a Claude Code command in `.claude/commands/`. For example, `bmad-tea-testarch-automate.md` tells the LLM: "load the core workflow engine (`workflow.xml`), pass it this workflow config (`automate/workflow.yaml`), follow the instructions exactly." That single command file is the bridge — it triggers the workflow entry point; the multi-step engine takes over from there.
+**How workflows become commands.** When you run `npx bmad-method install`, the installer generates tool-specific artifacts for your runtime (for example, Claude Code uses `.claude/commands/`, while Codex uses `.agents/skills/`). In Claude Code, `bmad-tea-testarch-automate.md` tells the LLM: "load the core workflow engine (`workflow.xml`), pass it this workflow config (`automate/workflow.yaml`), follow the instructions exactly." That launcher artifact is the bridge — it triggers the workflow entry point; the multi-step engine takes over from there.
 
-```
+```text
 .claude/commands/                         # Generated by installer
 ├── bmad-agent-tea-tea.md                 # /tea → loads agent persona + menu
 ├── bmad-tea-testarch-automate.md         # /automate → loads workflow.xml + workflow.yaml
@@ -103,13 +103,20 @@ npx bmad-method install
 
 **Note:** TEA is automatically added to party mode after installation. Use `/party` to collaborate with TEA alongside other BMad agents.
 
+### 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` |
+
 ## Quickstart
 
 1. Install TEA (above)
 2. Run one of the core workflows:
-   - `TD` / `/bmad:tea:test-design` — test design and risk assessment
-   - `AT` / `/bmad:tea:atdd` — failing acceptance tests first (TDD red phase)
-   - `TA` / `/bmad:tea:automate` — expand automation coverage
+   - `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
 
 ## Engagement Models
@@ -121,17 +128,17 @@ npx bmad-method install
 
 ## Workflows
 
-| Trigger | Command                      | Purpose                                                   |
-| ------- | ---------------------------- | --------------------------------------------------------- |
-| TMT     | `/bmad:tea:teach-me-testing` | Teach Me Testing (TEA Academy)                            |
-| TF      | `/bmad:tea:framework`        | Scaffold test framework (frontend, backend, or fullstack) |
-| CI      | `/bmad:tea:ci`               | Set up CI/CD quality pipeline (multi-platform)            |
-| TD      | `/bmad:tea:test-design`      | System-level or epic-level test design                    |
-| AT      | `/bmad:tea:atdd`             | Generate failing acceptance tests + checklist             |
-| TA      | `/bmad:tea:automate`         | Expand test automation coverage                           |
-| RV      | `/bmad:tea:test-review`      | Review test quality and score                             |
-| TR      | `/bmad:tea:trace`            | Trace requirements to tests + gate decision               |
-| NR      | `/bmad:tea:nfr-assess`       | Assess non-functional requirements                        |
+| Trigger | Slash Command                | Codex Skill                      | Purpose                                                   |
+| ------- | ---------------------------- | -------------------------------- | --------------------------------------------------------- |
+| TMT     | `/bmad:tea:teach-me-testing` | `$bmad-tea-teach-me-testing`     | Teach Me Testing (TEA Academy)                            |
+| TF      | `/bmad:tea:framework`        | `$bmad-tea-testarch-framework`   | Scaffold test framework (frontend, backend, or fullstack) |
+| CI      | `/bmad:tea:ci`               | `$bmad-tea-testarch-ci`          | Set up CI/CD quality pipeline (multi-platform)            |
+| TD      | `/bmad:tea:test-design`      | `$bmad-tea-testarch-test-design` | System-level or epic-level test design                    |
+| AT      | `/bmad:tea:atdd`             | `$bmad-tea-testarch-atdd`        | Generate failing acceptance tests + checklist             |
+| TA      | `/bmad:tea:automate`         | `$bmad-tea-testarch-automate`    | Expand test automation coverage                           |
+| RV      | `/bmad:tea:test-review`      | `$bmad-tea-testarch-test-review` | Review test quality and score                             |
+| TR      | `/bmad:tea:trace`            | `$bmad-tea-testarch-trace`       | Trace requirements to tests + gate decision               |
+| NR      | `/bmad:tea:nfr-assess`       | `$bmad-tea-testarch-nfr`         | Assess non-functional requirements                        |
 
 ## Configuration
 

package/docs/MIGRATION.md

@@ -36,6 +36,10 @@ All TEA commands have changed namespace from `/bmad:bmm:tea:*` to `/bmad:tea:*`.
 | `TF`, `CI`, `TD`, `AT`, `TA`   | Same                     |
 | `RV`, `TR`, `NR`               | Same                     |
 
+Codex skill-mode workflow equivalents: `framework` → `$bmad-tea-testarch-framework`, `ci` → `$bmad-tea-testarch-ci`, `test-design` → `$bmad-tea-testarch-test-design`, `atdd` → `$bmad-tea-testarch-atdd`, `automate` → `$bmad-tea-testarch-automate`, `test-review` → `$bmad-tea-testarch-test-review`, `trace` → `$bmad-tea-testarch-trace`, `nfr-assess` → `$bmad-tea-testarch-nfr`, `teach-me-testing` → `$bmad-tea-teach-me-testing`.
+
+Clarification: short triggers like `TD` and `TA` are agent menu triggers after TEA activation; invocation differs by tool (slash commands vs Codex skill calls).
+
 **Action Required**: Update any saved prompts, scripts, or documentation that reference the old commands.
 
 ### 2. Module Installation
@@ -172,6 +176,8 @@ claude "/bmad:bmm:tea:test-design"
 claude "/bmad:tea:test-design"
 ```
 
+Codex skill mode (in Codex chat): `$bmad-tea-testarch-test-design`
+
 **Example: Updating Documentation**
 
 ```markdown
@@ -184,6 +190,8 @@ Run `/bmad:bmm:tea:automate` to expand test coverage.
 Run `/bmad:tea:automate` to expand test coverage.
 ```
 
+Codex skill-mode equivalent: use `$bmad-tea-testarch-automate`.
+
 ### Step 4: Verify Installation
 
 Load the TEA agent and run a test command:
@@ -353,12 +361,15 @@ See [Configure Browser Automation](/docs/how-to/customization/configure-browser-
 
 **Solution**: Update to new namespace:
 
-```bash
+```text
 # Old (won't work)
 /bmad:bmm:tea:test-design
 
 # New (correct)
 /bmad:tea:test-design
+
+# Codex skill mode
+$bmad-tea-testarch-test-design
 ```
 
 ### Issue: Configuration Variables Not Set
@@ -427,7 +438,7 @@ Use this checklist to ensure a smooth migration:
 - [ ] Verify BMAD Method version is v7.0.0 or later
 - [ ] Install standalone TEA module via `npx bmad-method install`
 - [ ] Configure TEA variables (test_artifacts, Playwright Utils, MCP)
-- [ ] Update saved prompts to use new namespace (`/bmad:tea:*`)
+- [ ] Update saved invocations for your tool (`/bmad:tea:*` for slash-command tools, or `$bmad-tea-*` skills for Codex)
 - [ ] Update documentation references to new commands
 - [ ] Update CI/CD scripts if they invoke TEA commands
 - [ ] Test each workflow you use (e.g., `test-design`, `automate`, `atdd`)

package/docs/how-to/customization/configure-browser-automation.md

@@ -33,7 +33,7 @@ npm install -g @playwright/cli@latest    # Install globally (Node.js 18+)
 playwright-cli install --skills          # Register as an agent skill
 ```
 
-The global npm install is one-time. The skills install (`playwright-cli install --skills`) should be run from your project root — it registers skills in your project's `.claude/skills/` directory (Claude Code, GitHub Copilot, and other coding agents that support the skills convention). Agents without skills support can still use the CLI directly via `playwright-cli --help`.
+The global npm install is one-time. The skills install (`playwright-cli install --skills`) should be run from your project root — it registers skills in your active tool's project skills directory (for example, Claude Code uses `.claude/skills/` and Codex uses `.agents/skills/`). Agents without skills support can still use the CLI directly via `playwright-cli --help`.
 
 ### For MCP (`mcp` or `auto` mode)
 

package/docs/reference/commands.md

@@ -7,6 +7,11 @@ description: Quick reference for all 9 TEA workflows - inputs, outputs, and link
 
 Quick reference for all 9 TEA (Test Engineering Architect) workflows. For detailed step-by-step guides, see the how-to documentation.
 
+**Invocation by tool:**
+
+- Claude Code / Cursor / Windsurf: use slash commands (for example, `/bmad:tea:automate`)
+- Codex: use `$` skills from `.agents/skills` (for example, `$bmad-tea-testarch-automate`)
+
 ## Quick Index
 
 - [`teach-me-testing`](#teach-me-testing) - Learn testing (TEA Academy)

package/docs/reference/troubleshooting.md

@@ -195,9 +195,13 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
    ```
 
 3. Test workflow trigger directly:
-   ```bash
-   # Try full command
+
+   ```text
+   # Try full slash command
    /bmad:tea:test-design
+
+   # Codex skill-mode alternative
+   $bmad-tea-testarch-test-design
    ```
 
 ---
@@ -685,7 +689,7 @@ When reporting issues, include:
 Check these first:
 
 - [ ] TEA is installed: `ls -la _bmad/tea/`
-- [ ] Using correct command namespace: `/bmad:tea:*` not `/bmad:bmm:tea:*`
+- [ ] Using the correct invocation for your tool: slash namespace `/bmad:tea:*` (not `/bmad:bmm:tea:*`) or Codex skill equivalents (`$bmad-tea-*`)
 - [ ] Module.yaml exists and is valid
 - [ ] Knowledge base files present (40 fragments)
 - [ ] Output directory exists and is writable

package/package.json

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

package/release_notes.md

@@ -1,11 +1,10 @@
-## 🚀 What's New in v1.5.0
-
-### ✨ New Features
-- feat: harden generated ci related yml
+## 🚀 What's New in v1.5.1
 
 ### 📦 Other Changes
-- addressed PR comments
-- Merge pull request #49 from bmad-code-org/feat/harden-generated-ci-related-yml
+- docs: update codex skill mode
+- review comment
+- review comments 2
+- Merge pull request #50 from bmad-code-org/docs/update-codex-skill-mode
 
 
 ## 📦 Installation
@@ -15,4 +14,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.4.1...v1.5.0
+**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.5.0...v1.5.1