ma-agents 3.5.3 → 3.5.5

package/bin/cli.js

@@ -1,11 +1,40 @@
 #!/usr/bin/env node
 
+// Bug A fix — suppress the cosmetic Node.js ExperimentalWarning about
+// CommonJS require() of an ES Module. Must be installed BEFORE any
+// other require() so the filter catches warnings fired by the very
+// first dependency-loading call below. See lib/warning-filter.js.
+//
+// Re-exec gating:
+//   - Only when this file is launched as the CLI (require.main === module).
+//     When imported by the test suite or another script, skip the re-exec
+//     path — otherwise the importing process would silently fork itself.
+//   - Only for commands that can trigger the CJS-require-ESM warning,
+//     i.e. those that spawn bmad-method or otherwise load the heavy
+//     transitive dependency graph. Informational commands (--help,
+//     --version, status, list, agents) stay single-process for fast
+//     cold start. The listener-only fallback is still attached so
+//     in-process warnings still route through our filter.
+const { installExperimentalWarningFilter } = require('../lib/warning-filter');
+const _reexecCommands = new Set([
+  'install', 'uninstall', 'remove',
+  'create-skill', 'validate-skill', 'set-mandatory',
+  'customize-agent', 'create-agent',
+  'config',
+  undefined, // bare `ma-agents` → interactive wizard
+]);
+const _firstArg = process.argv[2];
+installExperimentalWarningFilter({
+  reexec: require.main === module && _reexecCommands.has(_firstArg),
+});
+
 const prompts = require('prompts');
 const chalk = require('chalk');
 const path = require('path');
 const fs = require('fs');
 const { execFileSync } = require('child_process');
 const { installSkill, uninstallSkill, getStatus, listSkills, listAgents, updateProjectContextRepoLayout } = require('../lib/installer');
+const { getProfile, setProfile, resolveProfile } = require('../lib/profile');
 const bmad = require('../lib/bmad');
 const { getBmadPlatformCode } = require('../lib/agents');
 const { handleCreateSkill, handleValidateSkill, handleSetMandatory, handleCustomizeAgent, handleCreateAgent } = require('../lib/skill-authoring');
@@ -173,7 +202,10 @@ function parseFlags(args) {
   const yesFlag = args.includes('--yes');
   let customPath = '';
   let agentFlag = '';
-  let positional = [...args].filter(a => a !== '--global' && a !== '--force' && a !== '--yes');
+
+  let positional = [...args].filter(a =>
+    a !== '--global' && a !== '--force' && a !== '--yes'
+  );
 
   const pathIdx = positional.indexOf('--path');
   if (pathIdx !== -1) {
@@ -824,6 +856,43 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
     }
   }
 
+  // Step 2.4: Profile resolution (Story 21.1, ACs #7–#9)
+  // Must run AFTER agent selection and BEFORE repo layout, so downstream stories
+  // can gate layout-related guidance on profile. setProfile() is called BEFORE
+  // any agent install runs — guaranteeing persistence even if a later step fails.
+  // Profile lives at the project root (cwd), NOT the custom skills-install path.
+  const projectRootForProfile = process.cwd();
+  const persistedProfile = getProfile(projectRootForProfile);
+  let resolvedProfile = resolveProfile({
+    persisted: persistedProfile,
+    yesMode: yesFlag
+  });
+  let profileSource;
+  if (persistedProfile) profileSource = '.ma-agents.json';
+  else if (resolvedProfile === 'standard' && yesFlag) profileSource = '--yes default';
+
+  if (resolvedProfile === null) {
+    const { chosenProfile } = await prompts({
+      type: 'select',
+      name: 'chosenProfile',
+      message: 'Is this an on-prem / air-gapped install using a local LLM (e.g. Nemotron)?',
+      choices: [
+        { title: 'Yes — apply local-LLM guardrails (recommended for non-Claude models)', value: 'on-prem' },
+        { title: 'No  — standard install (Claude on web, Anthropic API, etc.)', value: 'standard' }
+      ],
+      initial: 1
+    });
+    if (!chosenProfile) process.exit(0);
+    resolvedProfile = chosenProfile;
+    profileSource = 'interactive prompt';
+  }
+
+  console.log(chalk.cyan(`Using profile: ${resolvedProfile} (from ${profileSource})`));
+
+  // Persist BEFORE any agent install step (AC #9). setProfile bootstraps the
+  // manifest via ensureManifest when absent.
+  setProfile(projectRootForProfile, resolvedProfile);
+
   // Step 2.5: Repository layout (preserve existing config on update)
   const existingLayout = isUpdate ? readExistingLayout() : null;
   const repoLayout = await collectRepoLayout({ yes: yesFlag }, existingLayout);
@@ -1077,6 +1146,45 @@ async function handleInstall(args) {
     return;
   }
 
+  // Direct install path — Story 21.1 AC #9, #11: resolve + persist profile BEFORE install.
+  // Profile lives at the project root (cwd), not the custom skills-install path.
+  // When stdin is not a TTY and nothing is resolvable, default to 'standard' (same
+  // behavior as --yes) rather than aborting — keeps CI/CD direct installs working.
+  const projectRootForProfile = process.cwd();
+  const persistedProfile = getProfile(projectRootForProfile);
+  let resolvedProfile = resolveProfile({
+    persisted: persistedProfile,
+    yesMode: yesFlag
+  });
+  let profileSource;
+  if (persistedProfile) profileSource = '.ma-agents.json';
+  else if (resolvedProfile === 'standard' && yesFlag) profileSource = '--yes default';
+
+  if (resolvedProfile === null) {
+    if (!process.stdin.isTTY) {
+      // Non-interactive fallback: default to 'standard' and persist (mirrors --yes).
+      resolvedProfile = 'standard';
+      profileSource = '--yes default';
+    } else {
+      const { chosenProfile } = await prompts({
+        type: 'select',
+        name: 'chosenProfile',
+        message: 'Is this an on-prem / air-gapped install using a local LLM (e.g. Nemotron)?',
+        choices: [
+          { title: 'Yes — apply local-LLM guardrails (recommended for non-Claude models)', value: 'on-prem' },
+          { title: 'No  — standard install (Claude on web, Anthropic API, etc.)', value: 'standard' }
+        ],
+        initial: 1
+      });
+      if (!chosenProfile) process.exit(0);
+      resolvedProfile = chosenProfile;
+      profileSource = 'interactive prompt';
+    }
+  }
+
+  console.log(chalk.cyan(`Using profile: ${resolvedProfile} (from ${profileSource})`));
+  setProfile(projectRootForProfile, resolvedProfile);
+
   // Full args → direct install (Task 3.5)
   const targetAgents = agentFlag ? [agentFlag] : agentIds;
   try {

package/lib/bmad-cache/bmb/_git_preserved/logs/HEAD

@@ -1 +1 @@
-0000000000000000000000000000000000000000 605e07656f9f633b5e429297388e1db9687d1996 Alon Mayaffit <alon.mayafit@gmail.com> 1775729260 +0300	clone: from https://github.com/bmad-code-org/bmad-builder
+0000000000000000000000000000000000000000 f8b793001493ec991b718a3f41cf73e6743f3dc6 Alon Mayaffit <alon.mayafit@gmail.com> 1776150101 +0300	clone: from https://github.com/bmad-code-org/bmad-builder

package/lib/bmad-cache/bmb/_git_preserved/logs/refs/heads/main

@@ -1 +1 @@
-0000000000000000000000000000000000000000 605e07656f9f633b5e429297388e1db9687d1996 Alon Mayaffit <alon.mayafit@gmail.com> 1775729260 +0300	clone: from https://github.com/bmad-code-org/bmad-builder
+0000000000000000000000000000000000000000 f8b793001493ec991b718a3f41cf73e6743f3dc6 Alon Mayaffit <alon.mayafit@gmail.com> 1776150101 +0300	clone: from https://github.com/bmad-code-org/bmad-builder

package/lib/bmad-cache/bmb/_git_preserved/logs/refs/remotes/origin/HEAD

@@ -1 +1 @@
-0000000000000000000000000000000000000000 605e07656f9f633b5e429297388e1db9687d1996 Alon Mayaffit <alon.mayafit@gmail.com> 1775729260 +0300	clone: from https://github.com/bmad-code-org/bmad-builder
+0000000000000000000000000000000000000000 f8b793001493ec991b718a3f41cf73e6743f3dc6 Alon Mayaffit <alon.mayafit@gmail.com> 1776150101 +0300	clone: from https://github.com/bmad-code-org/bmad-builder

package/lib/bmad-cache/bmb/_git_preserved/packed-refs

@@ -1,2 +1,2 @@
 # pack-refs with: peeled fully-peeled sorted 
-605e07656f9f633b5e429297388e1db9687d1996 refs/remotes/origin/main
+f8b793001493ec991b718a3f41cf73e6743f3dc6 refs/remotes/origin/main

package/lib/bmad-cache/bmb/_git_preserved/refs/heads/main

@@ -1 +1 @@
-605e07656f9f633b5e429297388e1db9687d1996
+f8b793001493ec991b718a3f41cf73e6743f3dc6

package/lib/bmad-cache/bmb/_git_preserved/shallow

@@ -1 +1 @@
-605e07656f9f633b5e429297388e1db9687d1996
+f8b793001493ec991b718a3f41cf73e6743f3dc6

package/lib/bmad-cache/bmb/skills/bmad-module-builder/scripts/tests/test-scaffold-setup-skill.py

@@ -95,6 +95,12 @@ def test_skill_md_frontmatter_substitution():
         assert "{module-code}" not in skill_md
 
 
+def test_template_frontmatter_uses_quoted_name_placeholder():
+    """Test that the template frontmatter is valid before substitution."""
+    template_skill_md = (TEMPLATE_DIR / "SKILL.md").read_text()
+    assert 'name: "{setup-skill-name}"' in template_skill_md
+
+
 def test_generated_files_written():
     """Test that module.yaml and module-help.csv contain generated content."""
     with tempfile.TemporaryDirectory() as tmp:
@@ -201,6 +207,7 @@ if __name__ == "__main__":
     tests = [
         test_basic_scaffold,
         test_skill_md_frontmatter_substitution,
+        test_template_frontmatter_uses_quoted_name_placeholder,
         test_generated_files_written,
         test_anti_zombie_replaces_existing,
         test_missing_target_dir,

package/lib/bmad-cache/cache-manifest.json

@@ -1,12 +1,12 @@
 {
-  "generated": "2026-04-09T16:00:08.461Z",
+  "generated": "2026-04-14T07:01:59.067Z",
   "bmadMethodVersion": "6.2.2",
   "modules": {
     "bmb": {
       "url": "https://github.com/bmad-code-org/bmad-builder",
       "branch": "main",
-      "commitSha": "605e07656f9f633b5e429297388e1db9687d1996",
-      "clonedAt": "2026-04-09T10:07:44.090Z"
+      "commitSha": "f8b793001493ec991b718a3f41cf73e6743f3dc6",
+      "clonedAt": "2026-04-14T07:01:41.831Z"
     },
     "cis": {
       "url": "https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite",
@@ -23,8 +23,8 @@
     "tea": {
       "url": "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise",
       "branch": "main",
-      "commitSha": "05472f9f4ad0a3aeeff445252bd4dd342667f34a",
-      "clonedAt": "2026-04-08T21:19:51.612Z"
+      "commitSha": "a7dfc0d9bd1b1b75203e8eedfb940ae130fe15e5",
+      "clonedAt": "2026-04-14T07:01:58.082Z"
     },
     "wds": {
       "url": "https://github.com/bmad-code-org/bmad-method-wds-expansion",

package/lib/bmad-cache/tea/_git_preserved/packed-refs

@@ -1,2 +1,2 @@
 # pack-refs with: peeled fully-peeled sorted 
-05472f9f4ad0a3aeeff445252bd4dd342667f34a refs/remotes/origin/main
+a7dfc0d9bd1b1b75203e8eedfb940ae130fe15e5 refs/remotes/origin/main

package/lib/bmad-cache/tea/_git_preserved/refs/heads/main

@@ -1 +1 @@
-05472f9f4ad0a3aeeff445252bd4dd342667f34a
+a7dfc0d9bd1b1b75203e8eedfb940ae130fe15e5

package/lib/bmad-cache/tea/_git_preserved/refs/tags/v1.10.0

@@ -0,0 +1 @@
+1cad3ab608bd2ac19c1d4f866bdf69b0f00e363c

package/lib/bmad-cache/tea/_git_preserved/shallow

@@ -1 +1 @@
-05472f9f4ad0a3aeeff445252bd4dd342667f34a
+a7dfc0d9bd1b1b75203e8eedfb940ae130fe15e5

package/lib/bmad-cache/tea/docs/explanation/tea-overview.md

@@ -69,7 +69,7 @@ If you are unsure, default to the integrated path for your track and adjust late
 | `framework`   | Playwright/Cypress scaffold, `.env.example`, `.nvmrc`, sample specs                           | Use when no production-ready harness exists          | -                                                                                                                                    |
 | `ci`          | CI workflow, selective test scripts, secrets checklist                                        | Platform-aware (GitHub Actions default)              | -                                                                                                                                    |
 | `test-design` | Combined risk assessment, mitigation plan, and coverage strategy                              | Risk scoring + optional exploratory mode             | **+ Exploratory**: Interactive UI discovery with browser automation (uncover actual functionality)                                   |
-| `atdd`        | Failing acceptance tests + implementation checklist                                           | TDD red phase + optional recording mode              | **+ Recording**: UI selectors verified with live browser; API tests benefit from trace analysis                                      |
+| `atdd`        | Red-phase acceptance test scaffolds + implementation checklist                                | TDD red phase + optional recording mode              | **+ Recording**: UI selectors verified with live browser; API tests benefit from trace analysis                                      |
 | `automate`    | Prioritized specs, fixtures, README/script updates, DoD summary                               | Optional healing/recording, avoid duplicate coverage | **+ Healing**: Visual debugging + trace analysis for test fixes; **+ Recording**: Verified selectors (UI) + network inspection (API) |
 | `test-review` | Test quality review report with 0-100 score, violations, fixes                                | Reviews tests against knowledge base patterns        | -                                                                                                                                    |
 | `nfr-assess`  | NFR assessment report with actions                                                            | Focus on security/performance/reliability            | -                                                                                                                                    |
@@ -426,7 +426,7 @@ Optional MCP integration for design-time broker interaction in contract testing
 2. [How to Set Up a Test Framework with TEA](/docs/how-to/workflows/setup-test-framework.md) - Scaffold Playwright or Cypress
 3. [How to Set Up CI Pipeline with TEA](/docs/how-to/workflows/setup-ci.md) - Configure CI/CD with selective testing
 4. [How to Run Test Design with TEA](/docs/how-to/workflows/run-test-design.md) - Risk-based test planning (system or epic)
-5. [How to Run ATDD with TEA](/docs/how-to/workflows/run-atdd.md) - Generate failing tests before implementation
+5. [How to Run ATDD with TEA](/docs/how-to/workflows/run-atdd.md) - Generate red-phase test scaffolds before implementation
 6. [How to Run Automate with TEA](/docs/how-to/workflows/run-automate.md) - Expand test coverage after implementation
 7. [How to Run Test Review with TEA](/docs/how-to/workflows/run-test-review.md) - Audit test quality (0-100 scoring)
 8. [How to Run NFR Assessment with TEA](/docs/how-to/workflows/run-nfr-assess.md) - Validate non-functional requirements

package/lib/bmad-cache/tea/docs/how-to/workflows/run-atdd.md

@@ -1,11 +1,11 @@
 ---
 title: 'How to Run ATDD with TEA'
-description: Generate failing acceptance tests before implementation using TEA's ATDD workflow
+description: Generate red-phase acceptance test scaffolds before implementation using TEA's ATDD workflow
 ---
 
 # How to Run ATDD with TEA
 
-Use TEA's `atdd` workflow to generate failing acceptance tests BEFORE implementation. This is the TDD (Test-Driven Development) red phase - tests fail first, guide development, then pass.
+Use TEA's `atdd` workflow to generate red-phase acceptance test scaffolds BEFORE implementation. TEA currently emits these scaffolds with `test.skip()` so they can be reviewed, linked into the story, and activated task-by-task during implementation.
 
 ## When to Use This
 
@@ -118,7 +118,7 @@ Generate:
 
 ### 5. Review Generated Tests
 
-TEA generates **failing tests** in appropriate directories:
+TEA generates **red-phase test scaffolds** in appropriate directories:
 
 #### API Tests (`tests/api/profile.spec.ts`):
 
@@ -128,7 +128,7 @@ TEA generates **failing tests** in appropriate directories:
 import { test, expect } from '@playwright/test';
 
 test.describe('Profile API', () => {
-  test('should fetch user profile', async ({ request }) => {
+  test.skip('should fetch user profile', async ({ request }) => {
     const response = await request.get('/api/profile');
 
     expect(response.status()).toBe(200);
@@ -138,7 +138,7 @@ test.describe('Profile API', () => {
     expect(profile).toHaveProperty('avatarUrl');
   });
 
-  test('should update user profile', async ({ request }) => {
+  test.skip('should update user profile', async ({ request }) => {
     const response = await request.patch('/api/profile', {
       data: {
         name: 'Updated Name',
@@ -152,7 +152,7 @@ test.describe('Profile API', () => {
     expect(updated.email).toBe('updated@example.com');
   });
 
-  test('should validate email format', async ({ request }) => {
+  test.skip('should validate email format', async ({ request }) => {
     const response = await request.patch('/api/profile', {
       data: {
         email: 'invalid-email',
@@ -180,7 +180,7 @@ const ProfileSchema = z.object({
 });
 
 test.describe('Profile API', () => {
-  test('should fetch user profile', async ({ apiRequest }) => {
+  test.skip('should fetch user profile', async ({ apiRequest }) => {
     const { status, body } = await apiRequest({
       method: 'GET',
       path: '/api/profile',
@@ -192,7 +192,7 @@ test.describe('Profile API', () => {
     expect(body.email).toContain('@');
   });
 
-  test('should update user profile', async ({ apiRequest }) => {
+  test.skip('should update user profile', async ({ apiRequest }) => {
     const { status, body } = await apiRequest({
       method: 'PATCH',
       path: '/api/profile',
@@ -207,7 +207,7 @@ test.describe('Profile API', () => {
     expect(body.email).toBe('updated@example.com');
   });
 
-  test('should validate email format', async ({ apiRequest }) => {
+  test.skip('should validate email format', async ({ apiRequest }) => {
     const { status, body } = await apiRequest({
       method: 'PATCH',
       path: '/api/profile',
@@ -233,7 +233,7 @@ test.describe('Profile API', () => {
 ```typescript
 import { test, expect } from '@playwright/test';
 
-test('should edit and save profile', async ({ page }) => {
+test.skip('should edit and save profile', async ({ page }) => {
   // Login first
   await page.goto('/login');
   await page.getByLabel('Email').fill('test@example.com');
@@ -280,14 +280,14 @@ TEA also provides an implementation checklist:
 
 ### Tests
 
-- [x] API tests generated (failing)
-- [x] E2E tests generated (failing)
-- [ ] Run tests after implementation (should pass)
+- [x] API test scaffolds generated (`test.skip()`)
+- [x] E2E test scaffolds generated (`test.skip()`)
+- [ ] Activate and run tests during implementation (should fail before code changes, then pass)
 ```
 
-### 6. Verify Tests Fail
+### 6. Verify Red-Phase Scaffolds
 
-This is the TDD red phase - tests MUST fail before implementation.
+This is the TDD red phase, but TEA keeps generated tests in `test.skip()` until you're ready to work on a task. Review the generated files, then remove `test.skip()` for the current task and confirm that the newly activated test fails before you implement the feature.
 
 **For Playwright:**
 
@@ -301,21 +301,19 @@ npx playwright test
 npx cypress run
 ```
 
-Expected output:
+Initial output with scaffolds still skipped:
 
 ```
 Running 6 tests using 1 worker
 
-  ✗ tests/api/profile.spec.ts:3:3 › should fetch user profile
-    Error: expect(received).toBe(expected)
-    Expected: 200
-    Received: 404
+  - tests/api/profile.spec.ts:3:3 › should fetch user profile
+  - tests/api/profile.spec.ts:15:3 › should update user profile
+  - tests/e2e/profile.spec.ts:10:3 › should edit and save profile
 
-  ✗ tests/e2e/profile.spec.ts:10:3 › should display current profile information
-    Error: page.goto: net::ERR_ABORTED
+  6 skipped
 ```
 
-**All tests should fail!** This confirms:
+After you remove `test.skip()` from the task you are implementing, that activated test should fail first. This confirms:
 
 - Feature doesn't exist yet
 - Tests will guide implementation
@@ -326,9 +324,9 @@ Running 6 tests using 1 worker
 Now implement the feature following the test guidance:
 
 1. Start with API tests (backend first)
-2. Make API tests pass
-3. Move to E2E tests (frontend)
-4. Make E2E tests pass
+2. Remove `test.skip()` from the first API test and confirm RED
+3. Implement until that test passes
+4. Move to the next API or E2E test and repeat
 5. Refactor with confidence (tests protect you)
 
 ### 8. Verify Tests Pass
@@ -362,16 +360,16 @@ Running 6 tests using 1 worker
   6 passed (9.8s)
 ```
 
-**Green!** You've completed the TDD cycle: red → green → refactor.
+**Green!** You've completed the active red → green → refactor cycle for the generated scaffolds.
 
 ## What You Get
 
-### Failing Tests
+### Red-Phase Test Scaffolds
 
 - API tests for backend endpoints
 - E2E tests for user workflows
 - Component tests (if requested)
-- All tests fail initially (red phase)
+- Generated with `test.skip()` until you activate them task-by-task
 
 ### Implementation Guidance
 
@@ -381,7 +379,7 @@ Running 6 tests using 1 worker
 
 ### TDD Workflow Support
 
-- Tests guide implementation
+- Activated tests guide implementation
 - Confidence to refactor
 - Living documentation of features
 

package/lib/bmad-cache/tea/docs/reference/commands.md

@@ -177,7 +177,7 @@ All workflows listed here are current and supported in TEA, including `nfr-asses
 
 ## atdd
 
-**Purpose:** Generate failing acceptance tests BEFORE implementation (TDD red phase)
+**Purpose:** Generate red-phase acceptance test scaffolds BEFORE implementation (TDD red phase)
 
 **Phase:** Phase 4 (Implementation)
 
@@ -189,9 +189,9 @@ All workflows listed here are current and supported in TEA, including `nfr-asses
 
 **Key Outputs:**
 
-- Failing tests (`tests/api/`, `tests/e2e/`)
-- Implementation checklist
-- All tests fail initially (red phase)
+- Red-phase test scaffolds (`tests/api/`, `tests/e2e/`) marked with `test.skip()`
+- Implementation checklist keyed to `story_key`
+- Story metadata / handoff paths for downstream `dev-story` consumption
 
 **Browser Automation (CLI/MCP):** Recording mode (for skeleton UI only - rare)
 

package/lib/bmad-cache/tea/docs/reference/configuration.md

@@ -581,7 +581,7 @@ output_folder: _bmad-output
 - `gate-decision-{gate_type}-{story_id}.md` (from `trace` Phase 2)
 - `nfr-assessment.md` (from `nfr-assess`)
 - `automation-summary.md` (from `automate`)
-- `atdd-checklist-{story_id}.md` (from `atdd`)
+- `atdd-checklist-{story_key}.md` (from `atdd`)
 
 ---
 

package/lib/bmad-cache/tea/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-method-test-architecture-enterprise",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-method-test-architecture-enterprise",
-      "version": "1.9.1",
+      "version": "1.10.0",
       "license": "MIT",
       "dependencies": {
         "@clack/prompts": "^0.11.0",

package/lib/bmad-cache/tea/package.json

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

package/lib/bmad-cache/tea/src/module-help.csv

@@ -4,7 +4,7 @@ Test Architecture Enterprise,bmad-teach-me-testing,Teach Me Testing,TMT,Teach te
 Test Architecture Enterprise,bmad-testarch-test-design,Test Design,TD,Risk-based test planning.,,3-solutioning,,bmad-testarch-framework,false,test_artifacts,test design document
 Test Architecture Enterprise,bmad-testarch-framework,Test Framework,TF,Initialize production-ready test framework.,,3-solutioning,bmad-testarch-test-design,bmad-testarch-ci,false,test_artifacts,framework scaffold
 Test Architecture Enterprise,bmad-testarch-ci,CI Setup,CI,Configure CI/CD quality pipeline.,,3-solutioning,bmad-testarch-framework,,false,test_artifacts,ci config
-Test Architecture Enterprise,bmad-testarch-atdd,ATDD,AT,Generate failing tests (TDD red phase).,,4-implementation,,,false,test_artifacts,atdd tests
+Test Architecture Enterprise,bmad-testarch-atdd,ATDD,AT,Generate red-phase acceptance test scaffolds before implementation.,,4-implementation,bmad-create-story:create,bmad-dev-story,false,test_artifacts,"atdd-checklist|red-phase acceptance tests"
 Test Architecture Enterprise,bmad-testarch-automate,Test Automation,TA,Expand test coverage.,,4-implementation,bmad-testarch-atdd,,false,test_artifacts,test suite
 Test Architecture Enterprise,bmad-testarch-test-review,Test Review,RV,Quality audit (0-100 scoring).,,4-implementation,bmad-testarch-automate,,false,test_artifacts,review report
 Test Architecture Enterprise,bmad-testarch-nfr,NFR Assessment,NR,Non-functional requirements assessment.,,4-implementation,bmad-testarch-automate,,false,test_artifacts,nfr report

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-atdd/SKILL.md

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