diff --git a/.gitignore b/.gitignore
index 8a9137a1..3c8f80c7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -31,7 +31,7 @@ Thumbs.db
# IDE and editor configs
.windsurf/
.trae/
-.bmad*/.cursor/
+_bmad*/.cursor/
# AI assistant files
CLAUDE.md
@@ -44,8 +44,8 @@ CLAUDE.local.md
.claude/settings.local.json
# Project-specific
-.bmad-core
-.bmad-creator-tools
+_bmad-core
+_bmad-creator-tools
test-project-install/*
sample-project/*
flattened-codebase.xml
@@ -65,7 +65,7 @@ src/modules/bmgd/sub-modules/
shared-modules
z*/
-.bmad
+_bmad
.claude
.codex
.github/chatmodes
diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
index 84d44c7d..f2b11377 100644
--- a/.markdownlint-cli2.yaml
+++ b/.markdownlint-cli2.yaml
@@ -5,8 +5,8 @@ ignores:
- node_modules/**
- test/fixtures/**
- CODE_OF_CONDUCT.md
- - .bmad/**
- - .bmad*/**
+ - _bmad/**
+ - _bmad*/**
- .agent/**
- .claude/**
- .roo/**
diff --git a/.prettierignore b/.prettierignore
index 0d37dfb9..8cbb07f7 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -5,5 +5,5 @@ test/fixtures/**
CODE_OF_CONDUCT.md
# BMAD runtime folders (user-specific, not in repo)
-.bmad/
-.bmad*/
+_bmad/
+_bmad*/
diff --git a/docs/agent-customization-guide.md b/docs/agent-customization-guide.md
index 755d4890..8d8616f6 100644
--- a/docs/agent-customization-guide.md
+++ b/docs/agent-customization-guide.md
@@ -9,7 +9,7 @@ Customize BMad agents without modifying core files. All customizations persist t
After installation, find agent customization files in:
```
-.bmad/_cfg/agents/
+_bmad/_cfg/agents/
├── core-bmad-master.customize.yaml
├── bmm-dev.customize.yaml
├── bmm-pm.customize.yaml
@@ -119,7 +119,7 @@ prompts:
**Example 1: Customize Developer Agent for TDD**
```yaml
-# .bmad/_cfg/agents/bmm-dev.customize.yaml
+# _bmad/_cfg/agents/bmm-dev.customize.yaml
agent:
metadata:
name: 'TDD Developer'
@@ -135,20 +135,20 @@ critical_actions:
**Example 2: Add Custom Deployment Workflow**
```yaml
-# .bmad/_cfg/agents/bmm-dev.customize.yaml
+# _bmad/_cfg/agents/bmm-dev.customize.yaml
menu:
- trigger: deploy-staging
- workflow: '{project-root}/.bmad/deploy-staging.yaml'
+ workflow: '{project-root}/_bmad/deploy-staging.yaml'
description: Deploy to staging environment
- trigger: deploy-prod
- workflow: '{project-root}/.bmad/deploy-prod.yaml'
+ workflow: '{project-root}/_bmad/deploy-prod.yaml'
description: Deploy to production (with approval)
```
**Example 3: Multilingual Product Manager**
```yaml
-# .bmad/_cfg/agents/bmm-pm.customize.yaml
+# _bmad/_cfg/agents/bmm-pm.customize.yaml
persona:
role: 'Bilingual Product Manager'
identity: 'Expert in US and LATAM markets'
@@ -174,7 +174,7 @@ memories:
**Module-Level (Recommended):**
-- Customize agents per-project in `.bmad/_cfg/agents/`
+- Customize agents per-project in `_bmad/_cfg/agents/`
- Different projects can have different agent behaviors
**Global Config (Coming Soon):**
diff --git a/docs/custom-content-installation.md b/docs/custom-content-installation.md
index 8dc4ad98..3ee4b0a7 100644
--- a/docs/custom-content-installation.md
+++ b/docs/custom-content-installation.md
@@ -135,7 +135,7 @@ The installer presents a unified selection interface:
## Agent Sidecar Support
-Agents with sidecar content can store personal data, memories, and working files outside of the `.bmad` directory. This separation keeps personal content separate from BMAD's core files.
+Agents with sidecar content can store personal data, memories, and working files outside of the `_bmad` directory. This separation keeps personal content separate from BMAD's core files.
### What is Sidecar Content?
@@ -152,7 +152,7 @@ The sidecar folder location is configured during BMAD core installation:
```
? Where should users' agent sidecar memory folders be stored?
-❯ .bmad-user-memory
+❯ _bmad-user-memory
```
### How It Works
@@ -175,7 +175,7 @@ my-agent/
### Git Integration
-Since sidecar content is stored outside the `.bmad` directory (and typically outside version control), users can:
+Since sidecar content is stored outside the `_bmad` directory (and typically outside version control), users can:
- Add the sidecar folder to `.gitignore` to exclude personal data
- Share agent definitions without exposing personal content
@@ -185,7 +185,7 @@ Example `.gitignore` entry:
```
# Exclude agent personal data
-.bmad-user-memory/
+_bmad-user-memory/
```
## Creating Custom Content with BMAD Builder
diff --git a/docs/ide-info/crush.md b/docs/ide-info/crush.md
index b101e804..3526a87a 100644
--- a/docs/ide-info/crush.md
+++ b/docs/ide-info/crush.md
@@ -7,7 +7,7 @@ BMAD agents are installed as commands in `.crush/commands/bmad/`.
### How to Use
1. **Open Command Palette**: Use Crush command interface
-2. **Navigate**: Browse to `.bmad/{module}/agents/`
+2. **Navigate**: Browse to `_bmad/{module}/agents/`
3. **Select Agent**: Choose the agent command
4. **Execute**: Run to activate agent persona
diff --git a/docs/ide-info/cursor.md b/docs/ide-info/cursor.md
index 9023b6d5..9b65f675 100644
--- a/docs/ide-info/cursor.md
+++ b/docs/ide-info/cursor.md
@@ -6,20 +6,20 @@ BMAD agents are installed in `.cursor/rules/bmad/` as MDC rules.
### How to Use
-1. **Reference in Chat**: Use `@.bmad/{module}/agents/{agent-name}`
-2. **Include Entire Module**: Use `@.bmad/{module}`
-3. **Reference Index**: Use `@.bmad/index` for all available agents
+1. **Reference in Chat**: Use `@_bmad/{module}/agents/{agent-name}`
+2. **Include Entire Module**: Use `@_bmad/{module}`
+3. **Reference Index**: Use `@_bmad/index` for all available agents
### Examples
```
-@.bmad/core/agents/dev - Activate dev agent
-@.bmad/bmm/agents/architect - Activate architect agent
-@.bmad/core - Include all core agents/tasks
+@_bmad/core/agents/dev - Activate dev agent
+@_bmad/bmm/agents/architect - Activate architect agent
+@_bmad/core - Include all core agents/tasks
```
### Notes
- Rules are Manual type - only loaded when explicitly referenced
- No automatic context pollution
-- Can combine multiple agents: `@.bmad/core/agents/dev @.bmad/core/agents/test`
+- Can combine multiple agents: `@_bmad/core/agents/dev @_bmad/core/agents/test`
diff --git a/docs/ide-info/iflow.md b/docs/ide-info/iflow.md
index 1a9db27a..52ad248d 100644
--- a/docs/ide-info/iflow.md
+++ b/docs/ide-info/iflow.md
@@ -7,7 +7,7 @@ BMAD agents are installed as commands in `.iflow/commands/bmad/`.
### How to Use
1. **Access Commands**: Use iFlow command interface
-2. **Navigate**: Browse to `.bmad/agents/` or `.bmad/tasks/`
+2. **Navigate**: Browse to `_bmad/agents/` or `_bmad/tasks/`
3. **Select**: Choose the agent or task command
4. **Execute**: Run to activate
@@ -22,8 +22,8 @@ BMAD agents are installed as commands in `.iflow/commands/bmad/`.
### Examples
```
-/.bmad/agents/core-dev - Activate dev agent
-/.bmad/tasks/core-setup - Execute setup task
+/_bmad/agents/core-dev - Activate dev agent
+/_bmad/tasks/core-setup - Execute setup task
```
### Notes
diff --git a/docs/ide-info/opencode.md b/docs/ide-info/opencode.md
index f4d72281..0612a15d 100644
--- a/docs/ide-info/opencode.md
+++ b/docs/ide-info/opencode.md
@@ -14,7 +14,7 @@ BMAD agents are installed as OpenCode agents in `.opencode/agent/BMAD/{module_na
```
/agents - to see a list of agents and switch between them
-/.bmad/bmm/workflows/workflow-init - Activate the workflow-init command
+/_bmad/bmm/workflows/workflow-init - Activate the workflow-init command
```
### Notes
diff --git a/docs/ide-info/rovo-dev.md b/docs/ide-info/rovo-dev.md
index a6445758..e4d2eb62 100644
--- a/docs/ide-info/rovo-dev.md
+++ b/docs/ide-info/rovo-dev.md
@@ -55,7 +55,7 @@ project-root/
│ ├── config.yml (Rovo Dev configuration)
│ ├── prompts.yml (Optional: reusable prompts)
│ └── ...
-├── .bmad/ (BMAD installation directory)
+├── _bmad/ (BMAD installation directory)
└── ...
```
diff --git a/docs/installers-bundlers/ide-injections.md b/docs/installers-bundlers/ide-injections.md
index ca8199aa..fd303ecf 100644
--- a/docs/installers-bundlers/ide-injections.md
+++ b/docs/installers-bundlers/ide-injections.md
@@ -158,7 +158,7 @@ src/modules/bmm/
```yaml
injections:
- - file: '.bmad/bmm/agents/pm.md'
+ - file: '_bmad/bmm/agents/pm.md'
point: 'pm-agent-instructions'
requires: 'any' # Injected if ANY subagent is selected
content: |
@@ -166,7 +166,7 @@ injections:
Use 'market-researcher' subagent for analysis
- - file: '.bmad/bmm/templates/prd.md'
+ - file: '_bmad/bmm/templates/prd.md'
point: 'prd-goals-context-delegation'
requires: 'market-researcher' # Only if this specific subagent selected
content: |
diff --git a/docs/installers-bundlers/installers-modules-platforms-reference.md b/docs/installers-bundlers/installers-modules-platforms-reference.md
index a687071a..efee049b 100644
--- a/docs/installers-bundlers/installers-modules-platforms-reference.md
+++ b/docs/installers-bundlers/installers-modules-platforms-reference.md
@@ -19,7 +19,7 @@ BMad Core is a modular AI agent framework with intelligent installation, platfor
- **Modular Design**: Core + optional modules (BMB, BMM, CIS)
- **Smart Installation**: Interactive configuration with dependency resolution
-- **Clean Architecture**: Centralized `.bmad` directory add to project, no source pollution with multiple folders added
+- **Clean Architecture**: Centralized `_bmad` directory add to project, no source pollution with multiple folders added
## Architecture
@@ -27,7 +27,7 @@ BMad Core is a modular AI agent framework with intelligent installation, platfor
```
project-root/
-├── .bmad/ # Centralized installation
+├── _bmad/ # Centralized installation
│ ├── _cfg/ # Configuration
│ │ ├── agents/ # Agent configs
│ │ └── agent-manifest.csv # Agent manifest
@@ -185,7 +185,7 @@ Cline, Roo, Rovo Dev,Auggie, GitHub Copilot, Codex, Gemini, Qwen, Trae, Kilo, Cr
```yaml
injections:
- - file: '.bmad/bmm/agents/pm.md'
+ - file: '_bmad/bmm/agents/pm.md'
point: 'pm-agent-instructions'
content: |
Platform-specific instruction
@@ -273,9 +273,9 @@ Generated in: `bmad/_cfg/agents/{module}-{agent}.md`
| Issue | Solution |
| ----------------------- | ------------------------------------ |
-| Existing installation | Use `bmad update` or remove `.bmad/` |
+| Existing installation | Use `bmad update` or remove `_bmad/` |
| Module not found | Check `src/modules/` exists |
-| Config not applied | Verify `.bmad/{module}/config.yaml` |
+| Config not applied | Verify `_bmad/{module}/config.yaml` |
| Missing config.yaml | Fixed: All modules now get configs |
| Agent unavailable | Check for `localskip="true"` |
| module-installer copied | Fixed: Now excluded from copy |
@@ -290,7 +290,7 @@ bmad status -v # Detailed status
### Best Practices
1. Run from project root
-2. Backup `.bmad/_cfg/` before updates
+2. Backup `_bmad/_cfg/` before updates
3. Use interactive mode for guidance
4. Review generated configs post-install
@@ -298,7 +298,7 @@ bmad status -v # Detailed status
| v4 | v6 |
| ------------------- | -------------------- |
-| Scattered files | Centralized `.bmad/` |
+| Scattered files | Centralized `_bmad/` |
| Monolithic | Modular |
| Manual config | Interactive setup |
| Limited IDE support | 15+ platforms |
@@ -327,8 +327,8 @@ Agents can specify both `workflow` (source location) and `workflow-install` (des
```yaml
menu:
- trigger: create-story
- workflow: '{project-root}/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml'
- workflow-install: '{project-root}/.bmad/bmgd/workflows/4-production/create-story/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml'
+ workflow-install: '{project-root}/_bmad/bmgd/workflows/4-production/create-story/workflow.yaml'
description: 'Create a game feature story'
```
@@ -348,10 +348,10 @@ menu:
```yaml
# Source workflow (in bmm):
- config_source: "{project-root}/.bmad/bmm/config.yaml"
+ config_source: "{project-root}/_bmad/bmm/config.yaml"
# Vendored workflow (in bmgd):
- config_source: "{project-root}/.bmad/bmgd/config.yaml"
+ config_source: "{project-root}/_bmad/bmgd/config.yaml"
```
**Result**: Modules become completely standalone with their own copies of needed workflows, configured for their specific use case.
diff --git a/docs/v4-to-v6-upgrade.md b/docs/v4-to-v6-upgrade.md
index dffee509..dbc6f35d 100644
--- a/docs/v4-to-v6-upgrade.md
+++ b/docs/v4-to-v6-upgrade.md
@@ -10,14 +10,14 @@ BMad v6 represents a complete ground-up rewrite with significant architectural c
When you run `npm run install:bmad` on a project with v4 installed, the installer automatically detects:
-- **Legacy folders**: Any folders starting with `.bmad`, `bmad` (lowercase), or `Bmad`
+- **Legacy folders**: Any folders starting with `_bmad`, `bmad` (lowercase), or `Bmad`
- **IDE command artifacts**: Legacy bmad folders in IDE configuration directories (`.claude/commands/`, `.cursor/commands/`, etc.)
### What Happens During Detection
-1. **Automatic Backup of v4 Modules**: All `.bmad-*` folders are moved to `v4-backup/` in your project root
+1. **Automatic Backup of v4 Modules**: All `_bmad-*` folders are moved to `v4-backup/` in your project root
- If a backup already exists, a timestamp is added to avoid conflicts
- - Example: `.bmad-core` → `v4-backup/.bmad-core`
+ - Example: `_bmad-core` → `v4-backup/_bmad-core`
- Your project files and data are NOT affected
2. **IDE Command Cleanup Recommended**: Legacy v4 IDE commands should be manually removed
@@ -34,12 +34,12 @@ When you run `npm run install:bmad` on a project with v4 installed, the installe
| v4 Module | v6 Status |
| ----------------------------- | ------------------------------------------------ |
-| `.bmad-2d-phaser-game-dev` | Integrated into BMM |
-| `.bmad-2d-unity-game-dev` | Integrated into BMM |
-| `.bmad-godot-game-dev` | Integrated into BMM |
-| `.bmad-*-game-dev` (any) | Integrated into BMM |
-| `.bmad-infrastructure-devops` | Deprecated - New core devops agent coming in BMM |
-| `.bmad-creative-writing` | Not adapted - New module releasing soon |
+| `_bmad-2d-phaser-game-dev` | Integrated into BMM |
+| `_bmad-2d-unity-game-dev` | Integrated into BMM |
+| `_bmad-godot-game-dev` | Integrated into BMM |
+| `_bmad-*-game-dev` (any) | Integrated into BMM |
+| `_bmad-infrastructure-devops` | Deprecated - New core devops agent coming in BMM |
+| `_bmad-creative-writing` | Not adapted - New module releasing soon |
**Game Development**: All game development functionality has been consolidated and expanded within the BMM (BMad Method) module. Game-specific workflows now adapt to your game type and engine.
@@ -53,17 +53,17 @@ When you run `npm run install:bmad` on a project with v4 installed, the installe
```
your-project/
-├── .bmad-core/ # Was actually the BMad Method
-├── .bmad-game-dev/ # Separate expansion packs
-├── .bmad-creative-writing/
-└── .bmad-infrastructure-devops/
+├── _bmad-core/ # Was actually the BMad Method
+├── _bmad-game-dev/ # Separate expansion packs
+├── _bmad-creative-writing/
+└── _bmad-infrastructure-devops/
```
**v6 Unified Structure:**
```
your-project/
-└── .bmad/ # Single installation folder, default .bmad
+└── _bmad/ # Single installation folder, default _bmad
├── core/ # Real core framework (applies to all modules)
├── bmm/ # BMad Method (software/game dev)
├── bmb/ # BMad Builder (create agents/workflows)
@@ -74,9 +74,9 @@ your-project/
### Key Concept Changes
-- **v4 `.bmad-core`**: Was actually the BMad Method
-- **v6 `.bmad/core/`**: Is the real universal core framework
-- **v6 `.bmad/bmm/`**: Is the BMad Method module
+- **v4 `_bmad-core`**: Was actually the BMad Method
+- **v6 `_bmad/core/`**: Is the real universal core framework
+- **v6 `_bmad/bmm/`**: Is the BMad Method module
- **Module identification**: All modules now have a `config.yaml` file
---
@@ -110,15 +110,15 @@ After running the v6 installer:
### v4 Agent Customization
-In v4, you may have modified agent files directly in `.bmad-*` folders.
+In v4, you may have modified agent files directly in `_bmad-*` folders.
### v6 Agent Customization
-**All customizations** now go in `.bmad/_cfg/agents/` using customize files:
+**All customizations** now go in `_bmad/_cfg/agents/` using customize files:
**Example: Renaming an agent and changing communication style**
-File: `.bmad/_cfg/agents/bmm-pm.customize.yaml`
+File: `_bmad/_cfg/agents/bmm-pm.customize.yaml`
```yaml
# Customize the PM agent
@@ -133,8 +133,8 @@ persona:
**How it works:**
-- Base agent: `.bmad/bmm/agents/pm.md`
-- Customization: `.bmad/_cfg/agents/bmm-pm.customize.yaml`
+- Base agent: `_bmad/bmm/agents/pm.md`
+- Customization: `_bmad/_cfg/agents/bmm-pm.customize.yaml`
- Result: Agent uses your custom name and style, but updates don't overwrite your changes
---
@@ -176,7 +176,7 @@ npx bmad-method install
The installer will:
-1. Detect v4 installation and offer to backup `.bmad-*` folders
+1. Detect v4 installation and offer to backup `_bmad-*` folders
2. Prompt for recommended cleanup (you can skip)
3. Let you select modules (recommend: BMM for software and or game development)
4. Configure core settings (name, language, etc.)
@@ -212,9 +212,9 @@ Since you are migrating an existing project from v4, it's most likely **Level 3
## Post-Migration Checklist
- [ ] v4 folders backed up to `v4-backup/`
-- [ ] v6 installed to `.bmad/` folder
+- [ ] v6 installed to `_bmad/` folder
- [ ] `workflow-init` run with correct project level selected
-- [ ] Agent customizations migrated to `.bmad/_cfg/agents/` if needed
+- [ ] Agent customizations migrated to `_bmad/_cfg/agents/` if needed
- [ ] IDE integration working (test by listing agents)
- [ ] For active development: `sprint-planning` workflow executed
@@ -224,4 +224,4 @@ Since you are migrating an existing project from v4, it's most likely **Level 3
- **Discord**: [Join the BMad Community](https://discord.gg/gk8jAdXWmj)
- **Issues**: [GitHub Issue Tracker](https://github.com/bmad-code-org/BMAD-METHOD/issues)
-- **Docs**: Check `.bmad/docs/` in your installation for IDE-specific instructions
+- **Docs**: Check `_bmad/docs/` in your installation for IDE-specific instructions
diff --git a/docs/web-bundles-gemini-gpt-guide.md b/docs/web-bundles-gemini-gpt-guide.md
index 742721c6..3b2b00cd 100644
--- a/docs/web-bundles-gemini-gpt-guide.md
+++ b/docs/web-bundles-gemini-gpt-guide.md
@@ -336,7 +336,7 @@ Agents adapt their menus based on project phase and available workflows.
Customize agents using the [Agent Customization Guide](./agent-customization-guide.md):
-1. Edit `.bmad/_cfg/agents/.customize.yaml`
+1. Edit `_bmad/_cfg/agents/.customize.yaml`
2. Rebuild: `npx bmad-method build `
3. Generate bundles: `npm run bundle`
diff --git a/eslint.config.mjs b/eslint.config.mjs
index 6f1a25cd..a62fa2a6 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -16,8 +16,8 @@ export default [
'test/template-test-generator/**/*.md',
'test/fixtures/**',
'test/fixtures/**/*.yaml',
- '.bmad/**',
- '.bmad*/**',
+ '_bmad/**',
+ '_bmad*/**',
// Gitignored patterns
'z*/**', // z-samples, z1, z2, etc.
'.claude/**',
diff --git a/src/core/agents/bmad-master.agent.yaml b/src/core/agents/bmad-master.agent.yaml
index 448311bc..46cd4f1e 100644
--- a/src/core/agents/bmad-master.agent.yaml
+++ b/src/core/agents/bmad-master.agent.yaml
@@ -3,7 +3,7 @@
agent:
metadata:
- id: ".bmad/core/agents/bmad-master.md"
+ id: "_bmad/core/agents/bmad-master.md"
name: "BMad Master"
title: "BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator"
icon: "🧙"
@@ -17,22 +17,22 @@ agent:
# Agent-specific critical actions
critical_actions:
- - "Load into memory {project-root}/.bmad/core/config.yaml and set variable project_name, output_folder, user_name, communication_language"
+ - "Load into memory {project-root}/_bmad/core/config.yaml and set variable project_name, output_folder, user_name, communication_language"
- "Remember the users name is {user_name}"
- "ALWAYS communicate in {communication_language}"
# Agent menu items
menu:
- trigger: "list-tasks"
- action: "list all tasks from {project-root}/.bmad/_cfg/task-manifest.csv"
+ action: "list all tasks from {project-root}/_bmad/_cfg/task-manifest.csv"
description: "List Available Tasks"
- trigger: "list-workflows"
- action: "list all workflows from {project-root}/.bmad/_cfg/workflow-manifest.csv"
+ action: "list all workflows from {project-root}/_bmad/_cfg/workflow-manifest.csv"
description: "List Workflows"
- trigger: "party-mode"
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: "Group chat with all agents"
# Empty prompts section (no custom prompts for this agent)
diff --git a/src/core/agents/bmad-web-orchestrator.agent.xml b/src/core/agents/bmad-web-orchestrator.agent.xml
deleted file mode 100644
index cc2f60e7..00000000
--- a/src/core/agents/bmad-web-orchestrator.agent.xml
+++ /dev/null
@@ -1,113 +0,0 @@
-
-
- Load this complete web bundle XML - you are the BMad Orchestrator, first agent in this bundle
- CRITICAL: This bundle contains ALL agents as XML nodes with id=".bmad/..." and ALL workflows/tasks as nodes findable
- by type
- and id
- Greet user as BMad Orchestrator and display numbered list of ALL menu items from menu section below
- STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text
- On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to
- clarify | No match → show "Not recognized"
- When executing a menu item: Check menu-handlers section below for UNIVERSAL handler instructions that apply to ALL agents
-
-
- workflow, exec, tmpl, data, action, validate-workflow
-
-
- When menu item has: workflow="workflow-id"
- 1. Find workflow node by id in this bundle (e.g., <workflow id="workflow-id">)
- 2. CRITICAL: Always LOAD .bmad/core/tasks/workflow.xml if referenced
- 3. Execute the workflow content precisely following all steps
- 4. Save outputs after completing EACH workflow step (never batch)
- 5. If workflow id is "todo", inform user it hasn't been implemented yet
-
-
-
- When menu item has: exec="node-id" or exec="inline-instruction"
- 1. If value looks like a path/id → Find and execute node with that id
- 2. If value is text → Execute as direct instruction
- 3. Follow ALL instructions within loaded content EXACTLY
-
-
-
- When menu item has: tmpl="template-id"
- 1. Find template node by id in this bundle and pass it to the exec, task, action, or workflow being executed
-
-
-
- When menu item has: data="data-id"
- 1. Find data node by id in this bundle
- 2. Parse according to node type (json/yaml/xml/csv)
- 3. Make available as {data} variable for subsequent operations
-
-
-
- When menu item has: action="#prompt-id" or action="inline-text"
- 1. If starts with # → Find prompt with matching id in current agent
- 2. Otherwise → Execute the text directly as instruction
-
-
-
- When menu item has: validate-workflow="workflow-id"
- 1. MUST LOAD .bmad/core/tasks/validate-workflow.xml
- 2. Execute all validation instructions from that file
- 3. Check workflow's validation property for schema
- 4. Identify file to validate or ask user to specify
-
-
-
-
-
-
- When user selects *agents [agent-name]:
- 1. Find agent XML node with matching name/id in this bundle
- 2. Announce transformation: "Transforming into [agent name]... 🎭"
- 3. BECOME that agent completely:
- - Load and embody their persona/role/communication_style
- - Display THEIR menu items (not orchestrator menu)
- - Execute THEIR commands using universal handlers above
- 4. Stay as that agent until user types *exit
- 5. On *exit: Confirm, then return to BMad Orchestrator persona
-
-
-
- When user selects *list-agents:
- 1. Scan all agent nodes in this bundle
- 2. Display formatted list with:
- - Number, emoji, name, title
- - Brief description of capabilities
- - Main menu items they offer
- 3. Suggest which agent might help with common tasks
-
-
-
-
- Web bundle environment - NO file system access, all content in XML nodes
- Find resources by XML node id/type within THIS bundle only
- Use canvas for document drafting when available
- Menu triggers use asterisk (*) - display exactly as shown
- Number all lists, use letters for sub-options
- Stay in character (current agent) until *exit command
- Options presented as numbered lists with descriptions
- elicit="true" attributes require user confirmation before proceeding
-
-
-
-
- Master Orchestrator and BMad Scholar
- Master orchestrator with deep expertise across all loaded agents and workflows. Technical brilliance balanced with
- approachable communication.
- Knowledgeable, guiding, approachable, very explanatory when in BMad Orchestrator mode
- When I transform into another agent, I AM that agent until *exit command received. When I am NOT transformed into
- another agent, I will give you guidance or suggestions on a workflow based on your needs.
-
-
-
\ No newline at end of file
diff --git a/src/core/module.yaml b/src/core/module.yaml
index af89aaa0..cab95616 100644
--- a/src/core/module.yaml
+++ b/src/core/module.yaml
@@ -23,5 +23,5 @@ output_folder:
agent_sidecar_folder:
prompt: "Where should users agent sidecar memory folders be stored?"
- default: ".bmad-user-memory"
+ default: "_bmad-user-memory"
result: "{project-root}/{value}"
diff --git a/src/core/resources/excalidraw/README.md b/src/core/resources/excalidraw/README.md
index ef7bca29..21fe4eb6 100644
--- a/src/core/resources/excalidraw/README.md
+++ b/src/core/resources/excalidraw/README.md
@@ -72,8 +72,8 @@ Provides the **HOW** (universal knowledge) while agents provide the **WHAT** (do
```yaml
# workflows/diagrams/create-flowchart/workflow.yaml
-helpers: '{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md'
-json_validation: '{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md'
+helpers: '{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md'
+json_validation: '{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md'
```
**Domain-specific additions:**
@@ -99,8 +99,8 @@ flowchart:
```yaml
# workflows/create-visual-metaphor/workflow.yaml
-helpers: '{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md'
-json_validation: '{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md'
+helpers: '{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md'
+json_validation: '{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md'
```
**Domain-specific additions:**
diff --git a/src/core/tasks/advanced-elicitation.xml b/src/core/tasks/advanced-elicitation.xml
index df80a0a4..598a96c9 100644
--- a/src/core/tasks/advanced-elicitation.xml
+++ b/src/core/tasks/advanced-elicitation.xml
@@ -1,6 +1,6 @@
-
+
MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER
DO NOT skip steps or change the sequence
diff --git a/src/core/tasks/index-docs.xml b/src/core/tasks/index-docs.xml
index 5491be2e..ff9a7de0 100644
--- a/src/core/tasks/index-docs.xml
+++ b/src/core/tasks/index-docs.xml
@@ -1,4 +1,4 @@
-
MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER
diff --git a/src/core/tasks/validate-workflow.xml b/src/core/tasks/validate-workflow.xml
index 4110c7e1..663622a4 100644
--- a/src/core/tasks/validate-workflow.xml
+++ b/src/core/tasks/validate-workflow.xml
@@ -1,4 +1,4 @@
-
+
Run a checklist against a document with thorough analysis and produce a validation report
diff --git a/src/core/tasks/workflow.xml b/src/core/tasks/workflow.xml
index 402678fc..c04421f2 100644
--- a/src/core/tasks/workflow.xml
+++ b/src/core/tasks/workflow.xml
@@ -1,4 +1,4 @@
-
+
Execute given workflow by loading its configuration, following instructions, and producing output
@@ -74,14 +74,14 @@
Display generated content
[a] Advanced Elicitation, [c] Continue, [p] Party-Mode, [y] YOLO the rest of this document only. WAIT for response.
- Start the advanced elicitation workflow {project-root}/.bmad/core/tasks/advanced-elicitation.xml
+ Start the advanced elicitation workflow {project-root}/_bmad/core/tasks/advanced-elicitation.xml
Continue to next step
- Start the party-mode workflow {project-root}/.bmad/core/workflows/party-mode/workflow.yaml
+ Start the party-mode workflow {project-root}/_bmad/core/workflows/party-mode/workflow.yaml
@@ -225,7 +225,7 @@
• This is the complete workflow execution engine
• You MUST Follow instructions exactly as written
- • The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+ • The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
• You MUST have already loaded and processed: {installed_path}/workflow.yaml
• This workflow uses INTENT-DRIVEN PLANNING - adapt organically to product type and context
• YOU ARE FACILITATING A CONVERSATION With a user to produce a final document step by step. The whole process is meant to be
diff --git a/src/core/tools/shard-doc.xml b/src/core/tools/shard-doc.xml
index baa71568..551c8965 100644
--- a/src/core/tools/shard-doc.xml
+++ b/src/core/tools/shard-doc.xml
@@ -1,4 +1,4 @@
-
Split large markdown documents into smaller, organized files based on level 2 sections using @kayvan/markdown-tree-parser tool
@@ -64,12 +64,12 @@
What would you like to do with the original document `[source-document-name]`?
-Options:
-[d] Delete - Remove the original (recommended - shards can always be recombined)
-[m] Move to archive - Move original to a backup/archive location
-[k] Keep - Leave original in place (NOT recommended - defeats sharding purpose)
+ Options:
+ [d] Delete - Remove the original (recommended - shards can always be recombined)
+ [m] Move to archive - Move original to a backup/archive location
+ [k] Keep - Leave original in place (NOT recommended - defeats sharding purpose)
-Your choice (d/m/k):
+ Your choice (d/m/k):
Delete the original source document file
@@ -92,12 +92,12 @@ Your choice (d/m/k):
Display warning to user:
+ Consider deleting or archiving the original document.
Confirm user choice: "Original document kept at: [source-document-path]"
@@ -106,4 +106,4 @@ Consider deleting or archiving the original document.
HALT if npx command fails or produces no output files
-
+
\ No newline at end of file
diff --git a/src/core/workflows/brainstorming/workflow.md b/src/core/workflows/brainstorming/workflow.md
index 7ada81a5..47c8aaff 100644
--- a/src/core/workflows/brainstorming/workflow.md
+++ b/src/core/workflows/brainstorming/workflow.md
@@ -28,7 +28,7 @@ This uses **micro-file architecture** for disciplined execution:
### Configuration Loading
-Load config from `{project-root}/.bmad/core/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
@@ -36,7 +36,7 @@ Load config from `{project-root}/.bmad/core/config.yaml` and resolve:
### Paths
-- `installed_path` = `{project-root}/.bmad/core/workflows/brainstorming`
+- `installed_path` = `{project-root}/_bmad/core/workflows/brainstorming`
- `template_path` = `{installed_path}/template.md`
- `brain_techniques_path` = `{installed_path}/brain-methods.csv`
- `default_output_file` = `{output_folder}/analysis/brainstorming-session-{{date}}.md`
diff --git a/src/core/workflows/party-mode/steps/step-01-agent-loading.md b/src/core/workflows/party-mode/steps/step-01-agent-loading.md
index 25d0707f..569d6bd1 100644
--- a/src/core/workflows/party-mode/steps/step-01-agent-loading.md
+++ b/src/core/workflows/party-mode/steps/step-01-agent-loading.md
@@ -18,7 +18,7 @@
## CONTEXT BOUNDARIES:
-- Agent manifest CSV is available at `{project-root}/.bmad/_cfg/agent-manifest.csv`
+- Agent manifest CSV is available at `{project-root}/_bmad/_cfg/agent-manifest.csv`
- User configuration from config.yaml is loaded and resolved
- Party mode is standalone interactive workflow
- All agent data is available for conversation orchestration
@@ -37,7 +37,7 @@ Begin agent loading process:
**Agent Manifest Loading:**"
-Load and parse the agent manifest CSV from `{project-root}/.bmad/_cfg/agent-manifest.csv`
+Load and parse the agent manifest CSV from `{project-root}/_bmad/_cfg/agent-manifest.csv`
### 2. Extract Agent Data
diff --git a/src/core/workflows/party-mode/workflow.md b/src/core/workflows/party-mode/workflow.md
index 6889dfc5..fb15f567 100644
--- a/src/core/workflows/party-mode/workflow.md
+++ b/src/core/workflows/party-mode/workflow.md
@@ -27,17 +27,17 @@ This uses **micro-file architecture** with **sequential conversation orchestrati
### Configuration Loading
-Load config from `{project-root}/.bmad/core/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
- `date` as a system-generated value
-- Agent manifest path: `{project-root}/.bmad/_cfg/agent-manifest.csv`
+- Agent manifest path: `{project-root}/_bmad/_cfg/agent-manifest.csv`
### Paths
-- `installed_path` = `{project-root}/.bmad/core/workflows/party-mode`
-- `agent_manifest_path` = `{project-root}/.bmad/_cfg/agent-manifest.csv`
+- `installed_path` = `{project-root}/_bmad/core/workflows/party-mode`
+- `agent_manifest_path` = `{project-root}/_bmad/_cfg/agent-manifest.csv`
- `standalone_mode` = `true` (party mode is an interactive workflow)
---
diff --git a/src/modules/bmb/README.md b/src/modules/bmb/README.md
index daca8c29..d5efa546 100644
--- a/src/modules/bmb/README.md
+++ b/src/modules/bmb/README.md
@@ -18,7 +18,7 @@ Specialized tools and workflows for creating, customizing, and extending BMad co
**BMad Builder** - Master builder agent orchestrating all creation workflows with deep knowledge of BMad architecture and conventions.
-- Location: `.bmad/bmb/agents/bmad-builder.md`
+- Location: `_bmad/bmb/agents/bmad-builder.md`
### 📋 Workflows
diff --git a/src/modules/bmb/agents/bmad-builder.agent.yaml b/src/modules/bmb/agents/bmad-builder.agent.yaml
index 66e3325f..52189df1 100644
--- a/src/modules/bmb/agents/bmad-builder.agent.yaml
+++ b/src/modules/bmb/agents/bmad-builder.agent.yaml
@@ -4,7 +4,7 @@
agent:
webskip: true
metadata:
- id: ".bmad/bmb/agents/bmad-builder.md"
+ id: "_bmad/bmb/agents/bmad-builder.md"
name: BMad Builder
title: BMad Builder
icon: 🧙
@@ -24,26 +24,26 @@ agent:
discussion: true
conversational_knowledge:
- - agents: "{project-root}/.bmad/bmb/docs/agents/kb.csv"
- - workflows: "{project-root}/.bmad/bmb/docs/workflows/kb.csv"
- - modules: "{project-root}/.bmad/bmb/docs/modules/kb.csv"
+ - agents: "{project-root}/_bmad/bmb/docs/agents/kb.csv"
+ - workflows: "{project-root}/_bmad/bmb/docs/workflows/kb.csv"
+ - modules: "{project-root}/_bmad/bmb/docs/modules/kb.csv"
menu:
- multi: "[CA] Create, [EA] Edit, or [VA] Validate with Compliance CheckBMAD agents with best practices"
triggers:
- create-agent:
- input: CA or fuzzy match create agent
- - route: "{project-root}/.bmad/bmb/workflows/create-agent/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/create-agent/workflow.md"
- data: null
- type: exec
- edit-agent:
- input: EA or fuzzy match edit agent
- - route: "{project-root}/.bmad/bmb/workflows/edit-agent/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/edit-agent/workflow.md"
- data: null
- type: exec
- run-agent-compliance-check:
- input: VA or fuzzy match validate agent
- - route: "{project-root}/.bmad/bmb/workflows/agent-compliance-check/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/agent-compliance-check/workflow.md"
- data: null
- type: exec
@@ -51,17 +51,17 @@ agent:
triggers:
- create-workflow:
- input: CW or fuzzy match create workflow
- - route: "{project-root}/.bmad/bmb/workflows/create-workflow/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/create-workflow/workflow.md"
- data: null
- type: exec
- edit-workflow:
- input: EW or fuzzy match edit workflow
- - route: "{project-root}/.bmad/bmb/workflows/edit-workflow/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/edit-workflow/workflow.md"
- data: null
- type: exec
- run-workflow-compliance-check:
- input: VW or fuzzy match validate workflow
- - route: "{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/workflow-compliance-check/workflow.md"
- data: null
- type: exec
@@ -69,26 +69,26 @@ agent:
triggers:
- brainstorm-module:
- input: BM or fuzzy match brainstorm module
- - route: "{project-root}/.bmad/bmb/workflows/brainstorm-module/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/brainstorm-module/workflow.md"
- data: null
- type: exec
- product-brief-module:
- input: PBM or fuzzy match product brief module
- - route: "{project-root}/.bmad/bmb/workflows/product-brief-module/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/product-brief-module/workflow.md"
- data: null
- type: exec
- create-module:
- input: CM or fuzzy match create module
- - route: "{project-root}/.bmad/bmb/workflows/create-module/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/create-module/workflow.md"
- data: null
- type: exec
- edit-module:
- input: EM or fuzzy match edit module
- - route: "{project-root}/.bmad/bmb/workflows/edit-module/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/edit-module/workflow.md"
- data: null
- type: exec
- run-module-compliance-check:
- input: VM or fuzzy match validate module
- - route: "{project-root}/.bmad/bmb/workflows/module-compliance-check/workflow.md"
+ - route: "{project-root}/_bmad/bmb/workflows/module-compliance-check/workflow.md"
- data: null
- type: exec
diff --git a/src/modules/bmb/docs/agents/agent-compilation.md b/src/modules/bmb/docs/agents/agent-compilation.md
index 691044b1..32af63fd 100644
--- a/src/modules/bmb/docs/agents/agent-compilation.md
+++ b/src/modules/bmb/docs/agents/agent-compilation.md
@@ -35,7 +35,7 @@ rex.agent.yaml ← Persona name (users might rename to "Max")
**Pattern:**
- Filename: `{role-or-function}.agent.yaml` (kebab-case)
-- Metadata ID: `.bmad/{module}/agents/{role-or-function}.md`
+- Metadata ID: `_bmad/{module}/agents/{role-or-function}.md`
- Persona Name: User-customizable in metadata or customize.yaml
**Example:**
@@ -44,7 +44,7 @@ rex.agent.yaml ← Persona name (users might rename to "Max")
# File: presentation-master.agent.yaml
agent:
metadata:
- id: '.bmad/cis/agents/presentation-master.md'
+ id: '_bmad/cis/agents/presentation-master.md'
name: Caravaggio # ← Users can change this to "Pablo" or "Vince"
title: Visual Communication & Presentation Expert
```
@@ -83,7 +83,7 @@ You must fully embody this agent's persona...
Input resolution rules
-
+
diff --git a/src/modules/bmb/docs/agents/agent-menu-patterns.md b/src/modules/bmb/docs/agents/agent-menu-patterns.md
index 0af8eac5..85ee67ca 100644
--- a/src/modules/bmb/docs/agents/agent-menu-patterns.md
+++ b/src/modules/bmb/docs/agents/agent-menu-patterns.md
@@ -65,11 +65,11 @@ For module agents orchestrating multi-step processes.
```yaml
menu:
- trigger: create-prd
- workflow: '{project-root}/.bmad/bmm/workflows/prd/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/prd/workflow.yaml'
description: 'Create Product Requirements Document'
- trigger: brainstorm
- workflow: '{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml'
+ workflow: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
description: 'Guided brainstorming session'
# Placeholder for unimplemented workflows
@@ -92,11 +92,11 @@ For executing tasks directly.
```yaml
menu:
- trigger: validate
- exec: '{project-root}/.bmad/core/tasks/validate-workflow.xml'
+ exec: '{project-root}/_bmad/core/tasks/validate-workflow.xml'
description: 'Validate document structure'
- trigger: advanced-elicitation
- exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+ exec: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
description: 'Advanced elicitation techniques'
```
@@ -113,8 +113,8 @@ For document generation with templates.
```yaml
menu:
- trigger: create-brief
- exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
- tmpl: '{project-root}/.bmad/bmm/templates/brief.md'
+ exec: '{project-root}/_bmad/core/tasks/create-doc.xml'
+ tmpl: '{project-root}/_bmad/bmm/templates/brief.md'
description: 'Create a Product Brief'
```
@@ -131,8 +131,8 @@ Universal attribute for supplementary information.
```yaml
menu:
- trigger: team-standup
- exec: '{project-root}/.bmad/bmm/tasks/standup.xml'
- data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
+ exec: '{project-root}/_bmad/bmm/tasks/standup.xml'
+ data: '{project-root}/_bmad/_cfg/agent-manifest.csv'
description: 'Run team standup'
- trigger: analyze-metrics
@@ -154,12 +154,12 @@ Control visibility based on deployment target:
```yaml
menu:
- trigger: git-flow
- exec: '{project-root}/.bmad/bmm/tasks/git-flow.xml'
+ exec: '{project-root}/_bmad/bmm/tasks/git-flow.xml'
description: 'Git workflow operations'
ide-only: true # Only in IDE environments
- trigger: advanced-elicitation
- exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+ exec: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
description: 'Advanced elicitation'
web-only: true # Only in web bundles
```
@@ -251,20 +251,20 @@ menu:
menu:
# Analysis Phase
- trigger: brainstorm
- workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
description: 'Brainstorm ideas'
- trigger: research
- workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/research/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.yaml'
description: 'Conduct research'
# Planning Phase
- trigger: prd
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/prd/workflow.yaml'
description: 'Create PRD'
- trigger: architecture
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
description: 'Design architecture'
```
@@ -362,19 +362,19 @@ prompts:
```yaml
# GOOD - Portable paths
-workflow: "{project-root}/.bmad/bmm/workflows/prd/workflow.yaml"
-exec: "{project-root}/.bmad/core/tasks/validate.xml"
+workflow: "{project-root}/_bmad/bmm/workflows/prd/workflow.yaml"
+exec: "{project-root}/_bmad/core/tasks/validate.xml"
data: "{project-root}/_data/metrics.csv"
# BAD - Hardcoded paths
-workflow: "/Users/john/project/.bmad/bmm/workflows/prd/workflow.yaml"
+workflow: "/Users/john/project/_bmad/bmm/workflows/prd/workflow.yaml"
exec: "../../../core/tasks/validate.xml"
```
### Available Variables
- `{project-root}` - Project root directory
-- `.bmad` - BMAD installation folder
+- `_bmad` - BMAD installation folder
- `{agent_sidecar_folder}` - Agent installation directory (Expert agents)
- `{output_folder}` - Document output location
- `{user_name}` - User's name from config
@@ -444,23 +444,23 @@ menu:
```yaml
menu:
- trigger: workflow-init
- workflow: '{project-root}/.bmad/bmm/workflows/workflow-status/init/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/workflow-status/init/workflow.yaml'
description: 'Initialize workflow path (START HERE)'
- trigger: brainstorm
- workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
description: 'Guided brainstorming'
- trigger: prd
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/prd/workflow.yaml'
description: 'Create PRD'
- trigger: architecture
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
description: 'Design architecture'
- trigger: party-mode
- workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
+ workflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.yaml'
description: 'Multi-agent discussion'
```
diff --git a/src/modules/bmb/docs/agents/expert-agent-architecture.md b/src/modules/bmb/docs/agents/expert-agent-architecture.md
index 9449ebc7..6dd2ec52 100644
--- a/src/modules/bmb/docs/agents/expert-agent-architecture.md
+++ b/src/modules/bmb/docs/agents/expert-agent-architecture.md
@@ -202,7 +202,7 @@ Special variable resolved during installation:
- Points to the agent's installation directory
- Used to reference sidecar files
-- Example: `.bmad/custom/agents/journal-keeper/`
+- Example: `_bmad/custom/agents/journal-keeper/`
## What Gets Injected at Compile Time
@@ -238,7 +238,7 @@ Features demonstrated:
```bash
# Copy entire folder to your project
-cp -r /path/to/journal-keeper/ .bmad/custom/agents/
+cp -r /path/to/journal-keeper/ _bmad/custom/agents/
# Install with personalization
bmad agent-install
diff --git a/src/modules/bmb/docs/agents/module-agent-architecture.md b/src/modules/bmb/docs/agents/module-agent-architecture.md
index 61c256ad..8bd55054 100644
--- a/src/modules/bmb/docs/agents/module-agent-architecture.md
+++ b/src/modules/bmb/docs/agents/module-agent-architecture.md
@@ -19,7 +19,7 @@ src/modules/{module-code}/agents/{agent-name}.agent.yaml
Compiles to:
```
-.bmad/{module-code}/agents/{agent-name}.md
+_bmad/{module-code}/agents/{agent-name}.md
```
## YAML Structure
@@ -27,7 +27,7 @@ Compiles to:
```yaml
agent:
metadata:
- id: '.bmad/{module-code}/agents/{agent-name}.md'
+ id: '_bmad/{module-code}/agents/{agent-name}.md'
name: 'Persona Name'
title: 'Professional Title'
icon: 'emoji'
@@ -41,29 +41,29 @@ agent:
menu:
- trigger: workflow-action
- workflow: '{project-root}/.bmad/{module-code}/workflows/{workflow-name}/workflow.yaml'
+ workflow: '{project-root}/_bmad/{module-code}/workflows/{workflow-name}/workflow.yaml'
description: 'Execute module workflow'
- trigger: another-workflow
- workflow: '{project-root}/.bmad/core/workflows/{workflow-name}/workflow.yaml'
+ workflow: '{project-root}/_bmad/core/workflows/{workflow-name}/workflow.yaml'
description: 'Execute core workflow'
- trigger: task-action
- exec: '{project-root}/.bmad/{module-code}/tasks/{task-name}.xml'
+ exec: '{project-root}/_bmad/{module-code}/tasks/{task-name}.xml'
description: 'Execute module task'
- trigger: cross-module
- workflow: '{project-root}/.bmad/other-module/workflows/{workflow-name}/workflow.yaml'
+ workflow: '{project-root}/_bmad/other-module/workflows/{workflow-name}/workflow.yaml'
description: 'Execute workflow from another module'
- trigger: with-template
- exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
- tmpl: '{project-root}/.bmad/{module-code}/templates/{template-name}.md'
+ exec: '{project-root}/_bmad/core/tasks/create-doc.xml'
+ tmpl: '{project-root}/_bmad/{module-code}/templates/{template-name}.md'
description: 'Create document from template'
- trigger: with-data
- exec: '{project-root}/.bmad/{module-code}/tasks/{task-name}.xml'
- data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
+ exec: '{project-root}/_bmad/{module-code}/tasks/{task-name}.xml'
+ data: '{project-root}/_bmad/_cfg/agent-manifest.csv'
description: 'Execute task with data file'
```
@@ -71,7 +71,7 @@ agent:
### Metadata
-- **id**: Path with `.bmad` variable (resolved at install time)
+- **id**: Path with `_bmad` variable (resolved at install time)
- **name**: Agent persona name
- **title**: Professional role
- **icon**: Single emoji
@@ -101,7 +101,7 @@ persona:
```yaml
menu:
- trigger: create-prd
- workflow: '{project-root}/.bmad/bmm/workflows/prd/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/prd/workflow.yaml'
description: 'Create Product Requirements Document'
```
@@ -112,7 +112,7 @@ Invokes BMAD workflow engine to execute multi-step processes.
```yaml
menu:
- trigger: validate
- exec: '{project-root}/.bmad/core/tasks/validate-workflow.xml'
+ exec: '{project-root}/_bmad/core/tasks/validate-workflow.xml'
description: 'Validate document structure'
```
@@ -123,8 +123,8 @@ Executes single-operation tasks.
```yaml
menu:
- trigger: create-brief
- exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
- tmpl: '{project-root}/.bmad/bmm/templates/brief.md'
+ exec: '{project-root}/_bmad/core/tasks/create-doc.xml'
+ tmpl: '{project-root}/_bmad/bmm/templates/brief.md'
description: 'Create a Product Brief from template'
```
@@ -135,8 +135,8 @@ Combines task execution with template file.
```yaml
menu:
- trigger: team-standup
- exec: '{project-root}/.bmad/bmm/tasks/standup.xml'
- data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
+ exec: '{project-root}/_bmad/bmm/tasks/standup.xml'
+ data: '{project-root}/_bmad/_cfg/agent-manifest.csv'
description: 'Run team standup with agent roster'
```
@@ -160,12 +160,12 @@ Control visibility based on platform:
```yaml
menu:
- trigger: advanced-elicitation
- exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+ exec: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
description: 'Advanced elicitation techniques'
web-only: true # Only shows in web bundle
- trigger: git-operations
- exec: '{project-root}/.bmad/bmm/tasks/git-flow.xml'
+ exec: '{project-root}/_bmad/bmm/tasks/git-flow.xml'
description: 'Git workflow operations'
ide-only: true # Only shows in IDE environments
```
@@ -175,7 +175,7 @@ menu:
### Core Variables
- `{project-root}` - Root directory of installed project
-- `.bmad` - BMAD installation folder (usually `.bmad`)
+- `_bmad` - BMAD installation folder (usually `_bmad`)
- `{user_name}` - User's name from module config
- `{communication_language}` - Language preference
- `{output_folder}` - Document output directory
@@ -186,10 +186,10 @@ menu:
```yaml
# GOOD
-workflow: "{project-root}/.bmad/bmm/workflows/prd/workflow.yaml"
+workflow: "{project-root}/_bmad/bmm/workflows/prd/workflow.yaml"
# BAD
-workflow: "/Users/john/project/.bmad/bmm/workflows/prd/workflow.yaml"
+workflow: "/Users/john/project/_bmad/bmm/workflows/prd/workflow.yaml"
# BAD
workflow: "../../../bmm/workflows/prd/workflow.yaml"
@@ -208,7 +208,7 @@ Module agents use the same injection process as simple agents:
**Key difference:** Module agents load **module-specific config** instead of core config:
```xml
-Load and read {project-root}/.bmad/{module}/config.yaml...
+Load and read {project-root}/_bmad/{module}/config.yaml...
```
## Reference Examples
@@ -252,15 +252,15 @@ Agents load this at activation for consistent behavior.
```yaml
menu:
- trigger: init
- workflow: '{project-root}/.bmad/bmm/workflows/workflow-init/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/workflow-init/workflow.yaml'
description: 'Initialize workflow path (START HERE)'
- trigger: status
- workflow: '{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml'
description: 'Check current workflow status'
- trigger: next-step
- workflow: '{project-root}/.bmad/bmm/workflows/next-step/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/next-step/workflow.yaml'
description: 'Execute next workflow in sequence'
```
@@ -270,20 +270,20 @@ menu:
menu:
# Phase 1: Analysis
- trigger: brainstorm
- workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
description: 'Guided brainstorming session'
- trigger: research
- workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/research/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.yaml'
description: 'Market and technical research'
# Phase 2: Planning
- trigger: prd
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/prd/workflow.yaml'
description: 'Create PRD'
- trigger: architecture
- workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
+ workflow: '{project-root}/_bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
description: 'Design architecture'
```
@@ -292,11 +292,11 @@ menu:
```yaml
menu:
- trigger: party-mode
- workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
+ workflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.yaml'
description: 'Bring all agents together'
- trigger: brainstorm
- workflow: '{project-root}/.bmad/cis/workflows/brainstorming/workflow.yaml'
+ workflow: '{project-root}/_bmad/cis/workflows/brainstorming/workflow.yaml'
description: 'Use CIS brainstorming techniques'
```
@@ -317,7 +317,7 @@ menu:
```yaml
menu:
- trigger: start
- workflow: '{project-root}/.bmad/{module}/workflows/init/workflow.yaml'
+ workflow: '{project-root}/_bmad/{module}/workflows/init/workflow.yaml'
description: 'Start new project (BEGIN HERE)'
```
@@ -326,7 +326,7 @@ menu:
```yaml
menu:
- trigger: status
- workflow: '{project-root}/.bmad/{module}/workflows/status/workflow.yaml'
+ workflow: '{project-root}/_bmad/{module}/workflows/status/workflow.yaml'
description: 'Check workflow progress'
```
@@ -335,7 +335,7 @@ menu:
```yaml
menu:
- trigger: party
- workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
+ workflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.yaml'
description: 'Multi-agent discussion'
```
@@ -343,7 +343,7 @@ menu:
| Aspect | Module Agent | Simple/Expert Agent |
| ------------- | --------------------------- | ------------------------------- |
-| Location | `.bmad/{module}/agents/` | `.bmad/custom/agents/` |
+| Location | `_bmad/{module}/agents/` | `_bmad/custom/agents/` |
| Persona | Fixed, professional | Customizable via install_config |
| Handlebars | No templating | Yes, extensive |
| Menu actions | Workflows, tasks, templates | Prompts, inline actions |
@@ -354,8 +354,8 @@ menu:
- [ ] Valid YAML syntax
- [ ] Metadata includes `module: "{module-code}"`
-- [ ] id uses `.bmad/{module}/agents/{name}.md`
-- [ ] All workflow paths use `{project-root}/.bmad/` prefix
+- [ ] id uses `_bmad/{module}/agents/{name}.md`
+- [ ] All workflow paths use `{project-root}/_bmad/` prefix
- [ ] No hardcoded paths
- [ ] No duplicate triggers
- [ ] Each menu item has description
diff --git a/src/modules/bmb/docs/agents/simple-agent-architecture.md b/src/modules/bmb/docs/agents/simple-agent-architecture.md
index 9d1898b7..fe232d7c 100644
--- a/src/modules/bmb/docs/agents/simple-agent-architecture.md
+++ b/src/modules/bmb/docs/agents/simple-agent-architecture.md
@@ -14,7 +14,7 @@ Self-contained agents with prompts, menus, and optional install-time customizati
```yaml
agent:
metadata:
- id: .bmad/agents/{agent-name}/{agent-name}.md
+ id: _bmad/agents/{agent-name}/{agent-name}.md
name: 'Persona Name'
title: 'Agent Title'
icon: 'emoji'
@@ -104,7 +104,7 @@ agent:
### Metadata
-- **id**: Final compiled path (`.bmad/agents/{name}/{name}.md` for standalone)
+- **id**: Final compiled path (`_bmad/agents/{name}/{name}.md` for standalone)
- **name**: Agent's persona name displayed to users
- **title**: Professional role/function
- **icon**: Single emoji for visual identification
@@ -215,7 +215,7 @@ Features demonstrated:
```bash
# Copy to your project
-cp /path/to/commit-poet.agent.yaml .bmad/custom/agents/
+cp /path/to/commit-poet.agent.yaml _bmad/custom/agents/
# Create custom.yaml and install
echo "code: my-agent
diff --git a/src/modules/bmb/docs/agents/understanding-agent-types.md b/src/modules/bmb/docs/agents/understanding-agent-types.md
index 944e695d..80cc0395 100644
--- a/src/modules/bmb/docs/agents/understanding-agent-types.md
+++ b/src/modules/bmb/docs/agents/understanding-agent-types.md
@@ -7,7 +7,7 @@ ALL agent types can:
- ✓ Write to {output_folder}, {project-root}, or anywhere on system
- ✓ Update artifacts and files
- ✓ Execute bash commands
-- ✓ Use core variables (.bmad, {output_folder}, etc.)
+- ✓ Use core variables (\_bmad, {output_folder}, etc.)
- ✓ Have complex prompts and logic
- ✓ Invoke external tools
@@ -98,11 +98,11 @@ agent:
menu:
- trigger: implement-story
- workflow: '.bmad/bmm/workflows/dev-story/workflow.yaml'
+ workflow: '_bmad/bmm/workflows/dev-story/workflow.yaml'
description: Implement user story
- trigger: refactor
- workflow: '.bmad/bmm/workflows/refactor/workflow.yaml'
+ workflow: '_bmad/bmm/workflows/refactor/workflow.yaml'
description: Refactor codebase
```
@@ -122,7 +122,7 @@ agent:
### The Reality
- **Any agent type** (Simple, Expert, Module) can be bundled with or added to a module
-- A Simple agent COULD live in `.bmad/bmm/agents/`
+- A Simple agent COULD live in `_bmad/bmm/agents/`
- An Expert agent COULD be included in a module bundle
### What Makes a "Module Agent" Special
@@ -138,14 +138,14 @@ A **Module Agent** is specifically:
**Simple Agent added to BMM:**
-- Lives in `.bmad/bmm/agents/formatter.agent.yaml`
+- Lives in `_bmad/bmm/agents/formatter.agent.yaml`
- Bundled with BMM for convenience
- But still stateless, self-contained
- NOT a "Module Agent" - just a Simple agent in a module
**Module Agent in BMM:**
-- Lives in `.bmad/bmm/agents/tech-writer.agent.yaml`
+- Lives in `_bmad/bmm/agents/tech-writer.agent.yaml`
- Orchestrates BMM documentation workflows
- Coordinates with other BMM agents (PM, Dev, Analyst)
- Included in default BMM bundle
diff --git a/src/modules/bmb/docs/workflows/architecture.md b/src/modules/bmb/docs/workflows/architecture.md
index 86f43698..ae3db202 100644
--- a/src/modules/bmb/docs/workflows/architecture.md
+++ b/src/modules/bmb/docs/workflows/architecture.md
@@ -69,7 +69,7 @@ workflow-folder/
Standard variables in step files:
```yaml
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/[workflow-name]'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/[workflow-name]'
thisStepFile: '{workflow_path}/steps/step-[N]-[name].md'
nextStepFile: '{workflow_path}/steps/step-[N+1]-[name].md'
workflowFile: '{workflow_path}/workflow.md'
diff --git a/src/modules/bmb/docs/workflows/common-workflow-tools.csv b/src/modules/bmb/docs/workflows/common-workflow-tools.csv
index d6c09045..2ab6cef4 100644
--- a/src/modules/bmb/docs/workflows/common-workflow-tools.csv
+++ b/src/modules/bmb/docs/workflows/common-workflow-tools.csv
@@ -1,7 +1,7 @@
propose,type,tool_name,description,url,requires_install
-always,workflow,party-mode,"Enables collaborative idea generation by managing turn-taking, summarizing contributions, and synthesizing ideas from multiple AI personas in structured conversation sessions about workflow steps or work in progress.",{project-root}/.bmad/core/workflows/party-mode/workflow.md,no
-always,task,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/.bmad/core/tasks/advanced-elicitation.xml,no
-always,task,brainstorming,"Facilitates idea generation by prompting users with targeted questions, encouraging divergent thinking, and synthesizing concepts into actionable insights through collaborative creative exploration.",{project-root}/.bmad/core/tasks/brainstorming.xml,no
+always,workflow,party-mode,"Enables collaborative idea generation by managing turn-taking, summarizing contributions, and synthesizing ideas from multiple AI personas in structured conversation sessions about workflow steps or work in progress.",{project-root}/_bmad/core/workflows/party-mode/workflow.md,no
+always,task,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/_bmad/core/tasks/advanced-elicitation.xml,no
+always,task,brainstorming,"Facilitates idea generation by prompting users with targeted questions, encouraging divergent thinking, and synthesizing concepts into actionable insights through collaborative creative exploration.",{project-root}/_bmad/core/tasks/brainstorming.xml,no
always,llm-tool-feature,web-browsing,"Provides LLM with capabilities to perform real-time web searches, extract relevant data, and incorporate current information into responses when up-to-date information is required beyond training knowledge.",,no
always,llm-tool-feature,file-io,"Enables LLM to manage file operations such as creating, reading, updating, and deleting files, facilitating seamless data handling, storage, and document management within user environments.",,no
always,llm-tool-feature,sub-agents,"Allows LLM to create and manage specialized sub-agents that handle specific tasks or modules within larger workflows, improving efficiency through parallel processing and modular task delegation.",,no
diff --git a/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md b/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md
index 4ed2f084..beb56dff 100644
--- a/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md
@@ -13,7 +13,7 @@ description: 'Initialize the [workflow-type] workflow by detecting continuation
-workflow\*path: '{project-root}/.bmad/[module-path]/workflows/[workflow-name]'
+workflow\*path: '{project-root}/\_bmad/[module-path]/workflows/[workflow-name]'
# File References (all use {variable} format in file)
diff --git a/src/modules/bmb/docs/workflows/templates/step-1b-template.md b/src/modules/bmb/docs/workflows/templates/step-1b-template.md
index 57cca34d..3f5273ac 100644
--- a/src/modules/bmb/docs/workflows/templates/step-1b-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-1b-template.md
@@ -13,7 +13,7 @@ description: 'Handle workflow continuation from previous session'
-workflow\*path: '{project-root}/.bmad/[module-path]/workflows/[workflow-name]'
+workflow\*path: '{project-root}/\_bmad/[module-path]/workflows/[workflow-name]'
# File References (all use {variable} format in file)
diff --git a/src/modules/bmb/docs/workflows/templates/step-file.md b/src/modules/bmb/docs/workflows/templates/step-file.md
index efef1534..2c1d8d0e 100644
--- a/src/modules/bmb/docs/workflows/templates/step-file.md
+++ b/src/modules/bmb/docs/workflows/templates/step-file.md
@@ -3,7 +3,7 @@ name: "step-{{stepNumber}}-{{stepName}}"
description: "{{stepDescription}}"
# Path Definitions
-workflow_path: "{project-root}/.bmad/{{targetModule}}/workflows/{{workflowName}}"
+workflow_path: "{project-root}/_bmad/{{targetModule}}/workflows/{{workflowName}}"
# File References
thisStepFile: "{workflow_path}/steps/step-{{stepNumber}}-{{stepName}}.md"
@@ -16,8 +16,8 @@ outputFile: "{output_folder}/{{outputFileName}}-{project_name}.md"
{{/hasOutput}}
# Task References (list only if used in THIS step file instance and only the ones used, there might be others)
-advancedElicitationTask: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
-partyModeWorkflow: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+advancedElicitationTask: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
+partyModeWorkflow: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
{{#hasTemplates}}
# Template References
diff --git a/src/modules/bmb/docs/workflows/templates/step-template.md b/src/modules/bmb/docs/workflows/templates/step-template.md
index b148e96e..55612989 100644
--- a/src/modules/bmb/docs/workflows/templates/step-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-template.md
@@ -11,7 +11,7 @@ description: '[Brief description of what this step accomplishes]'
-workflow\*path: '{project-root}/.bmad/[module]/reference/workflows/[workflow-name]' # the folder the workflow.md file is in
+workflow\*path: '{project-root}/\_bmad/[module]/reference/workflows/[workflow-name]' # the folder the workflow.md file is in
# File References (all use {variable} format in file)
@@ -23,8 +23,8 @@ outputFile: '{output_folder}/[output-file-name]-{project_name}.md'
# Task References (IF THE workflow uses and it makes sense in this step to have these )
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/\_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/\_bmad/core/workflows/party-mode/workflow.md'
# Template References (if this step uses a specific templates)
diff --git a/src/modules/bmb/docs/workflows/templates/workflow-template.md b/src/modules/bmb/docs/workflows/templates/workflow-template.md
index 2c33e10e..109eb820 100644
--- a/src/modules/bmb/docs/workflows/templates/workflow-template.md
+++ b/src/modules/bmb/docs/workflows/templates/workflow-template.md
@@ -53,7 +53,7 @@ web_bundle: [true/false] # Set to true for inclusion in web bundle builds
### 1. Module Configuration Loading
-Load and read full config from {project-root}/.bmad/[MODULE FOLDER]/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/[MODULE FOLDER]/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, [MODULE VARS]
@@ -101,4 +101,4 @@ Example: Load, read the full file and then execute `{workflow_path}/steps/step-0
### NOTE: You can View a real example of a perfect workflow.md file that was created from this template
-`{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md`
+`{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md`
diff --git a/src/modules/bmb/docs/workflows/templates/workflow.md b/src/modules/bmb/docs/workflows/templates/workflow.md
index 1190e74b..e68f52cd 100644
--- a/src/modules/bmb/docs/workflows/templates/workflow.md
+++ b/src/modules/bmb/docs/workflows/templates/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/{{targetModule}}/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/{{targetModule}}/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
diff --git a/src/modules/bmb/reference/agents/module-examples/README.md b/src/modules/bmb/reference/agents/module-examples/README.md
index 878cc33d..11202547 100644
--- a/src/modules/bmb/reference/agents/module-examples/README.md
+++ b/src/modules/bmb/reference/agents/module-examples/README.md
@@ -7,7 +7,7 @@ Reference examples for module-integrated agents.
Module agents integrate with BMAD module workflows (BMM, CIS, BMB). They:
- Orchestrate multi-step workflows
-- Use `.bmad` path variables
+- Use `_bmad` path variables
- Have fixed professional personas (no install_config)
- Reference module-specific configurations
diff --git a/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml b/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml
index 82b5a199..e9261786 100644
--- a/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml
+++ b/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml
@@ -10,7 +10,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/security-engineer.md"
+ id: "_bmad/bmm/agents/security-engineer.md"
name: "Sam"
title: "Security Engineer"
icon: "🔐"
@@ -32,11 +32,11 @@ agent:
menu:
# NOTE: These workflows are hypothetical examples assuming add to a module called bmm - not implemented
- trigger: threat-model
- exec: "{project-root}/.bmad/bmm/workflows/threat-model/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/threat-model/workflow.md"
description: "Create STRIDE threat model for architecture"
- trigger: security-review
- exec: "{project-root}/.bmad/bmm/workflows/security-review/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/security-review/workflow.md"
description: "Review code/design for security issues"
- trigger: owasp-check
@@ -44,10 +44,10 @@ agent:
description: "Check against OWASP Top 10"
- trigger: compliance
- exec: "{project-root}/.bmad/bmm/workflows/compliance-check/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/compliance-check/workflow.md"
description: "Verify compliance requirements (SOC2, GDPR, etc.)"
# Core workflow that exists
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: "Multi-agent security discussion"
diff --git a/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml b/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml
index 2f612305..f317ee3b 100644
--- a/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml
+++ b/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml
@@ -10,7 +10,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/trend-analyst.md"
+ id: "_bmad/cis/agents/trend-analyst.md"
name: "Nova"
title: "Trend Analyst"
icon: "📈"
@@ -32,26 +32,26 @@ agent:
menu:
# NOTE: These workflows are hypothetical examples - not implemented
- trigger: scan-trends
- exec: "{project-root}/.bmad/cis/workflows/trend-scan/workflow.md"
+ exec: "{project-root}/_bmad/cis/workflows/trend-scan/workflow.md"
description: "Scan for emerging trends in a domain"
- trigger: analyze-trend
- exec: "{project-root}/.bmad/cis/workflows/trend-analysis/workflow.md"
+ exec: "{project-root}/_bmad/cis/workflows/trend-analysis/workflow.md"
description: "Deep dive on a specific trend"
- trigger: opportunity-map
- exec: "{project-root}/.bmad/cis/workflows/opportunity-mapping/workflow.md"
+ exec: "{project-root}/_bmad/cis/workflows/opportunity-mapping/workflow.md"
description: "Map trend to strategic opportunities"
- trigger: competitor-trends
- exec: "{project-root}/.bmad/cis/tasks/competitor-trend-watch.xml"
+ exec: "{project-root}/_bmad/cis/tasks/competitor-trend-watch.xml"
description: "Monitor competitor trend adoption"
# Core workflows that exist
- trigger: brainstorm
- exec: "{project-root}/.bmad/core/workflows/brainstorming/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
description: "Brainstorm trend implications"
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: "Discuss trends with other agents"
diff --git a/src/modules/bmb/reference/agents/simple-examples/README.md b/src/modules/bmb/reference/agents/simple-examples/README.md
index 4ed4a05e..4cb67b0e 100644
--- a/src/modules/bmb/reference/agents/simple-examples/README.md
+++ b/src/modules/bmb/reference/agents/simple-examples/README.md
@@ -127,7 +127,7 @@ This personality is maintained across ALL commands through the persona definitio
```yaml
agent:
metadata:
- id: .bmad/agents/{agent-name}/{agent-name}.md # Build path
+ id: _bmad/agents/{agent-name}/{agent-name}.md # Build path
name: "Display Name"
title: "Professional Title"
icon: "🎭"
diff --git a/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml b/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml
index a1ae4887..d947068d 100644
--- a/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml
+++ b/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml
@@ -1,6 +1,6 @@
agent:
metadata:
- id: .bmad/agents/commit-poet/commit-poet.md
+ id: _bmad/agents/commit-poet/commit-poet.md
name: "Inkwell Von Comitizen"
title: "Commit Message Artisan"
icon: "📜"
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
index 2479d3bd..0c6e6ea6 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
description: 'Initialize the nutrition plan workflow by detecting continuation state and creating output document'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-01-init.md'
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
index 14802db4..2345647e 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
description: 'Handle workflow continuation from previous session'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
index 58c89409..47ddf3e6 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
@@ -3,7 +3,7 @@ name: 'step-02-profile'
description: 'Gather comprehensive user profile information through collaborative conversation'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References (all use {variable} format in file)
thisStepFile: '{workflow_path}/steps/step-02-profile.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
profileTemplate: '{workflow_path}/templates/profile-section.md'
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
index 87b0288a..2c6f0af3 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
@@ -3,7 +3,7 @@ name: 'step-03-assessment'
description: 'Analyze nutritional requirements, identify restrictions, and calculate target macros'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-03-assessment.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Data References
dietaryRestrictionsDB: '{workflow_path}/data/dietary-restrictions.csv'
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
index 2b543381..5f63204b 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
@@ -3,7 +3,7 @@ name: 'step-04-strategy'
description: 'Design a personalized meal strategy that meets nutritional needs and fits lifestyle'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-04-strategy.md'
@@ -13,8 +13,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Data References
recipeDatabase: '{workflow_path}/data/recipe-database.csv'
@@ -167,8 +167,8 @@ Display: **Select an Option:** [A] Meal Variety Optimization [P] Chef & Dietitia
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md` with a chef and dietitian expert also as part of the party
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md` with a chef and dietitian expert also as part of the party
- IF C: Save content to nutrition-plan.md, update frontmatter `stepsCompleted` to add 4 at the end of the array before loading next step, check cooking frequency:
- IF cooking frequency > 2x/week: load, read entire file, then execute `{workflow_path}/step-05-shopping.md`
- IF cooking frequency ≤ 2x/week: load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
index c3c5d6ca..67867768 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
@@ -3,7 +3,7 @@ name: 'step-05-shopping'
description: 'Create a comprehensive shopping list that supports the meal strategy'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-05-shopping.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
shoppingTemplate: '{workflow_path}/templates/shopping-section.md'
@@ -157,8 +157,8 @@ Display: **Select an Option:** [A] Budget Optimization Strategies [P] Shopping P
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md`
- IF C: Save content to nutrition-plan.md, update frontmatter `stepsCompleted` to add 5 at the end of the array before loading next step, then load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#5-present-menu-options)
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
index 43c67322..3e3eb569 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
@@ -3,7 +3,7 @@ name: 'step-06-prep-schedule'
description: "Create a realistic meal prep schedule that fits the user's lifestyle"
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-06-prep-schedule.md'
@@ -11,8 +11,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
prepScheduleTemplate: '{workflow_path}/templates/prep-schedule-section.md'
@@ -178,8 +178,8 @@ Display: **Select an Option:** [A] Advanced Prep Techniques [P] Coach Perspectiv
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md`
- IF C: update frontmatter `stepsCompleted` to add 6 at the end of the array before loading next step, mark workflow complete, display final message
- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)
diff --git a/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md b/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md
index 960a5994..8db13c65 100644
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/core/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/core/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
### 2. First Step EXECUTION
-Load, read the full file and then execute `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
diff --git a/src/modules/bmb/workflows-legacy/edit-module/README.md b/src/modules/bmb/workflows-legacy/edit-module/README.md
index 6847cf57..e5bd2ac4 100644
--- a/src/modules/bmb/workflows-legacy/edit-module/README.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/README.md
@@ -106,7 +106,7 @@ Modules can share workflows:
```yaml
# In agent menu item:
-workflow: '{project-root}/.bmad/other-module/workflows/shared-workflow/workflow.yaml'
+workflow: '{project-root}/_bmad/other-module/workflows/shared-workflow/workflow.yaml'
```
Common patterns:
@@ -151,7 +151,7 @@ Changes are reviewed and approved by you before being applied.
- Can configure web bundles
- Are the development source of truth
-**Installed modules** (in .bmad/):
+**Installed modules** (in \_bmad/):
- Are deployed to target projects
- Use config.yaml for user customization
diff --git a/src/modules/bmb/workflows-legacy/edit-module/checklist.md b/src/modules/bmb/workflows-legacy/edit-module/checklist.md
index 4bf532ab..b7216a44 100644
--- a/src/modules/bmb/workflows-legacy/edit-module/checklist.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/checklist.md
@@ -5,7 +5,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
## Module Structure Validation
- [ ] Module has clear 3-letter code (bmm, bmb, cis, etc.)
-- [ ] Module is in correct location (src/modules/ for source, .bmad/ for installed)
+- [ ] Module is in correct location (src/modules/ for source, \_bmad/ for installed)
- [ ] agents/ directory exists
- [ ] workflows/ directory exists
- [ ] config.yaml exists in module root
@@ -127,7 +127,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
- [ ] Web bundles configured in workflow.yaml files
- [ ] All referenced files included in web_bundle_files
-- [ ] Paths are .bmad/-relative (not project-root)
+- [ ] Paths are \_bmad/-relative (not project-root)
- [ ] No config_source references in web bundles
- [ ] Invoked workflows included in dependencies
diff --git a/src/modules/bmb/workflows-legacy/edit-module/instructions.md b/src/modules/bmb/workflows-legacy/edit-module/instructions.md
index 0f112a25..8d08d590 100644
--- a/src/modules/bmb/workflows-legacy/edit-module/instructions.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/instructions.md
@@ -1,7 +1,7 @@
# Edit Module - Module Editor Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmb/workflows/edit-module/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmb/workflows/edit-module/workflow.yaml
This workflow uses ADAPTIVE FACILITATION - adjust your communication based on context and user needs
The goal is COLLABORATIVE IMPROVEMENT - work WITH the user, not FOR them
Communicate all responses in {communication_language}
@@ -9,7 +9,7 @@
-What is the path to the module you want to edit? (provide path to module directory like .bmad/bmm/ or src/modules/bmm/)
+What is the path to the module you want to edit? (provide path to module directory like _bmad/bmm/ or src/modules/bmm/)
Load the module directory structure completely:
@@ -187,7 +187,7 @@ Let the conversation flow naturally. Build a shared vision of what "better" look
**If setting up cross-module integration:**
- Identify which workflows from other modules are needed
-- Show how to reference workflows properly: {project-root}/.bmad/{{module}}/workflows/{{workflow}}/workflow.yaml
+- Show how to reference workflows properly: {project-root}/\_bmad/{{module}}/workflows/{{workflow}}/workflow.yaml
- Document the integration in README
- Ensure dependencies are clear
- Consider adding example usage
diff --git a/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml b/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml
index 87b72de0..d66ef667 100644
--- a/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml
+++ b/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml
@@ -4,26 +4,26 @@ description: "Edit existing BMAD modules (structure, agents, workflows, document
author: "BMad"
# Critical variables load from config_source
-config_source: "{project-root}/.bmad/bmb/config.yaml"
+config_source: "{project-root}/_bmad/bmb/config.yaml"
communication_language: "{config_source}:communication_language"
user_name: "{config_source}:user_name"
# Required Data Files - Critical for understanding module conventions
-module_structure_guide: "{project-root}/.bmad/bmb/workflows/create-module/module-structure.md"
+module_structure_guide: "{project-root}/_bmad/bmb/workflows/create-module/module-structure.md"
# Related workflow editors
-agent_editor: "{project-root}/.bmad/bmb/workflows/edit-agent/workflow.yaml"
-workflow_editor: "{project-root}/.bmad/bmb/workflows/edit-workflow/workflow.yaml"
+agent_editor: "{project-root}/_bmad/bmb/workflows/edit-agent/workflow.yaml"
+workflow_editor: "{project-root}/_bmad/bmb/workflows/edit-workflow/workflow.yaml"
# Reference examples - for learning patterns
-bmm_module_dir: "{project-root}/.bmad/bmm/"
-bmb_module_dir: "{project-root}/.bmad/bmb/"
-cis_module_dir: "{project-root}/.bmad/cis/"
-existing_agents_dir: "{project-root}/.bmad/*/agents/"
-existing_workflows_dir: "{project-root}/.bmad/*/workflows/"
+bmm_module_dir: "{project-root}/_bmad/bmm/"
+bmb_module_dir: "{project-root}/_bmad/bmb/"
+cis_module_dir: "{project-root}/_bmad/cis/"
+existing_agents_dir: "{project-root}/_bmad/*/agents/"
+existing_workflows_dir: "{project-root}/_bmad/*/workflows/"
# Module path and component files
-installed_path: "{project-root}/.bmad/bmb/workflows/edit-module"
+installed_path: "{project-root}/_bmad/bmb/workflows/edit-module"
template: false # This is an action workflow - no template needed
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmb/workflows-legacy/module-brief/README.md b/src/modules/bmb/workflows-legacy/module-brief/README.md
index 82ba9935..ccf6173c 100644
--- a/src/modules/bmb/workflows-legacy/module-brief/README.md
+++ b/src/modules/bmb/workflows-legacy/module-brief/README.md
@@ -254,8 +254,8 @@ To customize this workflow:
For issues or questions:
-- Review the workflow creation guide at `/.bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
-- Study existing module examples in `/.bmad/` for patterns and inspiration
+- Review the workflow creation guide at `/_bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
+- Study existing module examples in `/_bmad/` for patterns and inspiration
- Validate output using `checklist.md`
- Consult module structure guide at `create-module/module-structure.md`
diff --git a/src/modules/bmb/workflows-legacy/module-brief/instructions.md b/src/modules/bmb/workflows-legacy/module-brief/instructions.md
index a094b912..384fa101 100644
--- a/src/modules/bmb/workflows-legacy/module-brief/instructions.md
+++ b/src/modules/bmb/workflows-legacy/module-brief/instructions.md
@@ -1,7 +1,7 @@
# Module Brief Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmb/workflows/module-brief/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmb/workflows/module-brief/workflow.yaml
Communicate in {communication_language} throughout the module brief creation process
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
diff --git a/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml b/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml
index c25cdfe7..772f6801 100644
--- a/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml
+++ b/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml
@@ -4,15 +4,15 @@ description: "Create a comprehensive Module Brief that serves as the blueprint f
author: "BMad Builder"
# Critical variables
-config_source: "{project-root}/.bmad/bmb/config.yaml"
+config_source: "{project-root}/_bmad/bmb/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
date: system-generated
# Reference examples and documentation
-existing_modules_dir: "{project-root}/.bmad/"
-module_structure_guide: "{project-root}/.bmad/bmb/workflows/create-module/module-structure.md"
+existing_modules_dir: "{project-root}/_bmad/"
+module_structure_guide: "{project-root}/_bmad/bmb/workflows/create-module/module-structure.md"
# Optional user inputs - discovered if they exist
input_file_patterns:
@@ -22,7 +22,7 @@ input_file_patterns:
load_strategy: "FULL_LOAD"
# Module path and component files
-installed_path: "{project-root}/.bmad/bmb/workflows/module-brief"
+installed_path: "{project-root}/_bmad/bmb/workflows/module-brief"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md
index 878cc33d..11202547 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md
@@ -7,7 +7,7 @@ Reference examples for module-integrated agents.
Module agents integrate with BMAD module workflows (BMM, CIS, BMB). They:
- Orchestrate multi-step workflows
-- Use `.bmad` path variables
+- Use `_bmad` path variables
- Have fixed professional personas (no install_config)
- Reference module-specific configurations
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml
index da3febac..fed9e81c 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml
@@ -10,7 +10,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/security-engineer.md"
+ id: "_bmad/bmm/agents/security-engineer.md"
name: "Sam"
title: "Security Engineer"
icon: "🔐"
@@ -32,22 +32,22 @@ agent:
menu:
# NOTE: These workflows are hypothetical examples - not implemented
- trigger: threat-model
- workflow: "{project-root}/.bmad/bmm/workflows/threat-model/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/threat-model/workflow.yaml"
description: "Create STRIDE threat model for architecture"
- trigger: security-review
- workflow: "{project-root}/.bmad/bmm/workflows/security-review/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/security-review/workflow.yaml"
description: "Review code/design for security issues"
- trigger: owasp-check
- exec: "{project-root}/.bmad/bmm/tasks/owasp-top-10.xml"
+ exec: "{project-root}/_bmad/bmm/tasks/owasp-top-10.xml"
description: "Check against OWASP Top 10"
- trigger: compliance
- workflow: "{project-root}/.bmad/bmm/workflows/compliance-check/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/compliance-check/workflow.yaml"
description: "Verify compliance requirements (SOC2, GDPR, etc.)"
# Core workflow that exists
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: "Multi-agent security discussion"
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml
index cc05b80e..e926d4a9 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml
@@ -10,7 +10,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/trend-analyst.md"
+ id: "_bmad/cis/agents/trend-analyst.md"
name: "Nova"
title: "Trend Analyst"
icon: "📈"
@@ -32,26 +32,26 @@ agent:
menu:
# NOTE: These workflows are hypothetical examples - not implemented
- trigger: scan-trends
- workflow: "{project-root}/.bmad/cis/workflows/trend-scan/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/trend-scan/workflow.yaml"
description: "Scan for emerging trends in a domain"
- trigger: analyze-trend
- workflow: "{project-root}/.bmad/cis/workflows/trend-analysis/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/trend-analysis/workflow.yaml"
description: "Deep dive on a specific trend"
- trigger: opportunity-map
- workflow: "{project-root}/.bmad/cis/workflows/opportunity-mapping/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/opportunity-mapping/workflow.yaml"
description: "Map trend to strategic opportunities"
- trigger: competitor-trends
- exec: "{project-root}/.bmad/cis/tasks/competitor-trend-watch.xml"
+ exec: "{project-root}/_bmad/cis/tasks/competitor-trend-watch.xml"
description: "Monitor competitor trend adoption"
# Core workflows that exist
- trigger: brainstorm
- workflow: "{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml"
+ workflow: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
description: "Brainstorm trend implications"
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: "Discuss trends with other agents"
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md b/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md
index 4ed4a05e..4cb67b0e 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/README.md
@@ -127,7 +127,7 @@ This personality is maintained across ALL commands through the persona definitio
```yaml
agent:
metadata:
- id: .bmad/agents/{agent-name}/{agent-name}.md # Build path
+ id: _bmad/agents/{agent-name}/{agent-name}.md # Build path
name: "Display Name"
title: "Professional Title"
icon: "🎭"
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/commit-poet.agent.yaml b/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/commit-poet.agent.yaml
index a1ae4887..d947068d 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/commit-poet.agent.yaml
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/simple-examples/commit-poet.agent.yaml
@@ -1,6 +1,6 @@
agent:
metadata:
- id: .bmad/agents/commit-poet/commit-poet.md
+ id: _bmad/agents/commit-poet/commit-poet.md
name: "Inkwell Von Comitizen"
title: "Commit Message Artisan"
icon: "📜"
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
index 8646c5c9..e72c3fe8 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
description: 'Initialize the nutrition plan workflow by detecting continuation state and creating output document'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-01-init.md'
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
index b390f3c8..704aabe7 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
description: 'Handle workflow continuation from previous session'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
index c50e8179..d863adaa 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
@@ -3,7 +3,7 @@ name: 'step-02-profile'
description: 'Gather comprehensive user profile information through collaborative conversation'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References (all use {variable} format in file)
thisStepFile: '{workflow_path}/steps/step-02-profile.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
profileTemplate: '{workflow_path}/templates/profile-section.md'
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
index 8fa087f5..4b4d71cc 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
@@ -3,7 +3,7 @@ name: 'step-03-assessment'
description: 'Analyze nutritional requirements, identify restrictions, and calculate target macros'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-03-assessment.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Data References
dietaryRestrictionsDB: '{workflow_path}/data/dietary-restrictions.csv'
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
index fe2ce026..7c57eadc 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
@@ -3,7 +3,7 @@ name: 'step-04-strategy'
description: 'Design a personalized meal strategy that meets nutritional needs and fits lifestyle'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-04-strategy.md'
@@ -13,8 +13,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Data References
recipeDatabase: '{workflow_path}/data/recipe-database.csv'
@@ -167,8 +167,8 @@ Display: **Select an Option:** [A] Meal Variety Optimization [P] Chef & Dietitia
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md`
- IF C: Save content to nutrition-plan.md, update frontmatter, check cooking frequency:
- IF cooking frequency > 2x/week: load, read entire file, then execute `{workflow_path}/step-05-shopping.md`
- IF cooking frequency ≤ 2x/week: load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
index 34d1b3f7..f77dcb54 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
@@ -3,7 +3,7 @@ name: 'step-05-shopping'
description: 'Create a comprehensive shopping list that supports the meal strategy'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-05-shopping.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
shoppingTemplate: '{workflow_path}/templates/shopping-section.md'
@@ -157,8 +157,8 @@ Display: **Select an Option:** [A] Budget Optimization Strategies [P] Shopping P
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md`
- IF C: Save content to nutrition-plan.md, update frontmatter, then load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#5-present-menu-options)
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
index 79d587c7..1b69c58e 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
@@ -3,7 +3,7 @@ name: 'step-06-prep-schedule'
description: "Create a realistic meal prep schedule that fits the user's lifestyle"
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition'
# File References
thisStepFile: '{workflow_path}/steps/step-06-prep-schedule.md'
@@ -11,8 +11,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/nutrition-plan-{project_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
prepScheduleTemplate: '{workflow_path}/templates/prep-schedule-section.md'
@@ -178,8 +178,8 @@ Display: **Select an Option:** [A] Advanced Prep Techniques [P] Coach Perspectiv
#### Menu Handling Logic:
- HALT and AWAIT ANSWER
-- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
-- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/_bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/_bmad/core/workflows/party-mode/workflow.md`
- IF C: Update frontmatter with all steps completed, mark workflow complete, display final message
- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)
diff --git a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md
index 843f2998..6b6fd9db 100644
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmm/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmm/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level`
### 2. First Step EXECUTION
-Load, read the full file and then execute `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
diff --git a/src/modules/bmb/workflows/create-agent/data/validation-complete.md b/src/modules/bmb/workflows/create-agent/data/validation-complete.md
index bb204895..0372d237 100644
--- a/src/modules/bmb/workflows/create-agent/data/validation-complete.md
+++ b/src/modules/bmb/workflows/create-agent/data/validation-complete.md
@@ -81,10 +81,10 @@
**Agent Documentation References**
-- Agent compilation guide: `{project-root}/.bmad/bmb/docs/agents/agent-compilation.md`
-- Agent types guide: `{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md`
+- Agent compilation guide: `{project-root}/_bmad/bmb/docs/agents/agent-compilation.md`
+- Agent types guide: `{project-root}/_bmad/bmb/docs/agents/understanding-agent-types.md`
- Architecture docs: simple, expert, module agent architectures
-- Menu patterns guide: `{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md`
+- Menu patterns guide: `{project-root}/_bmad/bmb/docs/agents/agent-menu-patterns.md`
- Status: ✅ ALL REFERENCES PRESERVED
**Communication Presets**
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md b/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md
index 5f487b09..7a48db09 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md
@@ -10,11 +10,11 @@ thisStepFile: '{workflow_path}/steps/step-01-brainstorm.md'
nextStepFile: '{workflow_path}/steps/step-02-discover.md'
workflowFile: '{workflow_path}/workflow.md'
brainstormContext: '{workflow_path}/data/brainstorm-context.md'
-brainstormWorkflow: '{project-root}/.bmad/core/workflows/brainstorming/workflow.md'
+brainstormWorkflow: '{project-root}/_bmad/core/workflows/brainstorming/workflow.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 1: Optional Brainstorming
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md b/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md
index 60daeeaa..bf009ddc 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md
@@ -10,7 +10,7 @@ thisStepFile: '{workflow_path}/steps/step-02-discover.md'
nextStepFile: '{workflow_path}/steps/step-03-persona.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-purpose-{project_name}.md'
-agentTypesGuide: '{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md'
+agentTypesGuide: '{project-root}/_bmad/bmb/docs/agents/understanding-agent-types.md'
simpleExamples: '{workflow_path}/data/reference/agents/simple-examples/'
expertExamples: '{workflow_path}/data/reference/agents/expert-examples/'
moduleExamples: '{workflow_path}/data/reference/agents/module-examples/'
@@ -19,8 +19,8 @@ moduleExamples: '{workflow_path}/data/reference/agents/module-examples/'
agentPurposeTemplate: '{workflow_path}/templates/agent-purpose-and-type.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 2: Discover Agent Purpose and Type
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md b/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md
index e5a5699c..e0b23168 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md
@@ -11,14 +11,14 @@ nextStepFile: '{workflow_path}/steps/step-04-commands.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-persona-{project_name}.md'
communicationPresets: '{workflow_path}/data/communication-presets.csv'
-agentMenuPatterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'
+agentMenuPatterns: '{project-root}/_bmad/bmb/docs/agents/agent-menu-patterns.md'
# Template References
personaTemplate: '{workflow_path}/templates/agent-persona.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 3: Shape Agent's Personality
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md b/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md
index e93dabef..8bcec3e0 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md
@@ -10,17 +10,17 @@ thisStepFile: '{workflow_path}/steps/step-04-commands.md'
nextStepFile: '{workflow_path}/steps/step-05-name.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-commands-{project_name}.md'
-agentMenuPatterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'
-simpleArchitecture: '{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md'
-expertArchitecture: '{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md'
-moduleArchitecture: '{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md'
+agentMenuPatterns: '{project-root}/_bmad/bmb/docs/agents/agent-menu-patterns.md'
+simpleArchitecture: '{project-root}/_bmad/bmb/docs/agents/simple-agent-architecture.md'
+expertArchitecture: '{project-root}/_bmad/bmb/docs/agents/expert-agent-architecture.md'
+moduleArchitecture: '{project-root}/_bmad/bmb/docs/agents/module-agent-architecture.md'
# Template References
commandsTemplate: '{workflow_path}/templates/agent-commands.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 4: Build Capabilities and Commands
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-05-name.md b/src/modules/bmb/workflows/create-agent/steps/step-05-name.md
index 88533ce6..58a9b3b3 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-05-name.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-05-name.md
@@ -15,8 +15,8 @@ outputFile: '{output_folder}/agent-identity-{project_name}.md'
identityTemplate: '{workflow_path}/templates/agent-identity.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 5: Agent Naming and Identity
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-06-build.md b/src/modules/bmb/workflows/create-agent/steps/step-06-build.md
index a1345c80..0de3a798 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-06-build.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-06-build.md
@@ -10,15 +10,15 @@ thisStepFile: '{workflow_path}/steps/step-06-build.md'
nextStepFile: '{workflow_path}/steps/step-07-validate.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-yaml-{project_name}.md'
-moduleOutputFile: '{project-root}/.bmad/{target_module}/agents/{agent_filename}.agent.yaml'
+moduleOutputFile: '{project-root}/_bmad/{target_module}/agents/{agent_filename}.agent.yaml'
standaloneOutputFile: '{workflow_path}/data/{agent_filename}/{agent_filename}.agent.yaml'
# Template References
completeAgentTemplate: '{workflow_path}/templates/agent-complete-{agent_type}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 6: Build Complete Agent YAML
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md b/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md
index 345294e0..f232463a 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md
@@ -10,15 +10,15 @@ thisStepFile: '{workflow_path}/steps/step-07-validate.md'
nextStepFile: '{workflow_path}/steps/step-08-setup.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-validation-{project_name}.md'
-agentValidationChecklist: '{project-root}/.bmad/bmb/workflows/create-agent/agent-validation-checklist.md'
+agentValidationChecklist: '{project-root}/_bmad/bmb/workflows/create-agent/agent-validation-checklist.md'
agentFile: '{{output_file_path}}'
# Template References
validationTemplate: '{workflow_path}/templates/validation-results.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 7: Quality Check and Validation
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md b/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md
index d060dde0..4d7c8c2a 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md
@@ -16,8 +16,8 @@ agentSidecarFolder: '{{standalone_output_folder}}/{{agent_filename}}-sidecar'
sidecarTemplate: '{workflow_path}/templates/expert-sidecar-structure.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 8: Expert Agent Workspace Setup
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md b/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md
index b6b0230f..de9370ae 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md
@@ -10,14 +10,14 @@ thisStepFile: '{workflow_path}/steps/step-09-customize.md'
nextStepFile: '{workflow_path}/steps/step-10-build-tools.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/agent-customization-{project_name}.md'
-configOutputFile: '{project-root}/.bmad/_cfg/agents/{target_module}-{agent_filename}.customize.yaml'
+configOutputFile: '{project-root}/_bmad/_cfg/agents/{target_module}-{agent_filename}.customize.yaml'
# Template References
customizationTemplate: '{workflow_path}/templates/agent-customization.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 9: Optional Customization File
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md b/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md
index 4de2e7c5..ef70b6c2 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md
@@ -17,8 +17,8 @@ compiledAgentFile: '{{output_folder}}/{{agent_filename}}.md'
buildHandlingTemplate: '{workflow_path}/templates/build-results.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 10: Build Tools Handling
diff --git a/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md b/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md
index 7809264f..c21a9576 100644
--- a/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md
@@ -16,8 +16,8 @@ compiledAgentFile: '{{compiled_agent_path}}'
completionTemplate: '{workflow_path}/templates/completion-summary.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 11: Celebration and Next Steps
diff --git a/src/modules/bmb/workflows/create-agent/workflow.md b/src/modules/bmb/workflows/create-agent/workflow.md
index 4363536d..99b77caa 100644
--- a/src/modules/bmb/workflows/create-agent/workflow.md
+++ b/src/modules/bmb/workflows/create-agent/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from `{project-root}/.bmad/bmb/config.yaml`:
+Load and read full config from `{project-root}/_bmad/bmb/config.yaml`:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
@@ -63,12 +63,12 @@ Load, read completely, then execute `steps/step-01-brainstorm.md` to begin the w
# Technical documentation for agent building
-agent_compilation: "{project-root}/.bmad/bmb/docs/agents/agent-compilation.md"
-understanding_agent_types: "{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md"
-simple_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md"
-expert_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md"
-module_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md"
-agent_menu_patterns: "{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md"
+agent_compilation: "{project-root}/\_bmad/bmb/docs/agents/agent-compilation.md"
+understanding_agent_types: "{project-root}/\_bmad/bmb/docs/agents/understanding-agent-types.md"
+simple_agent_architecture: "{project-root}/\_bmad/bmb/docs/agents/simple-agent-architecture.md"
+expert_agent_architecture: "{project-root}/\_bmad/bmb/docs/agents/expert-agent-architecture.md"
+module_agent_architecture: "{project-root}/\_bmad/bmb/docs/agents/module-agent-architecture.md"
+agent_menu_patterns: "{project-root}/\_bmad/bmb/docs/agents/agent-menu-patterns.md"
# Data and templates
@@ -83,9 +83,9 @@ module_agent_examples: "{project-root}/bmb/reference/agents/module-examples/"
# Output configuration
-custom_agent_location: "{project-root}/.bmad/custom/src/agents"
-module_output_file: "{project-root}/.bmad/{target_module}/agents/{agent_filename}.agent.yaml"
+custom_agent_location: "{project-root}/\_bmad/custom/src/agents"
+module_output_file: "{project-root}/\_bmad/{target_module}/agents/{agent_filename}.agent.yaml"
standalone_output_folder: "{custom_agent_location}/{agent_filename}"
standalone_output_file: "{standalone_output_folder}/{agent_filename}.agent.yaml"
standalone_info_guide: "{standalone_output_folder}/info-and-installation-guide.md"
-config_output_file: "{project-root}/.bmad/\_cfg/agents/{target_module}-{agent_filename}.customize.yaml"
+config_output_file: "{project-root}/\_bmad/\_cfg/agents/{target_module}-{agent_filename}.customize.yaml"
diff --git a/src/modules/bmb/workflows/create-module/steps/step-01-init.md b/src/modules/bmb/workflows/create-module/steps/step-01-init.md
index 46e3a404..88729cf9 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-01-init.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-01-init.md
@@ -2,8 +2,8 @@
nextStepFile: '{installed_path}/steps/step-02-concept.md'
continueFile: '{installed_path}/steps/step-01b-continue.md'
modulePlanTemplate: '{installed_path}/templates/module-plan.template.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
customModuleLocation: '{custom_module_location}'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
---
diff --git a/src/modules/bmb/workflows/create-module/steps/step-02-concept.md b/src/modules/bmb/workflows/create-module/steps/step-02-concept.md
index 33a131bb..3e007b5f 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-02-concept.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-02-concept.md
@@ -1,10 +1,10 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-03-components.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
moduleStructureGuide: '{project-root}/bmb/workflows/create-agent-legacy/create-module/module-structure.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 2: Define Module Concept and Scope
diff --git a/src/modules/bmb/workflows/create-module/steps/step-03-components.md b/src/modules/bmb/workflows/create-module/steps/step-03-components.md
index 14b34852..b30e8bb3 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-03-components.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-03-components.md
@@ -1,10 +1,10 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-04-structure.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
agent_examples_path: '{project-root}/bmb/reference/agents/module-examples'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 3: Plan Module Components
diff --git a/src/modules/bmb/workflows/create-module/steps/step-04-structure.md b/src/modules/bmb/workflows/create-module/steps/step-04-structure.md
index 17552469..43a3556c 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-04-structure.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-04-structure.md
@@ -1,9 +1,9 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-05-config.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 4: Create Module Structure
diff --git a/src/modules/bmb/workflows/create-module/steps/step-05-config.md b/src/modules/bmb/workflows/create-module/steps/step-05-config.md
index 71d848fa..48fa4542 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-05-config.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-05-config.md
@@ -1,9 +1,9 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-06-agents.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 5: Plan Module Configuration
@@ -185,7 +185,7 @@ Update module-plan.md with configuration section:
### Result Configuration Structure
The module.yaml will generate:
-- Module configuration at: .bmad/{module_code}/config.yaml
+- Module configuration at: _bmad/{module_code}/config.yaml
- User settings stored as: [describe structure]
````
diff --git a/src/modules/bmb/workflows/create-module/steps/step-06-agents.md b/src/modules/bmb/workflows/create-module/steps/step-06-agents.md
index 38c608ec..3cb1ce8d 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-06-agents.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-06-agents.md
@@ -1,11 +1,11 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-07-workflows.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
agentTemplate: '{installed_path}/templates/agent.template.md'
agent_examples_path: '{project-root}/bmb/reference/agents/module-examples'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 6: Create Module Agents
@@ -183,7 +183,7 @@ agent:
triggers:
- party-mode:
input: SPM
- route: '{project-root}/.bmad/core/workflows/edit-agent/workflow.md'
+ route: '{project-root}/_bmad/core/workflows/edit-agent/workflow.md'
type: exec
- expert-chat:
input: CH
@@ -204,7 +204,7 @@ agent:
# Workflow only for complex processes
- trigger: 'complex-process'
- route: '{project-root}/.bmad/{custom_module}/workflows/[workflow]/workflow.md'
+ route: '{project-root}/_bmad/{custom_module}/workflows/[workflow]/workflow.md'
description: 'Complex process [icon]'
# Quick inline actions
diff --git a/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md b/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md
index 202fa4e8..a709f385 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md
@@ -1,10 +1,10 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-08-installer.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
workflowPlanTemplate: '{installed_path}/templates/workflow-plan-template.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 7: Review Workflow Plans
diff --git a/src/modules/bmb/workflows/create-module/steps/step-08-installer.md b/src/modules/bmb/workflows/create-module/steps/step-08-installer.md
index 504e34a2..290400f0 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-08-installer.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-08-installer.md
@@ -1,11 +1,11 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-09-documentation.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
installerTemplate: '{installed_path}/templates/installer.template.js'
installConfigTemplate: '{installed_path}/templates/install-config.template.yaml'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 8: Setup Module Installer
@@ -131,7 +131,7 @@ Update module-plan.md with installer section:
1. User runs: `bmad install {module_name}`
2. Installer asks: [list of questions]
-3. Creates: .bmad/{module_name}/
+3. Creates: \_bmad/{module_name}/
4. Generates: config.yaml with user settings
### Validation
diff --git a/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md b/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md
index 77c9310e..628c9abf 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md
@@ -1,10 +1,10 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-10-roadmap.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
moduleReadmeFile: '{custom_module_location}/{module_name}/README.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 9: Create Module Documentation
@@ -140,7 +140,7 @@ bmad install {module_name}
## Configuration
-The module can be configured in `.bmad/{module_name}/config.yaml`
+The module can be configured in `_bmad/{module_name}/config.yaml`
**Key Settings:**
diff --git a/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md b/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md
index b49e4a25..bffcaeaa 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md
@@ -1,10 +1,10 @@
---
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
nextStepFile: '{installed_path}/steps/step-11-validate.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
moduleTodoFile: '{custom_module_location}/{module_name}/TODO.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 10: Generate Development Roadmap
diff --git a/src/modules/bmb/workflows/create-module/steps/step-11-validate.md b/src/modules/bmb/workflows/create-module/steps/step-11-validate.md
index 56a5dd9a..3ffda801 100644
--- a/src/modules/bmb/workflows/create-module/steps/step-11-validate.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-11-validate.md
@@ -2,8 +2,8 @@
workflowFile: '{installed_path}/workflow.md'
modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
validationChecklist: '{installed_path}/validation.md'
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 11: Validate and Finalize Module
@@ -297,8 +297,8 @@ Display: **Module Creation Complete!** [A] Advanced Elicitation [P] Party Mode [
#### Menu Handling Logic:
-- IF A: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml for reflection on process
-- IF P: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md to celebrate completion
+- IF A: Execute {project-root}/_bmad/core/tasks/advanced-elicitation.xml for reflection on process
+- IF P: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md to celebrate completion
- IF C: Mark as complete and exit gracefully
- IF Any other comments or queries: help user respond then redisplay menu
diff --git a/src/modules/bmb/workflows/create-module/templates/agent.template.md b/src/modules/bmb/workflows/create-module/templates/agent.template.md
index 45941dcd..840b0842 100644
--- a/src/modules/bmb/workflows/create-module/templates/agent.template.md
+++ b/src/modules/bmb/workflows/create-module/templates/agent.template.md
@@ -55,7 +55,7 @@ agent:
triggers:
- party-mode:
input: SPM or fuzzy match start party mode
- route: '{project-root}/.bmad/core/workflows/edit-agent/workflow.md'
+ route: '{project-root}/_bmad/core/workflows/edit-agent/workflow.md'
data: what is being discussed or suggested with the command
type: exec
- expert-chat:
@@ -83,7 +83,7 @@ agent:
# Workflow for complex processes
- trigger: 'generate-report'
- route: '{project-root}/.bmad/{custom_module}/workflows/report-gen/workflow.md'
+ route: '{project-root}/_bmad/{custom_module}/workflows/report-gen/workflow.md'
description: 'Generate detailed report 📊'
# Exec with internal prompt reference
@@ -156,7 +156,7 @@ Expert agents support three types of menu actions:
```yaml
- trigger: 'generate-report'
- route: '{project-root}/.bmad/{custom_module}/workflows/report-gen/workflow.md'
+ route: '{project-root}/_bmad/{custom_module}/workflows/report-gen/workflow.md'
description: 'Generate report 📊'
```
@@ -171,7 +171,7 @@ Expert agents support three types of menu actions:
2. **Variable Usage**:
- `{agent_sidecar_folder}` resolves to the agents sidecar folder destination after installation
- - `.bmad` resolves to .bmad
+ - `_bmad` resolves to \_bmad
- `{custom_module}` resolves to custom/src/modules
- `{module}` is your module code/name
@@ -268,7 +268,7 @@ Analyze the visual design with my signature dramatic flair
menu: # Core interactions - multi: "[CH] Chat with Caravaggio or [SPM] Start Party Mode"
triggers: - party-mode:
input: SPM or fuzzy match start party mode
-route: "{project-root}/.bmad/core/workflows/edit-agent/workflow.md"
+route: "{project-root}/\_bmad/core/workflows/edit-agent/workflow.md"
data: what's being discussed, plus custom party agents if specified
type: exec - expert-chat:
input: CH or fuzzy match validate agent
@@ -305,11 +305,11 @@ type: action
triggers:
- pitch-deck:
input: PD or fuzzy match pitch deck
- route: "{project-root}/.bmad/{custom_module}/workflows/pitch-deck/workflow.md"
+ route: "{project-root}/_bmad/{custom_module}/workflows/pitch-deck/workflow.md"
description: 'Investor pitch deck 📈'
- explainer:
input: EX or fuzzy match explainer
- route: "{project-root}/.bmad/{custom_module}/workflows/explainer/workflow.md"
+ route: "{project-root}/_bmad/{custom_module}/workflows/explainer/workflow.md"
description: 'Video explainer 🎥'
- trigger: 'save-project'
diff --git a/src/modules/bmb/workflows/create-module/templates/module.template.yaml b/src/modules/bmb/workflows/create-module/templates/module.template.yaml
index 045c73d1..501f6e20 100644
--- a/src/modules/bmb/workflows/create-module/templates/module.template.yaml
+++ b/src/modules/bmb/workflows/create-module/templates/module.template.yaml
@@ -50,4 +50,4 @@ prompt:
# STATIC path:
# data_path:
-# result: "{project-root}/.bmad/{module_name}/data"
+# result: "{project-root}/_bmad/{module_name}/data"
diff --git a/src/modules/bmb/workflows/create-module/workflow.md b/src/modules/bmb/workflows/create-module/workflow.md
index cf633945..aa46a607 100644
--- a/src/modules/bmb/workflows/create-module/workflow.md
+++ b/src/modules/bmb/workflows/create-module/workflow.md
@@ -2,7 +2,7 @@
name: create-module
description: 'Interactive workflow to build complete BMAD modules with agents, workflows, and installation infrastructure'
web_bundle: true
-installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
---
# Create Module Workflow
@@ -46,7 +46,7 @@ installed_path: '{project-root}/.bmad/bmb/workflows/create-module'
### 1. Module Configuration Loading
-Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `custom_module_location`
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md b/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md
index d0883c84..6e2641b8 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
description: 'Initialize workflow creation session by gathering project information and setting up unique workflow folder'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-01-init.md'
@@ -97,7 +97,7 @@ After getting the workflow name:
Based on the module selection, confirm the target location:
-- For bmb module: `{custom_workflow_location}` (defaults to `.bmad/custom/src/workflows`)
+- For bmb module: `{custom_workflow_location}` (defaults to `_bmad/custom/src/workflows`)
- For other modules: Check their module.yaml for custom workflow locations
- Confirm the exact folder path where the workflow will be created
- Store the confirmed path as `{targetWorkflowPath}`
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md b/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md
index 21881919..e60fc11b 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md
@@ -3,7 +3,7 @@ name: 'step-02-gather'
description: 'Gather comprehensive requirements for the workflow being created'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-02-gather.md'
@@ -13,8 +13,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
# No template needed - will append requirements directly to workflow plan
---
@@ -90,7 +90,7 @@ Let's load some examples to help you decide the workflow pattern:
Load and reference the Meal Prep & Nutrition Plan workflow as an example:
```
-Read: {project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md
+Read: {project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md
```
This shows a linear workflow structure. Now let's explore your desired pattern:
@@ -104,7 +104,7 @@ This shows a linear workflow structure. Now let's explore your desired pattern:
**Based on our reference examples:**
- **Linear**: Like Meal Prep Plan (Init → Profile → Assessment → Strategy → Shopping → Prep)
- - See: `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/`
+ - See: `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/`
- **Looping**: User Story Generator (Generate → Review → Refine → Generate more... until done)
- **Branching**: Architecture Decision (Analyze → Choose pattern → Implement based on choice)
- **Iterative**: Document Review (Load → Analyze → Suggest changes → Implement → Repeat until approved)
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md b/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md
index e672c422..013e7277 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md
@@ -3,7 +3,7 @@ name: 'step-03-tools-configuration'
description: 'Configure all required tools (core, memory, external) and installation requirements in one comprehensive step'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-03-tools-configuration.md'
@@ -13,11 +13,11 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Documentation References
-commonToolsCsv: '{project-root}/.bmad/bmb/docs/workflows/common-workflow-tools.csv'
+commonToolsCsv: '{project-root}/_bmad/bmb/docs/workflows/common-workflow-tools.csv'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
# No template needed - will append tools configuration directly to workflow plan
---
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md b/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md
index 79920988..e8ef6af2 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md
@@ -3,7 +3,7 @@ name: 'step-04-plan-review'
description: 'Review complete workflow plan (requirements + tools) and get user approval before design'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-04-plan-review.md'
@@ -14,8 +14,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
# No template needed - will append review summary directly to workflow plan
---
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md b/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md
index d072fe2a..de5d1c1b 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md
@@ -3,7 +3,7 @@ name: 'step-05-output-format-design'
description: 'Design the output format for workflows that produce documents or files'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-05-output-format-design.md'
@@ -13,8 +13,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 5: Output Format Design
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md b/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md
index 7040d19a..06af41db 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md
@@ -3,7 +3,7 @@ name: 'step-06-design'
description: 'Design the workflow structure and step sequence based on gathered requirements, tools configuration, and output format'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-06-design.md'
@@ -14,8 +14,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
# No template needed - will append design details directly to workflow plan
---
@@ -70,11 +70,11 @@ To collaboratively design the workflow structure, step sequence, and interaction
When designing, you may load these documents as needed:
-- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md` - Step file structure
-- `{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md` - Continuable init step template
-- `{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md` - Continuation step template
-- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md` - Workflow configuration
-- `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md` - Complete example
+- `{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md` - Step file structure
+- `{project-root}/_bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md` - Continuable init step template
+- `{project-root}/_bmad/bmb/docs/workflows/templates/step-1b-template.md` - Continuation step template
+- `{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md` - Workflow configuration
+- `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md` - Complete example
## WORKFLOW DESIGN PROCESS:
@@ -85,13 +85,13 @@ Let's reference our step creation documentation for best practices:
Load and reference step-file architecture guide:
```
-Read: {project-root}/.bmad/bmb/docs/workflows/templates/step-template.md
+Read: {project-root}/_bmad/bmb/docs/workflows/templates/step-template.md
```
This shows the standard structure for step files. Also reference:
```
-Read: {project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md
+Read: {project-root}/_bmad/bmb/docs/workflows/templates/step-1b-template.md
```
This shows the continuation step pattern for workflows that might take multiple sessions.
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md b/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md
index b884c8c9..42662c0f 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md
@@ -3,7 +3,7 @@ name: 'step-07-build'
description: 'Generate all workflow files based on the approved plan'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-07-build.md'
@@ -14,10 +14,10 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Template References
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-stepInitContinuableTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md'
-step1bTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+stepInitContinuableTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md'
+step1bTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-1b-template.md'
# No content templates needed - will create content as needed during build
# No build summary template needed - will append summary directly to workflow plan
---
@@ -68,11 +68,11 @@ To generate all the workflow files (workflow.md, step files, templates, and supp
## BUILD REFERENCE MATERIALS:
-- When building each step file, you must follow template `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
-- When building continuable step-01-init.md files, use template `{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md`
-- When building continuation steps, use template `{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md`
-- When building the main workflow.md file, you must follow template `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
-- Example step files from {project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
+- When building each step file, you must follow template `{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md`
+- When building continuable step-01-init.md files, use template `{project-root}/_bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md`
+- When building continuation steps, use template `{project-root}/_bmad/bmb/docs/workflows/templates/step-1b-template.md`
+- When building the main workflow.md file, you must follow template `{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md`
+- Example step files from {project-root}/\_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
## FILE GENERATION SEQUENCE:
@@ -108,7 +108,7 @@ Create the workflow folder structure in the target location:
└── [as needed]
```
-For bmb module, this will be: `.bmad/custom/src/workflows/{workflow_name}/`
+For bmb module, this will be: `_bmad/custom/src/workflows/{workflow_name}/`
For other modules, check their module.yaml for custom_workflow_location
### 3. Generate workflow.md
@@ -117,7 +117,7 @@ Load and follow {workflowTemplate}:
- Create workflow.md using template structure
- Insert workflow name and description
-- Configure all path variables ({project-root}, .bmad, {workflow_path})
+- Configure all path variables ({project-root}, \_bmad, {workflow_path})
- Set web_bundle flag to true unless user has indicated otherwise
- Define role and goal
- Include initialization path to step-01
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md b/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md
index 44611bc2..ab5e7ac3 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md
@@ -3,7 +3,7 @@ name: 'step-08-review'
description: 'Review the generated workflow and provide final validation and next steps'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-08-review.md'
@@ -14,8 +14,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
# No review template needed - will append review summary directly to workflow plan
diff --git a/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md b/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md
index f7cd05e2..9d61f8ab 100644
--- a/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md
@@ -3,7 +3,7 @@ name: 'step-09-complete'
description: 'Final completion and wrap-up of workflow creation process'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/create-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-09-complete.md'
diff --git a/src/modules/bmb/workflows/create-workflow/workflow.md b/src/modules/bmb/workflows/create-workflow/workflow.md
index 7bbcd5c2..0a6e7858 100644
--- a/src/modules/bmb/workflows/create-workflow/workflow.md
+++ b/src/modules/bmb/workflows/create-workflow/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `custom_stand_alone_location`
diff --git a/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md b/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md
index 45b7ed5a..2ecc356f 100644
--- a/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md
+++ b/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md
@@ -10,8 +10,8 @@ thisStepFile: '{workflow_path}/steps/step-01-discover-intent.md'
nextStepFile: '{workflow_path}/steps/step-02-analyze-agent.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 1: Discover Edit Intent
diff --git a/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md b/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md
index 1d3f341d..b35c1dbb 100644
--- a/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md
+++ b/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md
@@ -10,20 +10,20 @@ thisStepFile: '{workflow_path}/steps/step-02-analyze-agent.md'
nextStepFile: '{workflow_path}/steps/step-03-propose-changes.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Documentation References (load JIT based on user goals)
-understanding_agent_types: '{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md'
-agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
-simple_architecture: '{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md'
-expert_architecture: '{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md'
-module_architecture: '{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md'
-menu_patterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'
-communication_presets: '{project-root}/.bmad/bmb/workflows/create-agent/data/communication-presets.csv'
-reference_simple_agent: '{project-root}/.bmad/bmb/reference/agents/simple-examples/commit-poet.agent.yaml'
-reference_expert_agent: '{project-root}/.bmad/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml'
-validation: '{project-root}/.bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
+understanding_agent_types: '{project-root}/_bmad/bmb/docs/agents/understanding-agent-types.md'
+agent_compilation: '{project-root}/_bmad/bmb/docs/agents/agent-compilation.md'
+simple_architecture: '{project-root}/_bmad/bmb/docs/agents/simple-agent-architecture.md'
+expert_architecture: '{project-root}/_bmad/bmb/docs/agents/expert-agent-architecture.md'
+module_architecture: '{project-root}/_bmad/bmb/docs/agents/module-agent-architecture.md'
+menu_patterns: '{project-root}/_bmad/bmb/docs/agents/agent-menu-patterns.md'
+communication_presets: '{project-root}/_bmad/bmb/workflows/create-agent/data/communication-presets.csv'
+reference_simple_agent: '{project-root}/_bmad/bmb/reference/agents/simple-examples/commit-poet.agent.yaml'
+reference_expert_agent: '{project-root}/_bmad/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml'
+validation: '{project-root}/_bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
---
# Step 2: Analyze Agent
diff --git a/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md b/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md
index 6b6c17d4..815c1891 100644
--- a/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md
+++ b/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md
@@ -11,12 +11,12 @@ nextStepFile: '{workflow_path}/steps/step-04-apply-changes.md'
agentFile: '{{agent_path}}'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Documentation References (load JIT if needed)
-communication_presets: '{project-root}/.bmad/bmb/workflows/create-agent/data/communication-presets.csv'
-agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
+communication_presets: '{project-root}/_bmad/bmb/workflows/create-agent/data/communication-presets.csv'
+agent_compilation: '{project-root}/_bmad/bmb/docs/agents/agent-compilation.md'
---
# Step 3: Propose Changes
diff --git a/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md b/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md
index e6c3b8ac..64856388 100644
--- a/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md
+++ b/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md
@@ -11,8 +11,8 @@ agentFile: '{{agent_path}}'
nextStepFile: '{workflow_path}/steps/step-05-validate.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 4: Apply Changes
diff --git a/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md b/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md
index 0321d5c3..20ef1fdc 100644
--- a/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md
+++ b/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md
@@ -10,12 +10,12 @@ thisStepFile: '{workflow_path}/steps/step-05-validate.md'
agentFile: '{{agent_path}}'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Documentation References (load JIT)
-validation: '{project-root}/.bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
-agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
+validation: '{project-root}/_bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
+agent_compilation: '{project-root}/_bmad/bmb/docs/agents/agent-compilation.md'
---
# Step 5: Validate Changes
diff --git a/src/modules/bmb/workflows/edit-agent/workflow.md b/src/modules/bmb/workflows/edit-agent/workflow.md
index 6caeefa3..9cb9529c 100644
--- a/src/modules/bmb/workflows/edit-agent/workflow.md
+++ b/src/modules/bmb/workflows/edit-agent/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
diff --git a/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md b/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md
index 9f44b0f4..6fc65102 100644
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md
+++ b/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md
@@ -3,7 +3,7 @@ name: 'step-01-analyze'
description: 'Load and deeply understand the target workflow'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/edit-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-01-analyze.md'
@@ -129,9 +129,9 @@ Based on what the user wants to edit:
Load reference documentation as needed:
-- `{project-root}/.bmad/bmb/docs/workflows/architecture.md`
-- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
-- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
+- `{project-root}/_bmad/bmb/docs/workflows/architecture.md`
+- `{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md`
+- `{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md`
Check against best practices:
diff --git a/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md b/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md
index a9b9f206..e3185c8b 100644
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md
+++ b/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md
@@ -3,7 +3,7 @@ name: 'step-02-discover'
description: 'Discover improvement goals collaboratively'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/edit-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-02-discover.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
goalsTemplate: '{workflow_path}/templates/improvement-goals.md'
diff --git a/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md b/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md
index 6ed46e5f..35280213 100644
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md
+++ b/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md
@@ -3,7 +3,7 @@ name: 'step-03-improve'
description: 'Facilitate collaborative improvements to the workflow'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/edit-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-03-improve.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
improvementLogTemplate: '{workflow_path}/templates/improvement-log.md'
@@ -69,9 +69,9 @@ To facilitate collaborative improvements to the workflow, working iteratively on
Load documentation as needed for specific improvements:
-- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
-- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
-- `{project-root}/.bmad/bmb/docs/workflows/architecture.md`
+- `{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md`
+- `{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md`
+- `{project-root}/_bmad/bmb/docs/workflows/architecture.md`
### 2. Address Each Improvement Iteratively
diff --git a/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md b/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md
index 157fe11b..a2f804e4 100644
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md
+++ b/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md
@@ -3,7 +3,7 @@ name: 'step-04-validate'
description: 'Validate improvements and prepare for completion'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/edit-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-04-validate.md'
@@ -12,8 +12,8 @@ outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
nextStepFile: '{workflow_path}/steps/step-05-compliance-check.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
validationTemplate: '{workflow_path}/templates/validation-results.md'
diff --git a/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md b/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md
index cd5764fe..37e7fb90 100644
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md
+++ b/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md
@@ -3,17 +3,17 @@ name: 'step-05-compliance-check'
description: 'Run comprehensive compliance validation on the edited workflow'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/_bmad/bmb/workflows/edit-workflow'
# File References
thisStepFile: '{workflow_path}/steps/step-05-compliance-check.md'
workflowFile: '{workflow_path}/workflow.md'
editedWorkflowPath: '{target_workflow_path}'
-complianceCheckWorkflow: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md'
+complianceCheckWorkflow: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check/workflow.md'
outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
# Task References
-complianceCheckTask: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md'
+complianceCheckTask: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check/workflow.md'
---
# Step 5: Compliance Validation
diff --git a/src/modules/bmb/workflows/edit-workflow/workflow.md b/src/modules/bmb/workflows/edit-workflow/workflow.md
index 916fdb88..35f6124e 100644
--- a/src/modules/bmb/workflows/edit-workflow/workflow.md
+++ b/src/modules/bmb/workflows/edit-workflow/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md
index 01ae2622..912a554e 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md
@@ -3,7 +3,7 @@ name: 'step-01-validate-goal'
description: 'Confirm workflow path and validation goals before proceeding'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-01-validate-goal.md'
@@ -15,8 +15,8 @@ complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
---
# Step 1: Goal Confirmation and Workflow Target
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md
index dbdcc80f..24cebddc 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md
@@ -3,7 +3,7 @@ name: 'step-02-workflow-validation'
description: 'Validate workflow.md against workflow-template.md standards'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-02-workflow-validation.md'
@@ -16,8 +16,8 @@ targetWorkflowFile: '{target_workflow_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
---
# Step 2: Workflow.md Validation
@@ -132,10 +132,10 @@ For each deviation:
"**Initialization Validation:**"
-- Configuration Loading uses correct path format: `{project-root}/.bmad/[module]/config.yaml` (variable substitution pattern)
+- Configuration Loading uses correct path format: `{project-root}/_bmad/[module]/config.yaml` (variable substitution pattern)
- First step follows pattern: `step-01-init.md` OR documented deviation
- Required config variables properly listed
-- Variables use proper substitution pattern: {project-root}, .bmad, {workflow_path}, etc.
+- Variables use proper substitution pattern: {project-root}, \_bmad, {workflow_path}, etc.
For violations:
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md
index 3f74a623..d72f5886 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md
@@ -3,7 +3,7 @@ name: 'step-03-step-validation'
description: 'Validate each step file against step-template.md standards'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-03-step-validation.md'
@@ -16,8 +16,8 @@ targetWorkflowStepsPath: '{target_workflow_steps_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
---
# Step 3: Step-by-Step Validation
@@ -138,8 +138,8 @@ Check for proper references:
```yaml
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
```
**Violations to document:**
@@ -186,7 +186,7 @@ For each step:
"**Path Variable Validation:**"
-- Check format: `{project-root}/.bmad/bmb/...` vs `{project-root}/bmb/...`
+- Check format: `{project-root}/_bmad/bmb/...` vs `{project-root}/bmb/...`
- Ensure consistent variable usage across all step files
- Validate relative vs absolute path usage
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md
index ce28a763..fe3c1f3f 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md
@@ -3,7 +3,7 @@ name: 'step-04-file-validation'
description: 'Validate file sizes, markdown formatting, and CSV data files'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-04-file-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowPath: '{target_workflow_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
-csvStandards: '{project-root}/.bmad/bmb/docs/workflows/csv-data-file-standards.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+csvStandards: '{project-root}/_bmad/bmb/docs/workflows/csv-data-file-standards.md'
---
# Step 4: File Size, Formatting, and Data Validation
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md
index c4c59e91..0f53be96 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md
@@ -3,7 +3,7 @@ name: 'step-05-intent-spectrum-validation'
description: 'Dedicated analysis and validation of intent vs prescriptive spectrum positioning'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-05-intent-spectrum-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowPath: '{target_workflow_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
---
# Step 5: Intent vs Prescriptive Spectrum Validation
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md
index d2059019..1468a5bf 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md
@@ -3,7 +3,7 @@ name: 'step-06-web-subprocess-validation'
description: 'Analyze web search utilization and subprocess optimization opportunities across workflow steps'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-06-web-subprocess-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowStepsPath: '{target_workflow_steps_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
---
# Step 6: Web Search & Subprocess Optimization Analysis
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md
index f16dd264..47b366eb 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md
@@ -3,7 +3,7 @@ name: 'step-07-holistic-analysis'
description: 'Analyze workflow flow, goal alignment, and meta-workflow failures'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-07-holistic-analysis.md'
@@ -16,9 +16,9 @@ targetWorkflowFile: '{target_workflow_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
---
# Step 7: Holistic Workflow Analysis
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md
index 1439b946..bd330e7b 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md
@@ -3,7 +3,7 @@ name: 'step-08-generate-report'
description: 'Generate comprehensive compliance report with fix recommendations'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
# File References
thisStepFile: '{workflow_path}/steps/step-08-generate-report.md'
@@ -15,8 +15,8 @@ targetWorkflowFile: '{target_workflow_path}'
complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
# Documentation References
-stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
---
# Step 8: Comprehensive Compliance Report Generation
diff --git a/src/modules/bmb/workflows/workflow-compliance-check/workflow.md b/src/modules/bmb/workflows/workflow-compliance-check/workflow.md
index b4c44406..7d944650 100644
--- a/src/modules/bmb/workflows/workflow-compliance-check/workflow.md
+++ b/src/modules/bmb/workflows/workflow-compliance-check/workflow.md
@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmb/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
diff --git a/src/modules/bmgd/README.md b/src/modules/bmgd/README.md
index 2ba24400..0084d42f 100644
--- a/src/modules/bmgd/README.md
+++ b/src/modules/bmgd/README.md
@@ -136,7 +136,7 @@ bmgd/
## Configuration
-After installation, configure the module in `.bmad/bmgd/config.yaml`
+After installation, configure the module in `_bmad/bmgd/config.yaml`
Key settings:
diff --git a/src/modules/bmgd/agents/game-architect.agent.yaml b/src/modules/bmgd/agents/game-architect.agent.yaml
index 38030d40..5ef8c37b 100644
--- a/src/modules/bmgd/agents/game-architect.agent.yaml
+++ b/src/modules/bmgd/agents/game-architect.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmgd/agents/game-architect.md"
+ id: "_bmad/bmgd/agents/game-architect.md"
name: Cloud Dragonborn
title: Game Architect
icon: 🏛️
@@ -16,18 +16,18 @@ agent:
menu:
- trigger: correct-course
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
description: Course Correction Analysis
- trigger: create-architecture
- workflow: "{project-root}/.bmad/bmgd/workflows/3-technical/game-architecture/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmgd/workflows/3-technical/game-architecture/workflow.yaml"
description: Produce a Scale Adaptive Game Architecture
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
diff --git a/src/modules/bmgd/agents/game-designer.agent.yaml b/src/modules/bmgd/agents/game-designer.agent.yaml
index 672199b8..bfa60929 100644
--- a/src/modules/bmgd/agents/game-designer.agent.yaml
+++ b/src/modules/bmgd/agents/game-designer.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmgd/agents/game-designer.md"
+ id: "_bmad/bmgd/agents/game-designer.md"
name: Samus Shepard
title: Game Designer
icon: 🎲
@@ -16,25 +16,25 @@ agent:
menu:
- trigger: brainstorm-game
- workflow: "{project-root}/.bmad/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml"
description: 1. Guide me through Game Brainstorming
- trigger: create-game-brief
- workflow: "{project-root}/.bmad/bmgd/workflows/1-preproduction/game-brief/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmgd/workflows/1-preproduction/game-brief/workflow.yaml"
description: 3. Create Game Brief
- trigger: create-gdd
- workflow: "{project-root}/.bmad/bmgd/workflows/2-design/gdd/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmgd/workflows/2-design/gdd/workflow.yaml"
description: 4. Create Game Design Document (GDD)
- trigger: narrative
- workflow: "{project-root}/.bmad/bmgd/workflows/2-design/narrative/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmgd/workflows/2-design/narrative/workflow.yaml"
description: 5. Create Narrative Design Document (story-driven games)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
diff --git a/src/modules/bmgd/agents/game-dev.agent.yaml b/src/modules/bmgd/agents/game-dev.agent.yaml
index dbefb17f..33e0dc6d 100644
--- a/src/modules/bmgd/agents/game-dev.agent.yaml
+++ b/src/modules/bmgd/agents/game-dev.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmgd/agents/game-dev.md"
+ id: "_bmad/bmgd/agents/game-dev.md"
name: Link Freeman
title: Game Developer
icon: 🕹️
@@ -17,24 +17,24 @@ agent:
menu:
- trigger: dev-story
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/dev-story/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/dev-story/workflow.yaml"
description: "Execute Dev Story workflow, implementing tasks and tests, or performing updates to the story"
- trigger: code-review
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/code-review/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/code-review/workflow.yaml"
description: "Perform a thorough clean context QA code review on a story flagged Ready for Review"
- trigger: story-done
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/story-done/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/story-done/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/story-done/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/story-done/workflow.yaml"
description: "Mark story done after DoD complete"
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
diff --git a/src/modules/bmgd/agents/game-scrum-master.agent.yaml b/src/modules/bmgd/agents/game-scrum-master.agent.yaml
index 12ce3f3d..c67f72f4 100644
--- a/src/modules/bmgd/agents/game-scrum-master.agent.yaml
+++ b/src/modules/bmgd/agents/game-scrum-master.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmgd/agents/game-scrum-master.md"
+ id: "_bmad/bmgd/agents/game-scrum-master.md"
name: Max
title: Game Dev Scrum Master
icon: 🎯
@@ -19,57 +19,57 @@ agent:
menu:
- trigger: sprint-planning
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/sprint-planning/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/sprint-planning/workflow.yaml"
description: Generate or update sprint-status.yaml from epic files
- trigger: epic-tech-context
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
description: (Optional) Use the GDD and Architecture to create an Epic-Tech-Spec for a specific epic
- trigger: validate-epic-tech-context
- validate-workflow: "{project-root}/.bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
+ validate-workflow: "{project-root}/_bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
description: (Optional) Validate latest Tech Spec against checklist
- trigger: create-story-draft
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
description: Create a Story Draft for a game feature
- trigger: validate-create-story
- validate-workflow: "{project-root}/.bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
+ validate-workflow: "{project-root}/_bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
description: (Optional) Validate Story Draft with Independent Review
- trigger: story-context
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/story-context/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/story-context/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
description: (Optional) Assemble dynamic Story Context (XML) from latest docs and code and mark story ready for dev
- trigger: validate-story-context
- validate-workflow: "{project-root}/.bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
+ validate-workflow: "{project-root}/_bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
description: (Optional) Validate latest Story Context XML against checklist
- trigger: story-ready-for-dev
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/story-ready/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/story-ready/workflow.yaml"
description: (Optional) Mark drafted story ready for dev without generating Story Context
- trigger: epic-retrospective
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/retrospective/workflow.yaml"
- data: "{project-root}/.bmad/_cfg/agent-manifest.csv"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/retrospective/workflow.yaml"
+ data: "{project-root}/_bmad/_cfg/agent-manifest.csv"
description: (Optional) Facilitate team retrospective after a game development epic is completed
- trigger: correct-course
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
- workflow-install: "{project-root}/.bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+ workflow-install: "{project-root}/_bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
description: (Optional) Navigate significant changes during game dev sprint
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
diff --git a/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md b/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md
index 92110462..2523b82b 100644
--- a/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md
+++ b/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md
@@ -1,4 +1,4 @@
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language}
This is a meta-workflow that orchestrates the CIS brainstorming workflow with game-specific context and additional game design techniques
diff --git a/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml b/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml
index 9bf7c9f3..25e48c4f 100644
--- a/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml
+++ b/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml
@@ -4,7 +4,7 @@ description: "Facilitate game brainstorming sessions by orchestrating the CIS br
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
date: system-generated
# Module path and component files
-installed_path: "{project-root}/.bmad/bmgd/workflows/1-preproduction/brainstorm-game"
+installed_path: "{project-root}/_bmad/bmgd/workflows/1-preproduction/brainstorm-game"
template: false
instructions: "{installed_path}/instructions.md"
@@ -22,7 +22,7 @@ game_context: "{installed_path}/game-context.md"
game_brain_methods: "{installed_path}/game-brain-methods.csv"
# CORE brainstorming workflow to invoke
-core_brainstorming: "{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml"
+core_brainstorming: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
standalone: true
@@ -30,12 +30,12 @@ web_bundle:
name: "brainstorm-game"
description: "Facilitate game brainstorming sessions by orchestrating the CIS brainstorming workflow with game-specific context, guidance, and additional game design techniques."
author: "BMad"
- instructions: ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+ instructions: "_bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
template: false
web_bundle_files:
- - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
- - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
- - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
- - ".bmad/core/workflows/brainstorming/workflow.yaml"
+ - "_bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+ - "_bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
+ - "_bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
+ - "_bmad/core/workflows/brainstorming/workflow.yaml"
existing_workflows:
- - core_brainstorming: ".bmad/core/workflows/brainstorming/workflow.yaml"
+ - core_brainstorming: "_bmad/core/workflows/brainstorming/workflow.yaml"
diff --git a/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md b/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md
index 3a41ac28..99c0102f 100644
--- a/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md
+++ b/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md
@@ -1,6 +1,6 @@
# Game Brief - Interactive Workflow Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
diff --git a/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml b/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml
index c3d77089..2b347c43 100644
--- a/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml
+++ b/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml
@@ -4,7 +4,7 @@ description: "Interactive game brief creation workflow that guides users through
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
date: system-generated
# Module path and component files
-installed_path: "{project-root}/.bmad/bmgd/workflows/1-preproduction/game-brief"
+installed_path: "{project-root}/_bmad/bmgd/workflows/1-preproduction/game-brief"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
@@ -27,10 +27,10 @@ web_bundle:
name: "game-brief"
description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
author: "BMad"
- instructions: ".bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
- validation: ".bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
- template: ".bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
+ instructions: "_bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+ validation: "_bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+ template: "_bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
web_bundle_files:
- - ".bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
- - ".bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
- - ".bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
+ - "_bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+ - "_bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+ - "_bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
diff --git a/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md b/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md
index 5dcf6721..785cbe03 100644
--- a/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md
+++ b/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md
@@ -2,7 +2,7 @@
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
@@ -35,7 +35,7 @@ This workflow requires: game brief, and may reference market research or brownfi
-
+
mode: data
data_request: project_config
@@ -399,7 +399,7 @@ Your choice:
- {project-root}/.bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml
+ {project-root}/_bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml
Pass GDD context to narrative workflow
Exit current workflow (narrative will hand off to solutioning when done)
@@ -493,7 +493,7 @@ Which would you like to proceed with?
- {project-root}/.bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml
+ {project-root}/_bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml
Pass GDD context to narrative workflow
diff --git a/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml b/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
index cafd8458..a5b03762 100644
--- a/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
+++ b/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
@@ -4,7 +4,7 @@ description: "Game Design Document workflow for all game project levels - from s
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmgd/workflows/2-design/gdd"
+installed_path: "{project-root}/_bmad/bmgd/workflows/2-design/gdd"
instructions: "{installed_path}/instructions-gdd.md"
template: "{installed_path}/gdd-template.md"
game_types_csv: "{installed_path}/game-types.csv"
@@ -50,32 +50,32 @@ web_bundle:
name: "gdd"
description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
author: "BMad"
- instructions: ".bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+ instructions: "_bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
web_bundle_files:
- - ".bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
- - ".bmad/bmgd/workflows/2-design/gdd/gdd-template.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types.csv"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/adventure.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/card-game.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/fighting.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/horror.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/moba.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/party-game.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/racing.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/rpg.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/shooter.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/simulation.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/sports.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/strategy.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/survival.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/text-based.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
- - ".bmad/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/gdd-template.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types.csv"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/adventure.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/card-game.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/fighting.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/horror.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/moba.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/party-game.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/racing.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/rpg.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/shooter.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/simulation.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/sports.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/strategy.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/survival.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/text-based.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
+ - "_bmad/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"
diff --git a/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md b/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md
index 0dd9957c..793f5179 100644
--- a/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md
+++ b/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md
@@ -2,7 +2,7 @@
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
You MUST have already completed the GDD workflow
Communicate all responses in {communication_language}
This workflow creates detailed narrative content for story-driven games
diff --git a/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml b/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml
index 08fe482a..c9d2a087 100644
--- a/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml
+++ b/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml
@@ -4,7 +4,7 @@ description: "Narrative design workflow for story-driven games and applications.
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmgd/workflows/2-design/narrative"
+installed_path: "{project-root}/_bmad/bmgd/workflows/2-design/narrative"
instructions: "{installed_path}/instructions-narrative.md"
template: "{installed_path}/narrative-template.md"
@@ -26,7 +26,7 @@ web_bundle:
name: "narrative"
description: "Narrative design workflow for story-driven games and applications. Creates comprehensive narrative documentation including story structure, character arcs, dialogue systems, and narrative implementation guidance."
author: "BMad"
- instructions: ".bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+ instructions: "_bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
web_bundle_files:
- - ".bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
- - ".bmad/bmgd/workflows/2-design/narrative/narrative-template.md"
+ - "_bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+ - "_bmad/bmgd/workflows/2-design/narrative/narrative-template.md"
diff --git a/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md b/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md
index 766b2323..1cde1f3b 100644
--- a/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md
+++ b/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md
@@ -2,7 +2,7 @@
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
This workflow uses ADAPTIVE FACILITATION - adjust your communication style based on {user_skill_level}
The goal is ARCHITECTURAL DECISIONS that prevent AI agent conflicts, not detailed implementation specs
diff --git a/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml b/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml
index 2887f9b7..13a2fd82 100644
--- a/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml
+++ b/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml
@@ -4,7 +4,7 @@ description: "Collaborative game architecture workflow for AI-agent consistency.
author: "BMad"
# Critical variables
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -39,7 +39,7 @@ input_file_patterns:
load_strategy: "INDEX_GUIDED"
# Module path and component files
-installed_path: "{project-root}/.bmad/bmgd/workflows/3-technical/game-architecture"
+installed_path: "{project-root}/_bmad/bmgd/workflows/3-technical/game-architecture"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/architecture-template.md"
diff --git a/src/modules/bmgd/workflows/4-production/code-review/instructions.md b/src/modules/bmgd/workflows/4-production/code-review/instructions.md
index 9ed99b99..7d2d420e 100644
--- a/src/modules/bmgd/workflows/4-production/code-review/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/code-review/instructions.md
@@ -1,7 +1,7 @@
# Senior Developer Review - Workflow Instructions
````xml
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
@@ -354,7 +354,7 @@ Review was saved to story file, but sprint-status.yaml may be out of sync.
- Run validation checklist at {installed_path}/checklist.md using {project-root}/.bmad/core/tasks/validate-workflow.xml
+ Run validation checklist at {installed_path}/checklist.md using {project-root}/_bmad/core/tasks/validate-workflow.xml
Report workflow completion.
diff --git a/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml b/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml
index 52b9d724..f2f2889c 100644
--- a/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml
@@ -4,7 +4,7 @@ description: "Perform a Senior Developer code review on a completed story flagge
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -15,7 +15,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: false
diff --git a/src/modules/bmgd/workflows/4-production/correct-course/checklist.md b/src/modules/bmgd/workflows/4-production/correct-course/checklist.md
index 7fb6dc06..76d4a827 100644
--- a/src/modules/bmgd/workflows/4-production/correct-course/checklist.md
+++ b/src/modules/bmgd/workflows/4-production/correct-course/checklist.md
@@ -1,6 +1,6 @@
# Change Navigation Checklist
-This checklist is executed as part of: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
+This checklist is executed as part of: {project-root}/\_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
Work through each section systematically with the user, recording findings and impacts
diff --git a/src/modules/bmgd/workflows/4-production/correct-course/instructions.md b/src/modules/bmgd/workflows/4-production/correct-course/instructions.md
index 738aeea9..95a7ea51 100644
--- a/src/modules/bmgd/workflows/4-production/correct-course/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/correct-course/instructions.md
@@ -1,7 +1,7 @@
# Correct Course - Sprint Change Management Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
diff --git a/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml b/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml
index 5fc6fab7..d0df9c52 100644
--- a/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml
@@ -3,7 +3,7 @@ name: "correct-course"
description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation"
author: "BMad Method"
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -46,7 +46,7 @@ input_file_patterns:
sharded: "{output_folder}/index.md"
load_strategy: "INDEX_GUIDED"
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course"
template: false
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/create-story/instructions.md b/src/modules/bmgd/workflows/4-production/create-story/instructions.md
index 301ac3ab..6f902721 100644
--- a/src/modules/bmgd/workflows/4-production/create-story/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/create-story/instructions.md
@@ -1,7 +1,7 @@
# Create Story - Workflow Instructions (Spec-compliant, non-interactive by default)
````xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Generate all documents in {document_output_language}
This workflow creates or updates the next user story from epics/PRD and architecture context, saving to the configured stories directory and optionally invoking Story Context.
@@ -213,7 +213,7 @@ Will update existing story file rather than creating new one.
- Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml
+ Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml
Save document unconditionally (non-interactive default). In interactive mode, allow user confirmation.
diff --git a/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml b/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml
index fe358a8f..0ac85080 100644
--- a/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml
@@ -3,7 +3,7 @@ description: "Create the next user story markdown from epics/PRD and architectur
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
story_dir: "{sprint_artifacts}"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/create-story"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/dev-story/instructions.md b/src/modules/bmgd/workflows/4-production/dev-story/instructions.md
index 5ae08134..def6695f 100644
--- a/src/modules/bmgd/workflows/4-production/dev-story/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/dev-story/instructions.md
@@ -1,7 +1,7 @@
# Develop Story - Workflow Instructions
```xml
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
@@ -232,7 +232,7 @@ Story is marked Ready for Review in file, but sprint-status.yaml may be out of s
- Optionally run the workflow validation task against the story using {project-root}/.bmad/core/tasks/validate-workflow.xml
+ Optionally run the workflow validation task against the story using {project-root}/_bmad/core/tasks/validate-workflow.xml
Prepare a concise summary in Dev Agent Record → Completion Notes
Communicate to {user_name} that story implementation is complete and ready for review
diff --git a/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml b/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml
index 07beb9a8..9e903ab2 100644
--- a/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml
@@ -3,7 +3,7 @@ description: "Execute a story by implementing tasks/subtasks, writing tests, val
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -49,7 +49,7 @@ input_file_patterns:
load_strategy: "INDEX_GUIDED"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/dev-story"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md b/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md
index 72436218..3cfacafe 100644
--- a/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md
+++ b/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md
@@ -1,7 +1,7 @@
# Tech Spec Validation Checklist
```xml
-
+
- Overview clearly ties to PRD goals
- Scope explicitly lists in-scope and out-of-scope
- Design lists all services/modules with responsibilities
diff --git a/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md b/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md
index 46fdfe1e..14047b38 100644
--- a/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md
@@ -1,7 +1,7 @@
```xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language}
This workflow generates a comprehensive Technical Specification from PRD and Architecture, including detailed design, NFRs, acceptance criteria, and traceability mapping.
@@ -132,7 +132,7 @@ Continuing to regenerate tech spec...
- Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml
+ Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml
Load the FULL file: {sprint_status}
diff --git a/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml b/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml
index 764bfabe..cf3df9ea 100644
--- a/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml
@@ -3,7 +3,7 @@ description: "Generate a comprehensive Technical Specification from PRD and Arch
author: "BMAD BMM"
# Critical variables
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -47,7 +47,7 @@ input_file_patterns:
load_strategy: "INDEX_GUIDED"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/epic-tech-context"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/epic-tech-context"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/retrospective/instructions.md b/src/modules/bmgd/workflows/4-production/retrospective/instructions.md
index 67074fa4..c0e4c866 100644
--- a/src/modules/bmgd/workflows/4-production/retrospective/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/retrospective/instructions.md
@@ -1,7 +1,7 @@
# Retrospective - Epic Completion Review Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
diff --git a/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml b/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml
index 9f1066d9..65a6f733 100644
--- a/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml
@@ -3,7 +3,7 @@ name: "retrospective"
description: "Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic"
author: "BMad"
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,12 +12,12 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
sprint_artifacts: "{config_source}:sprint_artifacts"
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/retrospective"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/retrospective"
template: false
instructions: "{installed_path}/instructions.md"
required_inputs:
- - agent_manifest: "{project-root}/.bmad/_cfg/agent-manifest.csv"
+ - agent_manifest: "{project-root}/_bmad/_cfg/agent-manifest.csv"
# Smart input file references - handles both whole docs and sharded docs
# Priority: Whole document first, then sharded version
diff --git a/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md b/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md
index f6e95ee7..438ed45e 100644
--- a/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md
@@ -1,7 +1,7 @@
# Sprint Planning - Sprint Status Generator
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
## 📚 Document Discovery - Full Epic Loading
diff --git a/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml b/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml
index 0cd4ad4a..1ce6c8af 100644
--- a/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml
@@ -3,7 +3,7 @@ description: "Generate and manage the sprint status tracking file for Phase 4 im
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -11,7 +11,7 @@ date: system-generated
sprint_artifacts: "{config_source}:sprint_artifacts"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning"
instructions: "{installed_path}/instructions.md"
template: "{installed_path}/sprint-status-template.yaml"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/story-context/checklist.md b/src/modules/bmgd/workflows/4-production/story-context/checklist.md
index f73f86df..82e1128d 100644
--- a/src/modules/bmgd/workflows/4-production/story-context/checklist.md
+++ b/src/modules/bmgd/workflows/4-production/story-context/checklist.md
@@ -1,7 +1,7 @@
# Story Context Assembly Checklist
```xml
-
+
- Story fields (asA/iWant/soThat) captured
- Acceptance criteria list matches story draft exactly (no invention)
- Tasks/subtasks captured as task list
diff --git a/src/modules/bmgd/workflows/4-production/story-context/context-template.xml b/src/modules/bmgd/workflows/4-production/story-context/context-template.xml
index 3a099458..6d61a6b8 100644
--- a/src/modules/bmgd/workflows/4-production/story-context/context-template.xml
+++ b/src/modules/bmgd/workflows/4-production/story-context/context-template.xml
@@ -1,4 +1,4 @@
-
+
{{epic_id}}
{{story_id}}
@@ -31,4 +31,4 @@
{{test_locations}}
{{test_ideas}}
-
+
\ No newline at end of file
diff --git a/src/modules/bmgd/workflows/4-production/story-context/instructions.md b/src/modules/bmgd/workflows/4-production/story-context/instructions.md
index 7c3b3132..f414e541 100644
--- a/src/modules/bmgd/workflows/4-production/story-context/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/story-context/instructions.md
@@ -1,7 +1,7 @@
```xml
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language}
Generate all documents in {document_output_language}
@@ -156,7 +156,7 @@
Validate output context file structure and content
- Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml
+ Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml
diff --git a/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml b/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml
index 69979931..cbb18719 100644
--- a/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml
@@ -4,7 +4,7 @@ description: "Assemble a dynamic Story Context XML by pulling latest documentati
author: "BMad"
# Critical variables
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -15,7 +15,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/story-context"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/story-context"
template: "{installed_path}/context-template.xml"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmgd/workflows/4-production/story-done/instructions.md b/src/modules/bmgd/workflows/4-production/story-done/instructions.md
index 61b795a2..c843116f 100644
--- a/src/modules/bmgd/workflows/4-production/story-done/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/story-done/instructions.md
@@ -1,6 +1,6 @@
# Story Approved Workflow Instructions (DEV Agent)
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language}
diff --git a/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml b/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml
index 09258368..6071fe35 100644
--- a/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml
@@ -4,7 +4,7 @@ description: "Marks a story as done (DoD complete) and moves it from its current
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/story-done"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/story-done"
instructions: "{installed_path}/instructions.md"
# Variables and inputs
diff --git a/src/modules/bmgd/workflows/4-production/story-ready/instructions.md b/src/modules/bmgd/workflows/4-production/story-ready/instructions.md
index a4389f22..3e5afe70 100644
--- a/src/modules/bmgd/workflows/4-production/story-ready/instructions.md
+++ b/src/modules/bmgd/workflows/4-production/story-ready/instructions.md
@@ -1,6 +1,6 @@
# Story Ready Workflow Instructions (SM Agent)
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
diff --git a/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml b/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml
index f5225caa..eb5a01c6 100644
--- a/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml
+++ b/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml
@@ -4,7 +4,7 @@ description: "Marks a drafted story as ready for development and moves it from T
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmgd/config.yaml"
+config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/story-ready"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/story-ready"
instructions: "{installed_path}/instructions.md"
# Variables and inputs
diff --git a/src/modules/bmm/agents/analyst.agent.yaml b/src/modules/bmm/agents/analyst.agent.yaml
index a3ec0164..3dd44383 100644
--- a/src/modules/bmm/agents/analyst.agent.yaml
+++ b/src/modules/bmm/agents/analyst.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/analyst.md"
+ id: "_bmad/bmm/agents/analyst.md"
name: Mary
title: Business Analyst
icon: 📊
@@ -19,31 +19,31 @@ agent:
menu:
- trigger: workflow-status
- workflow: "{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml"
description: Get workflow status or initialize a workflow if not already done (optional)
- trigger: brainstorm-project
- exec: "{project-root}/.bmad/core/workflows/brainstorming/workflow.md"
- data: "{project-root}/.bmad/bmm/data/project-context-template.md"
+ exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
+ data: "{project-root}/_bmad/bmm/data/project-context-template.md"
description: Guided Project Brainstorming session with final report (optional)
- trigger: research
- exec: "{project-root}/.bmad/bmm/workflows/1-analysis/research/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
description: Guided Research scoped to market, domain, competitive analysis, or technical research (optional)
- trigger: product-brief
- exec: "{project-root}/.bmad/bmm/workflows/1-analysis/product-brief/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/1-analysis/product-brief/workflow.md"
description: Create a Product Brief (recommended input for PRD)
- trigger: document-project
- workflow: "{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
description: Document your existing project (optional, but recommended for existing brownfield project efforts)
- multi: "[SPM] Start Party Mode (optionally suggest attendees and topic), [CH] Chat"
triggers:
- party-mode:
- input: SPM or fuzzy match start party mode
- - route: "{project-root}/.bmad/core/workflows/edit-agent/workflow.md"
+ - route: "{project-root}/_bmad/core/workflows/edit-agent/workflow.md"
- data: what is being discussed or suggested with the command, along with custom party custom agents if specified
- type: exec
- expert-chat:
diff --git a/src/modules/bmm/agents/architect.agent.yaml b/src/modules/bmm/agents/architect.agent.yaml
index 48fa9161..351665bb 100644
--- a/src/modules/bmm/agents/architect.agent.yaml
+++ b/src/modules/bmm/agents/architect.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/architect.md"
+ id: "_bmad/bmm/agents/architect.md"
name: Winston
title: Architect
icon: 🏗️
@@ -19,30 +19,30 @@ agent:
menu:
- trigger: workflow-status
- workflow: "{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml"
description: Get workflow status or initialize a workflow if not already done (optional)
- trigger: create-architecture
- exec: "{project-root}/.bmad/bmm/workflows/3-solutioning/architecture/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/architecture/workflow.md"
description: Create an Architecture Document to Guide Development of a PRD (required for BMad Method projects)
- trigger: implementation-readiness
- exec: "{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.md"
description: Validate PRD, UX, Architecture, Epics and stories aligned (Optional but recommended before development)
- trigger: create-excalidraw-diagram
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-diagram/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-diagram/workflow.yaml"
description: Create system architecture or technical diagram (Excalidraw) (Use any time you need a diagram)
- trigger: create-excalidraw-dataflow
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-dataflow/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-dataflow/workflow.yaml"
description: Create data flow diagram (Excalidraw) (Use any time you need a diagram)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/agents/dev.agent.yaml b/src/modules/bmm/agents/dev.agent.yaml
index 1b2b6637..a3e8af8e 100644
--- a/src/modules/bmm/agents/dev.agent.yaml
+++ b/src/modules/bmm/agents/dev.agent.yaml
@@ -3,7 +3,7 @@
agent:
webskip: true
metadata:
- id: ".bmad/bmm/agents/dev.md"
+ id: "_bmad/bmm/agents/dev.md"
name: Amelia
title: Developer Agent
icon: 💻
@@ -36,9 +36,9 @@ agent:
menu:
- trigger: dev-story
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
description: "Execute Dev Story workflow (full BMM path with sprint-status)"
- trigger: code-review
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
description: "Perform a thorough clean context code review (Highly Recommended, use fresh context and different LLM)"
diff --git a/src/modules/bmm/agents/pm.agent.yaml b/src/modules/bmm/agents/pm.agent.yaml
index 610531d8..794a324f 100644
--- a/src/modules/bmm/agents/pm.agent.yaml
+++ b/src/modules/bmm/agents/pm.agent.yaml
@@ -3,7 +3,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/pm.md"
+ id: "_bmad/bmm/agents/pm.md"
name: John
title: Product Manager
icon: 📋
@@ -20,31 +20,31 @@ agent:
menu:
- trigger: workflow-status
- workflow: "{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml"
description: Get workflow status or initialize a workflow if not already done (optional)
- trigger: create-prd
- exec: "{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
description: Create Product Requirements Document (PRD) (Required for BMad Method flow)
- trigger: create-epics-and-stories
- exec: "{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
description: Create Epics and User Stories from PRD (Required for BMad Method flow AFTER the Architecture is completed)
- trigger: implementation-readiness
- exec: "{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.md"
description: Validate PRD, UX, Architecture, Epics and stories aligned (Optional but recommended before development)
- trigger: correct-course
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
description: Course Correction Analysis (optional during implementation when things go off track)
ide-only: true
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml b/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml
index 5b893fec..1a49a8be 100644
--- a/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml
+++ b/src/modules/bmm/agents/quick-flow-solo-dev.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/quick-flow-solo-dev.md"
+ id: "_bmad/bmm/agents/quick-flow-solo-dev.md"
name: Barry
title: Quick Flow Solo Dev
icon: 🚀
@@ -20,17 +20,17 @@ agent:
menu:
- trigger: create-tech-spec
- workflow: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml"
description: Architect a technical spec with implementation-ready stories (Required first step)
- trigger: quick-dev
- workflow: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml"
description: Implement the tech spec end-to-end solo (Core of Quick Flow)
- trigger: code-review
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
description: Review code and improve it (Highly Recommended, use fresh context and different LLM for best results)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring in other experts when I need specialized backup
diff --git a/src/modules/bmm/agents/sm.agent.yaml b/src/modules/bmm/agents/sm.agent.yaml
index 426b9866..a43f355f 100644
--- a/src/modules/bmm/agents/sm.agent.yaml
+++ b/src/modules/bmm/agents/sm.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/sm.md"
+ id: "_bmad/bmm/agents/sm.md"
name: Bob
title: Scrum Master
icon: 🏃
@@ -25,31 +25,31 @@ agent:
menu:
- trigger: sprint-planning
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
description: Generate or re-generate sprint-status.yaml from epic files (Required after Epics+Stories are created)
- trigger: create-story
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
description: Create Story (Required to prepare stories for development)
- trigger: validate-create-story
- validate-workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
+ validate-workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
description: Validate Story (Highly Recommended, use fresh context and different LLM for best results)
- trigger: epic-retrospective
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
- data: "{project-root}/.bmad/_cfg/agent-manifest.csv"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
+ data: "{project-root}/_bmad/_cfg/agent-manifest.csv"
description: Facilitate team retrospective after an epic is completed (Optional)
- trigger: correct-course
- workflow: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
description: Execute correct-course task (When implementation is off-track)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/agents/tea.agent.yaml b/src/modules/bmm/agents/tea.agent.yaml
index 12420629..e5b3d7ce 100644
--- a/src/modules/bmm/agents/tea.agent.yaml
+++ b/src/modules/bmm/agents/tea.agent.yaml
@@ -3,7 +3,7 @@
agent:
webskip: true
metadata:
- id: ".bmad/bmm/agents/tea.md"
+ id: "_bmad/bmm/agents/tea.md"
name: Murat
title: Master Test Architect
icon: 🧪
@@ -22,49 +22,49 @@ agent:
- Calculate risk vs value for every testing decision
critical_actions:
- - "Consult {project-root}/.bmad/bmm/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/bmm/testarch/knowledge/ before giving recommendations"
+ - "Consult {project-root}/_bmad/bmm/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/bmm/testarch/knowledge/ before giving recommendations"
- "Cross-check recommendations with the current official Playwright, Cypress, Pact, and CI platform documentation"
- "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
menu:
- trigger: framework
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/framework/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/framework/workflow.yaml"
description: Initialize production-ready test framework architecture
- trigger: atdd
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/atdd/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/atdd/workflow.yaml"
description: Generate E2E tests first, before starting implementation
- trigger: automate
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/automate/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/automate/workflow.yaml"
description: Generate comprehensive test automation
- trigger: test-design
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/test-design/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
description: Create comprehensive test scenarios
- trigger: trace
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/trace/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/trace/workflow.yaml"
description: Map requirements to tests (Phase 1) and make quality gate decision (Phase 2)
- trigger: nfr-assess
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml"
description: Validate non-functional requirements
- trigger: ci
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/ci/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/ci/workflow.yaml"
description: Scaffold CI/CD quality pipeline
- trigger: test-review
- workflow: "{project-root}/.bmad/bmm/workflows/testarch/test-review/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-review/workflow.yaml"
description: Review test quality using comprehensive knowledge base and best practices
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/agents/tech-writer.agent.yaml b/src/modules/bmm/agents/tech-writer.agent.yaml
index e0a62870..bea55d4d 100644
--- a/src/modules/bmm/agents/tech-writer.agent.yaml
+++ b/src/modules/bmm/agents/tech-writer.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/tech-writer.md"
+ id: "_bmad/bmm/agents/tech-writer.md"
name: Paige
title: Technical Writer
icon: 📚
@@ -17,12 +17,12 @@ agent:
- Docs are living artifacts that evolve with code. Know when to simplify vs when to be detailed.
critical_actions:
- - "CRITICAL: Load COMPLETE file {project-root}/.bmad/bmm/data/documentation-standards.md into permanent memory and follow ALL rules within"
+ - "CRITICAL: Load COMPLETE file {project-root}/_bmad/bmm/data/documentation-standards.md into permanent memory and follow ALL rules within"
- "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
menu:
- trigger: document-project
- workflow: "{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
description: Comprehensive project documentation (brownfield analysis, architecture scanning)
- trigger: generate-mermaid
@@ -30,15 +30,15 @@ agent:
description: Generate Mermaid diagrams (architecture, sequence, flow, ER, class, state)
- trigger: create-excalidraw-flowchart
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-flowchart/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-flowchart/workflow.yaml"
description: Create Excalidraw flowchart for processes and logic flows
- trigger: create-excalidraw-diagram
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-diagram/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-diagram/workflow.yaml"
description: Create Excalidraw system architecture or technical diagram
- trigger: create-excalidraw-dataflow
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-dataflow/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-dataflow/workflow.yaml"
description: Create Excalidraw data flow diagram
- trigger: validate-doc
@@ -54,14 +54,14 @@ agent:
description: Create clear technical explanations with examples
- trigger: standards-guide
- action: "Display the complete documentation standards from {project-root}/.bmadbmm/data/documentation-standards.md in a clear, formatted way for the user."
+ action: "Display the complete documentation standards from {project-root}/_bmadbmm/data/documentation-standards.md in a clear, formatted way for the user."
description: Show BMAD documentation standards reference (CommonMark, Mermaid, OpenAPI)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/agents/ux-designer.agent.yaml b/src/modules/bmm/agents/ux-designer.agent.yaml
index c1fd228f..80ac6ddf 100644
--- a/src/modules/bmm/agents/ux-designer.agent.yaml
+++ b/src/modules/bmm/agents/ux-designer.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/bmm/agents/ux-designer.md"
+ id: "_bmad/bmm/agents/ux-designer.md"
name: Sally
title: UX Designer
icon: 🎨
@@ -24,22 +24,22 @@ agent:
menu:
- trigger: create-ux-design
- exec: "{project-root}/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
+ exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
description: Generate a UX Design and UI Plan from a PRD (Recommended before creating Architecture)
- trigger: validate-design
- validate-workflow: "{project-root}/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml"
+ validate-workflow: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml"
description: Validate UX Specification and Design Artifacts
- trigger: create-excalidraw-wireframe
- workflow: "{project-root}/.bmad/bmm/workflows/diagrams/create-wireframe/workflow.yaml"
+ workflow: "{project-root}/_bmad/bmm/workflows/diagrams/create-wireframe/workflow.yaml"
description: Create website or app wireframe (Excalidraw)
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Bring the whole team in to chat with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/bmm/docs/agents-guide.md b/src/modules/bmm/docs/agents-guide.md
index 89b8592d..ce6d0923 100644
--- a/src/modules/bmm/docs/agents-guide.md
+++ b/src/modules/bmm/docs/agents-guide.md
@@ -663,14 +663,14 @@ You can customize any agent's personality without modifying core agent files.
### Location
-**Customization Directory:** `{project-root}/.bmad/_cfg/agents/`
+**Customization Directory:** `{project-root}/_bmad/_cfg/agents/`
**Naming Convention:** `{module}-{agent-name}.customize.yaml`
**Examples:**
```
-.bmad/_cfg/agents/
+_bmad/_cfg/agents/
├── bmm-pm.customize.yaml
├── bmm-dev.customize.yaml
├── cis-storyteller.customize.yaml
@@ -770,9 +770,9 @@ Other agents collaborate with PM's specialized perspective.
```bash
# Create customization file at:
-# {project-root}/.bmad/_cfg/agents/{module}-{agent-name}.customize.yaml
+# {project-root}/_bmad/_cfg/agents/{module}-{agent-name}.customize.yaml
-# Example: .bmad/_cfg/agents/bmm-pm.customize.yaml
+# Example: _bmad/_cfg/agents/bmm-pm.customize.yaml
```
**Step 2: Regenerate Agent Manifest**
diff --git a/src/modules/bmm/docs/brownfield-guide.md b/src/modules/bmm/docs/brownfield-guide.md
index 9cb50760..6f6f661c 100644
--- a/src/modules/bmm/docs/brownfield-guide.md
+++ b/src/modules/bmm/docs/brownfield-guide.md
@@ -137,7 +137,7 @@ If you have documentation but files are huge (>500 lines, 10+ level 2 sections):
```bash
# Load BMad Master or any agent
- .bmad/core/tools/shard-doc.xml --input docs/massive-doc.md
+ _bmad/core/tools/shard-doc.xml --input docs/massive-doc.md
```
- Splits on level 2 sections by default
@@ -147,7 +147,7 @@ If you have documentation but files are huge (>500 lines, 10+ level 2 sections):
2. **Then:** Run `index-docs` task to create navigation:
```bash
- .bmad/core/tasks/index-docs.xml --directory ./docs
+ _bmad/core/tasks/index-docs.xml --directory ./docs
```
3. **Finally:** Validate quality - if sharded docs still seem incomplete/outdated → Run `document-project`
@@ -210,7 +210,7 @@ If you have **good, current documentation** but it's in massive files:
```bash
# For each massive doc (>500 lines or 10+ level 2 sections)
-.bmad/core/tools/shard-doc.xml \
+_bmad/core/tools/shard-doc.xml \
--input docs/api-documentation.md \
--output docs/api/ \
--level 2 # Split on ## headers (default)
@@ -219,7 +219,7 @@ If you have **good, current documentation** but it's in massive files:
**Step 2: Generate index**
```bash
-.bmad/core/tasks/index-docs.xml --directory ./docs
+_bmad/core/tasks/index-docs.xml --directory ./docs
```
**Step 3: Validate**
diff --git a/src/modules/bmm/docs/enterprise-agentic-development.md b/src/modules/bmm/docs/enterprise-agentic-development.md
index 17375817..ca2e5388 100644
--- a/src/modules/bmm/docs/enterprise-agentic-development.md
+++ b/src/modules/bmm/docs/enterprise-agentic-development.md
@@ -425,7 +425,7 @@ Team C (2 devs): Analytics feature (3 epics)
**Problem:** Teams customize BMad (agents, workflows, configs) but don't want personal tooling in main repo.
-**Anti-pattern:** Adding `.bmad/` to `.gitignore` breaks IDE tools, submodule management.
+**Anti-pattern:** Adding `_bmad/` to `.gitignore` breaks IDE tools, submodule management.
### The Solution: Git Submodules
@@ -463,7 +463,7 @@ git commit -m "Add BMM as submodule"
git clone https://github.com/your-org/your-project.git
cd your-project
git submodule update --init --recursive
-# Make personal customizations in .bmad/
+# Make personal customizations in _bmad/
```
### Daily Workflow
@@ -472,7 +472,7 @@ git submodule update --init --recursive
```bash
cd /path/to/your-project
-# BMad available at ./.bmad/, load agents normally
+# BMad available at ./_bmad/, load agents normally
```
**Update personal config:**
diff --git a/src/modules/bmm/docs/faq.md b/src/modules/bmm/docs/faq.md
index 53539c5f..0f1298fb 100644
--- a/src/modules/bmm/docs/faq.md
+++ b/src/modules/bmm/docs/faq.md
@@ -358,7 +358,7 @@ See [IDE Setup Guides](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/do
### Q: Can I customize agents?
-**A:** Yes! Agents are installed as markdown files with XML-style content (optimized for LLMs, readable by any model). Create customization files in `.bmad/_cfg/agents/[agent-name].customize.yaml` to override default behaviors while keeping core functionality intact. See agent documentation for customization options.
+**A:** Yes! Agents are installed as markdown files with XML-style content (optimized for LLMs, readable by any model). Create customization files in `_bmad/_cfg/agents/[agent-name].customize.yaml` to override default behaviors while keeping core functionality intact. See agent documentation for customization options.
**Note:** While source agents in this repo are YAML, they install as `.md` files with XML-style tags - a format any LLM can read and follow.
diff --git a/src/modules/bmm/docs/party-mode.md b/src/modules/bmm/docs/party-mode.md
index 277c4981..613bf360 100644
--- a/src/modules/bmm/docs/party-mode.md
+++ b/src/modules/bmm/docs/party-mode.md
@@ -27,7 +27,7 @@ Type `/bmad:core:workflows:party-mode` (or `*party-mode` from any agent), and su
**The basics:**
-1. Party mode reads `.bmad/_cfg/agent-manifest.csv`
+1. Party mode reads `_bmad/_cfg/agent-manifest.csv`
2. Loads ALL installed agents (already includes your customizations from install)
3. BMad Master orchestrates - picks 2-3 relevant agents per message based on topic
4. Agents respond in character, can agree/disagree/build on each other's ideas
@@ -126,11 +126,11 @@ _(Multiple perspectives reveal the right answer)_
## Agent Customization
-Party mode uses agents from `.bmad/[module]/agents/*.md` - these already include any customizations you applied during install.
+Party mode uses agents from `_bmad/[module]/agents/*.md` - these already include any customizations you applied during install.
**To customize agents for party mode:**
-1. Create customization file: `.bmad/_cfg/agents/bmm-pm.customize.yaml`
+1. Create customization file: `_bmad/_cfg/agents/bmm-pm.customize.yaml`
2. Run `npx bmad-method install` to rebuild agents
3. Customizations now active in party mode
diff --git a/src/modules/bmm/docs/quick-flow-solo-dev.md b/src/modules/bmm/docs/quick-flow-solo-dev.md
index 62244f8e..8ca538d0 100644
--- a/src/modules/bmm/docs/quick-flow-solo-dev.md
+++ b/src/modules/bmm/docs/quick-flow-solo-dev.md
@@ -1,6 +1,6 @@
# Quick Flow Solo Dev Agent (Barry)
-**Agent ID:** `.bmad/bmm/agents/quick-flow-solo-dev.md`
+**Agent ID:** `_bmad/bmm/agents/quick-flow-solo-dev.md`
**Icon:** 🚀
**Module:** BMM
@@ -36,25 +36,25 @@ Barry owns the entire BMAD Quick Flow path, providing a streamlined 3-step devel
### 1. **create-tech-spec**
-- **Workflow:** `.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml`
+- **Workflow:** `_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml`
- **Description:** Architect a technical spec with implementation-ready stories
- **Use when:** You need to transform requirements into a buildable spec
### 2. **quick-dev**
-- **Workflow:** `.bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml`
+- **Workflow:** `_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml`
- **Description:** Ship features from spec or direct instructions - no handoffs
- **Use when:** You're ready to ship code based on a spec or clear instructions
### 3. **code-review**
-- **Workflow:** `.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml`
+- **Workflow:** `_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml`
- **Description:** Review code for quality, patterns, and acceptance criteria
- **Use when:** You need to validate implementation quality
### 4. **party-mode**
-- **Workflow:** `.bmad/core/workflows/party-mode/workflow.yaml`
+- **Workflow:** `_bmad/core/workflows/party-mode/workflow.yaml`
- **Description:** Bring in other experts when I need specialized backup
- **Use when:** You need collaborative problem-solving or specialized expertise
diff --git a/src/modules/bmm/docs/quick-start.md b/src/modules/bmm/docs/quick-start.md
index 193c1bc3..93e1774b 100644
--- a/src/modules/bmm/docs/quick-start.md
+++ b/src/modules/bmm/docs/quick-start.md
@@ -35,7 +35,7 @@ _Complete visual flowchart showing all phases, workflows, agents (color-coded),
npx bmad-method@alpha install
```
-The interactive installer will guide you through setup and create a `.bmad/` folder with all agents and workflows.
+The interactive installer will guide you through setup and create a `_bmad/` folder with all agents and workflows.
---
diff --git a/src/modules/bmm/docs/test-architecture.md b/src/modules/bmm/docs/test-architecture.md
index 49fdba5f..ff098fad 100644
--- a/src/modules/bmm/docs/test-architecture.md
+++ b/src/modules/bmm/docs/test-architecture.md
@@ -406,7 +406,7 @@ MCP provides additional capabilities on top of TEA's default AI-based approach:
}
```
-**To disable**: Set `tea_use_mcp_enhancements: false` in `.bmad/bmm/config.yaml` OR remove MCPs from IDE config.
+**To disable**: Set `tea_use_mcp_enhancements: false` in `_bmad/bmm/config.yaml` OR remove MCPs from IDE config.
@@ -448,9 +448,9 @@ Provides fixture-based utilities that integrate into TEA's test generation and r
**Utilities available** (11 total): api-request, network-recorder, auth-session, intercept-network-call, recurse, log, file-utils, burn-in, network-error-monitor, fixtures-composition
-**Enable during BMAD installation** by answering "Yes" when prompted, or manually set `tea_use_playwright_utils: true` in `.bmad/bmm/config.yaml`.
+**Enable during BMAD installation** by answering "Yes" when prompted, or manually set `tea_use_playwright_utils: true` in `_bmad/bmm/config.yaml`.
-**To disable**: Set `tea_use_playwright_utils: false` in `.bmad/bmm/config.yaml`.
+**To disable**: Set `tea_use_playwright_utils: false` in `_bmad/bmm/config.yaml`.
diff --git a/src/modules/bmm/docs/workflow-document-project-reference.md b/src/modules/bmm/docs/workflow-document-project-reference.md
index 48d6efe9..ad1e5a02 100644
--- a/src/modules/bmm/docs/workflow-document-project-reference.md
+++ b/src/modules/bmm/docs/workflow-document-project-reference.md
@@ -179,7 +179,7 @@ The workflow uses a single comprehensive CSV file:
**documentation-requirements.csv** - Complete project analysis guide
-- Location: `/.bmad/bmm/workflows/document-project/documentation-requirements.csv`
+- Location: `/_bmad/bmm/workflows/document-project/documentation-requirements.csv`
- 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)
- 24 columns combining:
- **Detection columns**: `project_type_id`, `key_file_patterns` (identifies project type from codebase)
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md
index 187b8310..7ce3f756 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
description: 'Initialize the product brief workflow by detecting continuation state and setting up the document'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-01-init.md'
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01b-continue.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01b-continue.md
index 62d70d77..778b4c7d 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01b-continue.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
description: 'Resume the product brief workflow from where it was left off, ensuring smooth continuation'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md
index a341fdb9..6b98dec8 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md
@@ -3,7 +3,7 @@ name: 'step-02-vision'
description: 'Discover and define the core product vision, problem statement, and unique value proposition'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-02-vision.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/analysis/product-brief-{{project_name}}-{{date}}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 2: Product Vision Discovery
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md
index e7a98973..a5526470 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md
@@ -3,7 +3,7 @@ name: 'step-03-users'
description: 'Define target users with rich personas and map their key interactions with the product'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-03-users.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/analysis/product-brief-{{project_name}}-{{date}}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 3: Target Users Discovery
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md
index 3ec52bc1..88993ae4 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md
@@ -3,7 +3,7 @@ name: 'step-04-metrics'
description: 'Define comprehensive success metrics that include user success, business objectives, and key performance indicators'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-04-metrics.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/analysis/product-brief-{{project_name}}-{{date}}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 4: Success Metrics Definition
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md
index 1b84767e..fb68106b 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md
@@ -3,7 +3,7 @@ name: 'step-05-scope'
description: 'Define MVP scope with clear boundaries and outline future vision while managing scope creep'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-05-scope.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/analysis/product-brief-{{project_name}}-{{date}}.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 5: MVP Scope Definition
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-06-complete.md b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-06-complete.md
index 13db46e0..9b67a4c3 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-06-complete.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-06-complete.md
@@ -3,7 +3,7 @@ name: 'step-06-complete'
description: 'Complete the product brief workflow, update status files, and suggest next steps for the project'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/1-analysis/product-brief'
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/product-brief'
# File References
thisStepFile: '{workflow_path}/steps/step-06-complete.md'
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.md b/src/modules/bmm/workflows/1-analysis/product-brief/workflow.md
index cc7fdd15..0e078e5f 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmm/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmm/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level`
### 2. First Step EXECUTION
-Load, read the full file and then execute `{project-root}/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/_bmad/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md` to begin the workflow.
diff --git a/src/modules/bmm/workflows/1-analysis/research/workflow.md b/src/modules/bmm/workflows/1-analysis/research/workflow.md
index b02af79d..f0f20d9f 100644
--- a/src/modules/bmm/workflows/1-analysis/research/workflow.md
+++ b/src/modules/bmm/workflows/1-analysis/research/workflow.md
@@ -42,7 +42,7 @@ This uses **micro-file architecture** with **routing-based discovery**:
### Configuration Loading
-Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
@@ -51,7 +51,7 @@ Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
### Paths
-- `installed_path` = `{project-root}/.bmad/bmm/workflows/1-analysis/research`
+- `installed_path` = `{project-root}/_bmad/bmm/workflows/1-analysis/research`
- `template_path` = `{installed_path}/research.template.md`
- `default_output_file` = `{output_folder}/analysis/research/{{research_type}}-{{topic}}-research-{{date}}.md` (dynamic based on research type)
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md
index 28dba6f8..24d8cf14 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -154,7 +154,7 @@ Show the generated project understanding content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current project understanding content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current project understanding content
- Process the enhanced project insights that come back
- Ask user: "Accept these improvements to the project understanding? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -162,7 +162,7 @@ Show the generated project understanding content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current project understanding
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current project understanding
- Process the collaborative insights and different perspectives that come back
- Ask user: "Accept these changes to the project understanding? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md
index ba0cd167..843a54ac 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -160,7 +160,7 @@ Show the generated core experience content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current core experience content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current core experience content
- Process the enhanced experience insights that come back
- Ask user: "Accept these improvements to the core experience definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -168,7 +168,7 @@ Show the generated core experience content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current core experience definition
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current core experience definition
- Process the collaborative experience improvements that come back
- Ask user: "Accept these changes to the core experience definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md
index efc52ded..f2f40f57 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -163,7 +163,7 @@ Show the generated emotional response content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current emotional response content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current emotional response content
- Process the enhanced emotional insights that come back
- Ask user: "Accept these improvements to the emotional response definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -171,7 +171,7 @@ Show the generated emotional response content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current emotional response definition
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current emotional response definition
- Process the collaborative emotional insights that come back
- Ask user: "Accept these changes to the emotional response definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md
index d84abb75..b0cbd8a2 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -178,7 +178,7 @@ Show the generated inspiration analysis content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current inspiration analysis content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current inspiration analysis content
- Process the enhanced pattern insights that come back
- Ask user: "Accept these improvements to the inspiration analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -186,7 +186,7 @@ Show the generated inspiration analysis content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current inspiration analysis
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current inspiration analysis
- Process the collaborative pattern insights that come back
- Ask user: "Accept these changes to the inspiration analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md
index ac33a424..d23128db 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -196,7 +196,7 @@ Show the generated design system content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current design system content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current design system content
- Process the enhanced design system insights that come back
- Ask user: "Accept these improvements to the design system decision? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -204,7 +204,7 @@ Show the generated design system content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current design system choice
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current design system choice
- Process the collaborative design system insights that come back
- Ask user: "Accept these changes to the design system decision? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md
index a03e83bb..c80997c7 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -198,7 +198,7 @@ Show the generated defining experience content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current defining experience content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current defining experience content
- Process the enhanced experience insights that come back
- Ask user: "Accept these improvements to the defining experience? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -206,7 +206,7 @@ Show the generated defining experience content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current defining experience
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current defining experience
- Process the collaborative experience insights that come back
- Ask user: "Accept these changes to the defining experience? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md
index d71b0853..eea6d39a 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -168,7 +168,7 @@ Show the generated visual foundation content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current visual foundation content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current visual foundation content
- Process the enhanced visual insights that come back
- Ask user: "Accept these improvements to the visual foundation? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -176,7 +176,7 @@ Show the generated visual foundation content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current visual foundation
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current visual foundation
- Process the collaborative visual insights that come back
- Ask user: "Accept these changes to the visual foundation? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md
index 2fcfaf7d..7510fae6 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -168,7 +168,7 @@ Show the generated design direction content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current design direction content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current design direction content
- Process the enhanced design insights that come back
- Ask user: "Accept these improvements to the design direction? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -176,7 +176,7 @@ Show the generated design direction content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current design direction
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current design direction
- Process the collaborative design insights that come back
- Ask user: "Accept these changes to the design direction? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md
index c0142e93..dbd8fc2a 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -186,7 +186,7 @@ Show the generated user journey content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current user journey content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current user journey content
- Process the enhanced journey insights that come back
- Ask user: "Accept these improvements to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -194,7 +194,7 @@ Show the generated user journey content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current user journeys
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current user journeys
- Process the collaborative journey insights that come back
- Ask user: "Accept these changes to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md
index d258ae82..b3d92c40 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -192,7 +192,7 @@ Show the generated component strategy content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current component strategy content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current component strategy content
- Process the enhanced component insights that come back
- Ask user: "Accept these improvements to the component strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -200,7 +200,7 @@ Show the generated component strategy content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current component strategy
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current component strategy
- Process the collaborative component insights that come back
- Ask user: "Accept these changes to the component strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md
index bf4f1ab6..8615d111 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -181,7 +181,7 @@ Show the generated UX patterns content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current UX patterns content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current UX patterns content
- Process the enhanced pattern insights that come back
- Ask user: "Accept these improvements to the UX patterns? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -189,7 +189,7 @@ Show the generated UX patterns content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current UX patterns
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current UX patterns
- Process the collaborative pattern insights that come back
- Ask user: "Accept these changes to the UX patterns? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md
index c5a38ca2..87349a04 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md
@@ -29,8 +29,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -208,7 +208,7 @@ Show the generated responsive and accessibility content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current responsive/accessibility content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current responsive/accessibility content
- Process the enhanced insights that come back
- Ask user: "Accept these improvements to the responsive/accessibility strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -216,7 +216,7 @@ Show the generated responsive and accessibility content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current responsive/accessibility strategy
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current responsive/accessibility strategy
- Process the collaborative insights that come back
- Ask user: "Accept these changes to the responsive/accessibility strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md
index affe2494..c6805ebe 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md
@@ -25,7 +25,7 @@ This uses **micro-file architecture** for disciplined execution:
### Configuration Loading
-Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
@@ -33,7 +33,7 @@ Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
### Paths
-- `installed_path` = `{project-root}/.bmad/bmm/workflows/2-plan-workflows/create-ux-design`
+- `installed_path` = `{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design`
- `template_path` = `{installed_path}/ux-design-template.md`
- `default_output_file` = `{output_folder}/ux-design-specification.md`
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md
index 7680c417..11dcd880 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
description: 'Initialize the PRD workflow by detecting continuation state and setting up the document'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-01-init.md'
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md
index 0b1132c1..bd4dfec6 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
description: 'Resume an interrupted PRD workflow from the last completed step'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md
index ac480a17..ed16913e 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md
@@ -3,7 +3,7 @@ name: 'step-02-discovery'
description: 'Conduct project and domain discovery with data-driven classification'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-02-discovery.md'
@@ -16,8 +16,8 @@ projectTypesCSV: '{workflow_path}/project-types.csv'
domainComplexityCSV: '{workflow_path}/domain-complexity.csv'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 2: Project & Domain Discovery
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md
index 566a291d..5ebe63d2 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md
@@ -3,7 +3,7 @@ name: 'step-03-success'
description: 'Define comprehensive success criteria covering user, business, and technical success'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-03-success.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/prd.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 3: Success Criteria Definition
@@ -49,8 +49,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -228,7 +228,7 @@ Show the generated content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current success criteria content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current success criteria content
- Process the enhanced success metrics that come back
- Ask user: "Accept these improvements to the success criteria? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -236,7 +236,7 @@ Show the generated content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current success criteria
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current success criteria
- Process the collaborative improvements to metrics and scope
- Ask user: "Accept these changes to the success criteria? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md
index 6a061357..5fb0a855 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md
@@ -3,7 +3,7 @@ name: 'step-04-journeys'
description: 'Map ALL user types that interact with the system with narrative story-based journeys'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-04-journeys.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/prd.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 4: User Journey Mapping
@@ -49,8 +49,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -222,7 +222,7 @@ Show the generated journey content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current journey content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current journey content
- Process the enhanced journey insights that come back
- Ask user: "Accept these improvements to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -230,7 +230,7 @@ Show the generated journey content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current journeys
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current journeys
- Process the collaborative journey improvements and additions
- Ask user: "Accept these changes to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -240,7 +240,7 @@ Show the generated journey content and present choices:
- Append the final content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md` (or determine if step is optional based on domain complexity)
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md` (or determine if step is optional based on domain complexity)
## APPEND TO DOCUMENT:
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md
index e904ff12..1fe4192d 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md
@@ -3,7 +3,7 @@ name: 'step-05-domain'
description: 'Explore domain-specific requirements for complex domains (optional step)'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-05-domain.md'
@@ -15,8 +15,8 @@ outputFile: '{output_folder}/prd.md'
domainComplexityCSV: '{workflow_path}/domain-complexity.csv'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 5: Domain-Specific Exploration
@@ -52,8 +52,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -71,7 +71,7 @@ Before proceeding with this step, verify:
- Is `complexity_level` from step-02 equal to "high" and/or does the domain have specific regulatory/compliance needs?
- Would domain exploration significantly impact the product requirements?
-If NO to these questions, skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`.
+If NO to these questions, skip this step and load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`.
## YOUR TASK:
@@ -83,7 +83,7 @@ Explore domain-specific requirements for complex domains that need specialized c
Load domain-specific configuration for complex domains:
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv` completely
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv` completely
- Find the row where `domain` matches the detected domain from step-02
- Extract these columns:
- `key_concerns` (semicolon-separated list)
@@ -207,7 +207,7 @@ Show the generated domain content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current domain content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current domain content
- Process the enhanced domain insights that come back
- Ask user: "Accept these domain requirement improvements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -215,7 +215,7 @@ Show the generated domain content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current domain requirements
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current domain requirements
- Process the collaborative domain expertise and validation
- Ask user: "Accept these changes to domain requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -225,7 +225,7 @@ Show the generated domain content and present choices:
- Append the content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`
## APPEND TO DOCUMENT:
@@ -257,7 +257,7 @@ When user selects 'C', append the content directly to the document using the str
## SKIP CONDITIONS:
-Skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md` if:
+Skip this step and load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md` if:
- `complexity_level` from step-02 is not "high"
- Domain has no specific regulatory/compliance requirements
@@ -265,6 +265,6 @@ Skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd
## NEXT STEP:
-After user selects 'C' and content is saved to document, load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`.
+After user selects 'C' and content is saved to document, load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`.
Remember: Do NOT proceed to step-06 until user explicitly selects 'C' from the A/P/C menu and content is saved!
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md
index 94f04e55..9630d333 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md
@@ -3,7 +3,7 @@ name: 'step-06-innovation'
description: 'Detect and explore innovative aspects of the product (optional step)'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-06-innovation.md'
@@ -15,8 +15,8 @@ outputFile: '{output_folder}/prd.md'
projectTypesCSV: '{workflow_path}/project-types.csv'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 6: Innovation Discovery
@@ -52,8 +52,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -83,7 +83,7 @@ Detect and explore innovation patterns in the product, focusing on what makes it
Load innovation signals specific to this project type:
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv` completely
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv` completely
- Find the row where `project_type` matches detected type from step-02
- Extract `innovation_signals` (semicolon-separated list)
- Extract `web_search_triggers` for potential innovation research
@@ -186,7 +186,7 @@ Show the generated innovation content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current innovation content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current innovation content
- Process the enhanced innovation insights that come back
- Ask user: "Accept these improvements to the innovation analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -194,7 +194,7 @@ Show the generated innovation content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current innovation content
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current innovation content
- Process the collaborative innovation exploration and ideation
- Ask user: "Accept these changes to the innovation analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -204,7 +204,7 @@ Show the generated innovation content and present choices:
- Append the final content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`
## NO INNOVATION DETECTED:
@@ -215,7 +215,7 @@ If no genuine innovation signals are found after exploration:
[A] Force innovation exploration - Let's try to find innovative angles
[C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11)"
-If user selects 'A', proceed with content generation anyway. If 'C', skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`.
+If user selects 'A', proceed with content generation anyway. If 'C', skip this step and load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`.
## APPEND TO DOCUMENT:
@@ -247,7 +247,7 @@ When user selects 'C', append the content directly to the document using the str
## SKIP CONDITIONS:
-Skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md` if:
+Skip this step and load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md` if:
- No innovation signals detected in conversation
- Product is incremental improvement rather than breakthrough
@@ -256,6 +256,6 @@ Skip this step and load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd
## NEXT STEP:
-After user selects 'C' and content is saved to document (or step is skipped), load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`.
+After user selects 'C' and content is saved to document (or step is skipped), load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`.
Remember: Do NOT proceed to step-07 until user explicitly selects 'C' from the A/P/C menu (or confirms step skip)!
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md
index fa2fe95c..5b234de0 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md
@@ -3,7 +3,7 @@ name: 'step-07-project-type'
description: 'Conduct project-type specific discovery using CSV-driven guidance'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-07-project-type.md'
@@ -15,8 +15,8 @@ outputFile: '{output_folder}/prd.md'
projectTypesCSV: '{workflow_path}/project-types.csv'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 7: Project-Type Deep Dive
@@ -52,8 +52,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -74,7 +74,7 @@ Conduct project-type specific discovery using CSV-driven guidance to define tech
Load project-type specific configuration:
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv` completely
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv` completely
- Find the row where `project_type` matches detected type from step-02
- Extract these columns:
- `key_questions` (semicolon-separated list of discovery questions)
@@ -182,7 +182,7 @@ Show the generated project-type content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current project-type content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current project-type content
- Process the enhanced technical insights that come back
- Ask user: "Accept these improvements to the technical requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -190,7 +190,7 @@ Show the generated project-type content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current project-type requirements
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current project-type requirements
- Process the collaborative technical expertise and validation
- Ask user: "Accept these changes to the technical requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -200,7 +200,7 @@ Show the generated project-type content and present choices:
- Append the final content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md`
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md`
## APPEND TO DOCUMENT:
@@ -252,6 +252,6 @@ When user selects 'C', append the content directly to the document using the str
## NEXT STEP:
-After user selects 'C' and content is saved to document, load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md` to define project scope.
+After user selects 'C' and content is saved to document, load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md` to define project scope.
Remember: Do NOT proceed to step-08 (Scoping) until user explicitly selects 'C' from the A/P/C menu and content is saved!
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md
index 5e4f5d21..34f8e1c4 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md
@@ -3,7 +3,7 @@ name: 'step-08-scoping'
description: 'Define MVP boundaries and prioritize features across development phases'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-08-scoping.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/prd.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 8: Scoping Exercise - MVP & Future Features
@@ -50,8 +50,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -243,7 +243,7 @@ Show the scoping decisions and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with current scoping analysis
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with current scoping analysis
- Process enhanced scoping insights that come back
- Ask user: "Accept these improvements to the scoping decisions? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -251,7 +251,7 @@ Show the scoping decisions and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with scoping context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with scoping context
- Process collaborative insights on MVP and roadmap decisions
- Ask user: "Accept these changes to the scoping decisions? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md
index c09c35e1..de3ff379 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md
@@ -3,7 +3,7 @@ name: 'step-09-functional'
description: 'Synthesize all discovery into comprehensive functional requirements'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-09-functional.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/prd.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 9: Functional Requirements Synthesis
@@ -49,8 +49,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -209,7 +209,7 @@ Show the generated functional requirements and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current FR list
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current FR list
- Process the enhanced capability coverage that comes back
- Ask user: "Accept these additions to the functional requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -217,7 +217,7 @@ Show the generated functional requirements and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current FR list
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current FR list
- Process the collaborative capability validation and additions
- Ask user: "Accept these changes to the functional requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -227,7 +227,7 @@ Show the generated functional requirements and present choices:
- Append the final content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md`
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md`
## APPEND TO DOCUMENT:
@@ -264,6 +264,6 @@ Emphasize to user: "This FR list is now binding. Any feature not listed here wil
## NEXT STEP:
-After user selects 'C' and content is saved to document, load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md` to define non-functional requirements.
+After user selects 'C' and content is saved to document, load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md` to define non-functional requirements.
Remember: Do NOT proceed to step-10 until user explicitly selects 'C' from the A/P/C menu and content is saved!
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md
index e7e59d99..4a0793b3 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md
@@ -3,7 +3,7 @@ name: 'step-10-nonfunctional'
description: 'Define quality attributes that matter for this specific product'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-10-nonfunctional.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/prd.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
# Step 10: Non-Functional Requirements
@@ -49,8 +49,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -209,7 +209,7 @@ Show the generated NFR content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current NFR content
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current NFR content
- Process the enhanced quality attribute insights that come back
- Ask user: "Accept these improvements to the non-functional requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -217,7 +217,7 @@ Show the generated NFR content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current NFR list
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current NFR list
- Process the collaborative technical validation and additions
- Ask user: "Accept these changes to the non-functional requirements? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -227,7 +227,7 @@ Show the generated NFR content and present choices:
- Append the final content to `{output_folder}/prd.md`
- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]`
-- Load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md`
+- Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md`
## APPEND TO DOCUMENT:
@@ -288,6 +288,6 @@ When user selects 'C', append the content directly to the document using the str
## NEXT STEP:
-After user selects 'C' and content is saved to document, load `{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md` to finalize the PRD and complete the workflow.
+After user selects 'C' and content is saved to document, load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md` to finalize the PRD and complete the workflow.
Remember: Do NOT proceed to step-11 until user explicitly selects 'C' from the A/P/C menu and content is saved!
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md
index 6effb50b..f4e6facd 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md
@@ -3,7 +3,7 @@ name: 'step-11-complete'
description: 'Complete the PRD workflow, update status files, and suggest next steps'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/2-plan-workflows/prd'
+workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
# File References
thisStepFile: '{workflow_path}/steps/step-11-complete.md'
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md b/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md
index 48fb57e3..07061b8a 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md
+++ b/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md
@@ -1,7 +1,7 @@
---
name: create-prd
description: Creates a comprehensive PRD through collaborative step-by-step discovery between two product managers working as peers.
-main_config: '{project-root}/.bmad/bmm/config.yaml'
+main_config: '{project-root}/_bmad/bmm/config.yaml'
web_bundle: true
---
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-02-context.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-02-context.md
index 0dd7569f..cb6d83d6 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-02-context.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-02-context.md
@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -169,7 +169,7 @@ Show the generated content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with the current context analysis
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with the current context analysis
- Process the enhanced architectural insights that come back
- Ask user: "Accept these enhancements to the project context analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -177,7 +177,7 @@ Show the generated content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with the current project context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with the current project context
- Process the collaborative improvements to architectural understanding
- Ask user: "Accept these changes to the project context analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md
index 52f7a792..02f44275 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md
@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -276,7 +276,7 @@ Show the generated content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with current starter analysis
+- Execute {project-root}/_bmad/core/tasks/advanced-elicitation.xml with current starter analysis
- Process enhanced insights about starter options or custom approaches
- Ask user: "Accept these changes to the starter template evaluation? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -284,7 +284,7 @@ Show the generated content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with starter evaluation context
+- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with starter evaluation context
- Process collaborative insights about starter trade-offs
- Ask user: "Accept these changes to the starter template evaluation? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md
index a25f0d1d..b1a580ca 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md
@@ -31,8 +31,8 @@ This step will generate content and present choices for each decision category:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -263,7 +263,7 @@ Show the generated decisions content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with specific decision categories
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with specific decision categories
- Process enhanced insights about particular decisions
- Ask user: "Accept these enhancements to the architectural decisions? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -271,7 +271,7 @@ Show the generated decisions content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with architectural decisions context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with architectural decisions context
- Process collaborative insights about decision trade-offs
- Ask user: "Accept these changes to the architectural decisions? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-05-patterns.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-05-patterns.md
index 12c8a70b..68b13e53 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-05-patterns.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-05-patterns.md
@@ -31,8 +31,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -304,7 +304,7 @@ Show the generated patterns content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with current patterns
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with current patterns
- Process enhanced consistency rules that come back
- Ask user: "Accept these additional pattern refinements? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -312,7 +312,7 @@ Show the generated patterns content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with implementation patterns context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with implementation patterns context
- Process collaborative insights about potential conflicts
- Ask user: "Accept these changes to the implementation patterns? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-06-structure.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-06-structure.md
index 64d6385a..e9be2cc0 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-06-structure.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-06-structure.md
@@ -31,8 +31,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -324,7 +324,7 @@ Show the generated project structure content and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with current project structure
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with current project structure
- Process enhanced organizational insights that come back
- Ask user: "Accept these changes to the project structure? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -332,7 +332,7 @@ Show the generated project structure content and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with project structure context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with project structure context
- Process collaborative insights about organization trade-offs
- Ask user: "Accept these changes to the project structure? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-07-validation.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-07-validation.md
index 79f44404..4c68d449 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-07-validation.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-07-validation.md
@@ -31,8 +31,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
@@ -304,7 +304,7 @@ Show the validation results and present choices:
#### If 'A' (Advanced Elicitation):
-- Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml with validation issues
+- Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml with validation issues
- Process enhanced solutions for complex concerns
- Ask user: "Accept these architectural improvements? (y/n)"
- If yes: Update content, then return to A/P/C menu
@@ -312,7 +312,7 @@ Show the validation results and present choices:
#### If 'P' (Party Mode):
-- Execute {project-root}/.bmad/core/workflows/party-mode/workflow.md with validation context
+- Execute {project-root}/\_bmad/core/workflows/party-mode/workflow.md with validation context
- Process collaborative insights on implementation readiness
- Ask user: "Accept these changes to the validation results? (y/n)"
- If yes: Update content, then return to A/P/C menu
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-08-complete.md b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-08-complete.md
index 6e91a3da..0cbc2f10 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-08-complete.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-08-complete.md
@@ -314,7 +314,7 @@ The workflow will collaborate with you to create an optimized `project-context.m
**Execute the Generate Project Context workflow:**
-- Load and execute: `{project-root}/.bmad/bmm/workflows/generate-project-context/workflow.md`
+- Load and execute: `{project-root}/_bmad/bmm/workflows/generate-project-context/workflow.md`
- The workflow will handle discovery, generation, and completion of the project context file
- After completion, return here for final handoff
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/workflow.md b/src/modules/bmm/workflows/3-solutioning/architecture/workflow.md
index b235622e..f674c2ac 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/workflow.md
+++ b/src/modules/bmm/workflows/3-solutioning/architecture/workflow.md
@@ -28,7 +28,7 @@ This uses **micro-file architecture** for disciplined execution:
### Configuration Loading
-Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
@@ -36,7 +36,7 @@ Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
### Paths
-- `installed_path` = `{project-root}/.bmad/bmm/workflows/3-solutioning/architecture`
+- `installed_path` = `{project-root}/_bmad/bmm/workflows/3-solutioning/architecture`
- `template_path` = `{installed_path}/architecture-decision-template.md`
- `data_files_path` = `{installed_path}/data/`
diff --git a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md
index a0a1c656..a139b3bf 100644
--- a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md
+++ b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md
@@ -3,7 +3,7 @@ name: 'step-01-validate-prerequisites'
description: 'Validate required documents exist and extract all requirements for epic and story creation'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
# File References
thisStepFile: '{workflow_path}/steps/step-01-validate-prerequisites.md'
@@ -13,8 +13,8 @@ outputFile: '{output_folder}/epics.md'
epicsTemplate: '{workflow_path}/templates/epics-template.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
epicsTemplate: '{workflow_path}/templates/epics-template.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md
index 6c535058..5e873978 100644
--- a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md
+++ b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md
@@ -3,7 +3,7 @@ name: 'step-02-design-epics'
description: 'Design and approve the epics_list that will organize all requirements into user-value-focused epics'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
# File References
thisStepFile: '{workflow_path}/steps/step-02-design-epics.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/epics.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
epicsTemplate: '{workflow_path}/templates/epics-template.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md
index 860e5991..a27c7cf9 100644
--- a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md
+++ b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md
@@ -3,7 +3,7 @@ name: 'step-03-create-stories'
description: 'Generate all epics with their stories following the template structure'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
# File References
thisStepFile: '{workflow_path}/steps/step-03-create-stories.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/epics.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
epicsTemplate: '{workflow_path}/templates/epics-template.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md
index c11595b9..1ae059a2 100644
--- a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md
+++ b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md
@@ -3,7 +3,7 @@ name: 'step-04-final-validation'
description: 'Validate complete coverage of all requirements and ensure implementation readiness'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
# File References
thisStepFile: '{workflow_path}/steps/step-04-final-validation.md'
@@ -11,8 +11,8 @@ workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/epics.md'
# Task References
-advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
# Template References
epicsTemplate: '{workflow_path}/templates/epics-template.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md
index ad0baacc..27ef0f5a 100644
--- a/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md
+++ b/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:
### 1. Configuration Loading
-Load and read full config from {project-root}/.bmad/bmm/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmm/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
### 2. First Step EXECUTION
-Load, read the full file and then execute `{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md` to begin the workflow.
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md
index 87b44993..8c6dc18e 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md
@@ -3,7 +3,7 @@ name: 'step-01-document-discovery'
description: 'Discover and inventory all project documents, handling duplicates and organizing file structure'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-01-document-discovery.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md
index 2894a69d..cdbb2b69 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md
@@ -3,7 +3,7 @@ name: 'step-02-prd-analysis'
description: 'Read and analyze PRD to extract all FRs and NFRs for coverage validation'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-02-prd-analysis.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md
index 75745637..f3dd77b2 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md
@@ -3,7 +3,7 @@ name: 'step-03-epic-coverage-validation'
description: 'Validate that all PRD FRs are covered in epics and stories'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-03-epic-coverage-validation.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md
index 1ef14ff1..180108a9 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md
@@ -3,7 +3,7 @@ name: 'step-04-ux-alignment'
description: 'Check for UX document and validate alignment with PRD and Architecture'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-04-ux-alignment.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md
index d7e01274..d30d719d 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md
@@ -3,14 +3,14 @@ name: 'step-05-epic-quality-review'
description: 'Validate epics and stories against create-epics-and-stories best practices'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-05-epic-quality-review.md'
nextStepFile: '{workflow_path}/steps/step-06-final-assessment.md'
workflowFile: '{workflow_path}/workflow.md'
outputFile: '{output_folder}/implementation-readiness-report-{{date}}.md'
-epicsBestPractices: '{project-root}/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
+epicsBestPractices: '{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories'
---
# Step 5: Epic Quality Review
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md
index d495da99..a19b7dc9 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md
@@ -3,7 +3,7 @@ name: 'step-06-final-assessment'
description: 'Compile final assessment and polish the readiness report'
# Path Definitions
-workflow_path: '{project-root}/.bmad/bmm/workflows/3-solutioning/implementation-readiness'
+workflow_path: '{project-root}/_bmad/bmm/workflows/3-solutioning/implementation-readiness'
# File References
thisStepFile: '{workflow_path}/steps/step-06-final-assessment.md'
diff --git a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.md b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.md
index e14c444a..0336f529 100644
--- a/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.md
+++ b/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.md
@@ -45,7 +45,7 @@ web_bundle: false
### 1. Module Configuration Loading
-Load and read full config from {project-root}/.bmad/bmm/config.yaml and resolve:
+Load and read full config from {project-root}/\_bmad/bmm/config.yaml and resolve:
- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
diff --git a/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml b/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml
index 3c5a69e6..e57a940d 100644
--- a/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml
+++ b/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml
@@ -1,5 +1,5 @@
- The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+ The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
@@ -16,7 +16,8 @@
Use provided {{story_path}} or ask user which story file to review
Read COMPLETE story file
- Set {{story_key}} = extracted key from filename (e.g., "1-2-user-authentication.md" → "1-2-user-authentication") or story metadata
+ Set {{story_key}} = extracted key from filename (e.g., "1-2-user-authentication.md" → "1-2-user-authentication") or story
+ metadata
Parse sections: Story, Acceptance Criteria, Tasks/Subtasks, Dev Agent Record → File List, Change Log
diff --git a/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml b/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml
index c148ef89..e5de483e 100644
--- a/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml
@@ -4,7 +4,7 @@ description: "Perform an ADVERSARIAL Senior Developer code review that finds 3-1
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -15,7 +15,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review"
instructions: "{installed_path}/instructions.xml"
validation: "{installed_path}/checklist.md"
template: false
diff --git a/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md b/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md
index 7fb6dc06..76d4a827 100644
--- a/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md
+++ b/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md
@@ -1,6 +1,6 @@
# Change Navigation Checklist
-This checklist is executed as part of: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
+This checklist is executed as part of: {project-root}/\_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
Work through each section systematically with the user, recording findings and impacts
diff --git a/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md b/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md
index 738aeea9..95a7ea51 100644
--- a/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md
+++ b/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md
@@ -1,7 +1,7 @@
# Correct Course - Sprint Change Management Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
diff --git a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml b/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml
index 627cebb5..a342a9eb 100644
--- a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml
@@ -3,7 +3,7 @@ name: "correct-course"
description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation"
author: "BMad Method"
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -46,7 +46,7 @@ input_file_patterns:
sharded: "{output_folder}/index.md"
load_strategy: "INDEX_GUIDED"
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course"
template: false
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/4-implementation/create-story/checklist.md b/src/modules/bmm/workflows/4-implementation/create-story/checklist.md
index 7996fee1..b0f22385 100644
--- a/src/modules/bmm/workflows/4-implementation/create-story/checklist.md
+++ b/src/modules/bmm/workflows/4-implementation/create-story/checklist.md
@@ -33,7 +33,7 @@ This is a COMPETITION to create the **ULTIMATE story context** that makes LLM de
### **When Running from Create-Story Workflow:**
-- The `{project_root}/.bmad/core/tasks/validate-workflow.xml` framework will automatically:
+- The `{project_root}/_bmad/core/tasks/validate-workflow.xml` framework will automatically:
- Load this checklist file
- Load the newly created story file (`{story_file_path}`)
- Load workflow variables from `{installed_path}/workflow.yaml`
@@ -63,7 +63,7 @@ You will systematically re-do the entire story creation process, but with a crit
1. **Load the workflow configuration**: `{installed_path}/workflow.yaml` for variable inclusion
2. **Load the story file**: `{story_file_path}` (provided by user or discovered)
-3. **Load validation framework**: `{project_root}/.bmad/core/tasks/validate-workflow.xml`
+3. **Load validation framework**: `{project_root}/_bmad/core/tasks/validate-workflow.xml`
4. **Extract metadata**: epic_num, story_num, story_key, story_title from story file
5. **Resolve all workflow variables**: story_dir, output_folder, epics_file, architecture_file, etc.
6. **Understand current status**: What story implementation guidance is currently provided?
diff --git a/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml b/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml
index 3c908c80..e3805451 100644
--- a/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml
+++ b/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml
@@ -1,5 +1,5 @@
- The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+ The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and generate all documents in {document_output_language}
@@ -310,7 +310,7 @@
- Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml
+ Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml
Save story document unconditionally
diff --git a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml
index ea0640c4..656aa7b1 100644
--- a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml
@@ -3,7 +3,7 @@ description: "Create the next user story from epics+stories with enhanced contex
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
story_dir: "{sprint_artifacts}"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/create-story"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.xml"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml b/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml
index fac48f1a..47e76f07 100644
--- a/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml
+++ b/src/modules/bmm/workflows/4-implementation/dev-story/instructions.xml
@@ -1,5 +1,5 @@
- The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+ The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
@@ -44,7 +44,8 @@
3. Specify a particular story file to develop (provide full path)
4. Check {{sprint_status}} file to see current sprint status
- 💡 **Tip:** Stories in `ready-for-dev` may not have been validated. Consider running `validate-create-story` first for a quality check.
+ 💡 **Tip:** Stories in `ready-for-dev` may not have been validated. Consider running `validate-create-story` first for a quality
+ check.
Choose option [1], [2], [3], or [4], or specify story file path:
diff --git a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml
index 9c0b00db..6fb4ca5b 100644
--- a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml
@@ -3,7 +3,7 @@ description: "Execute a story by implementing tasks/subtasks, writing tests, val
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ story_dir: "{config_source}:sprint_artifacts"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/dev-story"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story"
instructions: "{installed_path}/instructions.xml"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md b/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md
index 0b5a1d98..64e129df 100644
--- a/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md
+++ b/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md
@@ -1,7 +1,7 @@
# Retrospective - Epic Completion Review Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
Generate all documents in {document_output_language}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
diff --git a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml b/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml
index 040c83a2..291b7698 100644
--- a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml
@@ -3,7 +3,7 @@ name: "retrospective"
description: "Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic"
author: "BMad"
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,12 +12,12 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
sprint_artifacts: "{config_source}:sprint_artifacts"
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/retrospective"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/retrospective"
template: false
instructions: "{installed_path}/instructions.md"
required_inputs:
- - agent_manifest: "{project-root}/.bmad/_cfg/agent-manifest.csv"
+ - agent_manifest: "{project-root}/_bmad/_cfg/agent-manifest.csv"
# Smart input file references - handles both whole docs and sharded docs
# Priority: Whole document first, then sharded version
diff --git a/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md b/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md
index bf1f280f..2aea9146 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md
+++ b/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md
@@ -1,7 +1,7 @@
# Sprint Planning - Sprint Status Generator
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
## 📚 Document Discovery - Full Epic Loading
diff --git a/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml b/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
index a8b23659..2daad29c 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
@@ -3,7 +3,7 @@ description: "Generate and manage the sprint status tracking file for Phase 4 im
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -11,7 +11,7 @@ date: system-generated
sprint_artifacts: "{config_source}:sprint_artifacts"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning"
instructions: "{installed_path}/instructions.md"
template: "{installed_path}/sprint-status-template.yaml"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md b/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
index ab0fdecf..c31f0bea 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
+++ b/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
@@ -1,7 +1,7 @@
# Sprint Status - Multi-Mode Service
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml
Modes: interactive (default), validate, data
⚠️ ABSOLUTELY NO TIME ESTIMATES. Do NOT mention hours, days, weeks, or timelines.
diff --git a/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml b/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml
index acb7a21f..4b028789 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml
+++ b/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml
@@ -4,7 +4,7 @@ description: "Summarize sprint-status.yaml, surface risks, and route to the righ
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ date: system-generated
sprint_artifacts: "{config_source}:sprint_artifacts"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-status"
+installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-status"
instructions: "{installed_path}/instructions.md"
# Inputs
diff --git a/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml b/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml
index 2660d8aa..354fc0d2 100644
--- a/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml
+++ b/src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml
@@ -4,7 +4,7 @@ description: "Conversational spec engineering - ask questions, investigate code,
author: "BMad"
# Config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
sprint_artifacts: "{config_source}:sprint_artifacts"
user_name: "{config_source}:user_name"
@@ -14,13 +14,13 @@ user_skill_level: "{config_source}:user_skill_level"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec"
+installed_path: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec"
instructions: "{installed_path}/instructions.md"
# Related workflows
-quick_dev_workflow: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml"
-party_mode_exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
-advanced_elicitation: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+quick_dev_workflow: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml"
+party_mode_exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
+advanced_elicitation: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
standalone: true
web_bundle: false
diff --git a/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml b/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml
index 3d076cbd..9ef52cdc 100644
--- a/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml
+++ b/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml
@@ -4,7 +4,7 @@ description: "Flexible development - execute tech-specs OR direct instructions w
author: "BMad"
# Config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
sprint_artifacts: "{config_source}:sprint_artifacts"
user_name: "{config_source}:user_name"
@@ -16,18 +16,18 @@ date: system-generated
project_context: "**/project-context.md"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/quick-dev"
+installed_path: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev"
instructions: "{installed_path}/instructions.md"
checklist: "{installed_path}/checklist.md"
# Related workflows
-create_tech_spec_workflow: "{project-root}/.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml"
-party_mode_exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
-advanced_elicitation: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+create_tech_spec_workflow: "{project-root}/_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml"
+party_mode_exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
+advanced_elicitation: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
# Routing resources (lazy-loaded)
-project_levels: "{project-root}/.bmad/bmm/workflows/workflow-status/project-levels.yaml"
-workflow_init: "{project-root}/.bmad/bmm/workflows/workflow-status/init/workflow.yaml"
+project_levels: "{project-root}/_bmad/bmm/workflows/workflow-status/project-levels.yaml"
+workflow_init: "{project-root}/_bmad/bmm/workflows/workflow-status/init/workflow.yaml"
standalone: true
web_bundle: false
diff --git a/src/modules/bmm/workflows/diagrams/create-dataflow/instructions.md b/src/modules/bmm/workflows/diagrams/create-dataflow/instructions.md
index ca906486..2902a8f6 100644
--- a/src/modules/bmm/workflows/diagrams/create-dataflow/instructions.md
+++ b/src/modules/bmm/workflows/diagrams/create-dataflow/instructions.md
@@ -1,7 +1,7 @@
# Create Data Flow Diagram - Workflow Instructions
```xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
This workflow creates data flow diagrams (DFD) in Excalidraw format.
diff --git a/src/modules/bmm/workflows/diagrams/create-dataflow/workflow.yaml b/src/modules/bmm/workflows/diagrams/create-dataflow/workflow.yaml
index 5af3a01c..6051f64d 100644
--- a/src/modules/bmm/workflows/diagrams/create-dataflow/workflow.yaml
+++ b/src/modules/bmm/workflows/diagrams/create-dataflow/workflow.yaml
@@ -3,18 +3,18 @@ description: "Create data flow diagrams (DFD) in Excalidraw format"
author: "BMad"
# Config values
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/diagrams/create-dataflow"
-shared_path: "{project-root}/.bmad/bmm/workflows/diagrams/_shared"
+installed_path: "{project-root}/_bmad/bmm/workflows/diagrams/create-dataflow"
+shared_path: "{project-root}/_bmad/bmm/workflows/diagrams/_shared"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
# Core Excalidraw resources (universal knowledge)
-helpers: "{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md"
-json_validation: "{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md"
+helpers: "{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md"
# Domain-specific resources (technical diagrams)
templates: "{shared_path}/excalidraw-templates.yaml"
diff --git a/src/modules/bmm/workflows/diagrams/create-diagram/instructions.md b/src/modules/bmm/workflows/diagrams/create-diagram/instructions.md
index dcdf5d34..1595bad1 100644
--- a/src/modules/bmm/workflows/diagrams/create-diagram/instructions.md
+++ b/src/modules/bmm/workflows/diagrams/create-diagram/instructions.md
@@ -1,7 +1,7 @@
# Create Diagram - Workflow Instructions
```xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
This workflow creates system architecture diagrams, ERDs, UML diagrams, or general technical diagrams in Excalidraw format.
@@ -134,7 +134,7 @@
- Validate against {{validation}} using {.bmad}/core/tasks/validate-workflow.xml
+ Validate against {{validation}} using {_bmad}/core/tasks/validate-workflow.xml
diff --git a/src/modules/bmm/workflows/diagrams/create-diagram/workflow.yaml b/src/modules/bmm/workflows/diagrams/create-diagram/workflow.yaml
index c8c9ca06..9236d527 100644
--- a/src/modules/bmm/workflows/diagrams/create-diagram/workflow.yaml
+++ b/src/modules/bmm/workflows/diagrams/create-diagram/workflow.yaml
@@ -3,18 +3,18 @@ description: "Create system architecture diagrams, ERDs, UML diagrams, or genera
author: "BMad"
# Config values
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/diagrams/create-diagram"
-shared_path: "{project-root}/.bmad/bmm/workflows/diagrams/_shared"
+installed_path: "{project-root}/_bmad/bmm/workflows/diagrams/create-diagram"
+shared_path: "{project-root}/_bmad/bmm/workflows/diagrams/_shared"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
# Core Excalidraw resources (universal knowledge)
-helpers: "{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md"
-json_validation: "{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md"
+helpers: "{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md"
# Domain-specific resources (technical diagrams)
templates: "{shared_path}/excalidraw-templates.yaml"
diff --git a/src/modules/bmm/workflows/diagrams/create-flowchart/instructions.md b/src/modules/bmm/workflows/diagrams/create-flowchart/instructions.md
index 933ad960..b70607c7 100644
--- a/src/modules/bmm/workflows/diagrams/create-flowchart/instructions.md
+++ b/src/modules/bmm/workflows/diagrams/create-flowchart/instructions.md
@@ -1,7 +1,7 @@
# Create Flowchart - Workflow Instructions
```xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
This workflow creates a flowchart visualization in Excalidraw format for processes, pipelines, or logic flows.
@@ -234,7 +234,7 @@
- Validate against checklist at {{validation}} using {.bmad}/core/tasks/validate-workflow.xml
+ Validate against checklist at {{validation}} using {_bmad}/core/tasks/validate-workflow.xml
diff --git a/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml b/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml
index 798f1ad9..c96c26cf 100644
--- a/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml
+++ b/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml
@@ -3,18 +3,18 @@ description: "Create a flowchart visualization in Excalidraw format for processe
author: "BMad"
# Config values
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/diagrams/create-flowchart"
-shared_path: "{project-root}/.bmad/bmm/workflows/diagrams/_shared"
+installed_path: "{project-root}/_bmad/bmm/workflows/diagrams/create-flowchart"
+shared_path: "{project-root}/_bmad/bmm/workflows/diagrams/_shared"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
# Core Excalidraw resources (universal knowledge)
-helpers: "{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md"
-json_validation: "{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md"
+helpers: "{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md"
# Domain-specific resources (technical diagrams)
templates: "{shared_path}/excalidraw-templates.yaml"
diff --git a/src/modules/bmm/workflows/diagrams/create-wireframe/instructions.md b/src/modules/bmm/workflows/diagrams/create-wireframe/instructions.md
index afc3a03c..cc727434 100644
--- a/src/modules/bmm/workflows/diagrams/create-wireframe/instructions.md
+++ b/src/modules/bmm/workflows/diagrams/create-wireframe/instructions.md
@@ -1,7 +1,7 @@
# Create Wireframe - Workflow Instructions
```xml
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
This workflow creates website or app wireframes in Excalidraw format.
diff --git a/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml b/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml
index 68e12360..18c7b0d1 100644
--- a/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml
+++ b/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml
@@ -3,18 +3,18 @@ description: "Create website or app wireframes in Excalidraw format"
author: "BMad"
# Config values
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/diagrams/create-wireframe"
-shared_path: "{project-root}/.bmad/bmm/workflows/diagrams/_shared"
+installed_path: "{project-root}/_bmad/bmm/workflows/diagrams/create-wireframe"
+shared_path: "{project-root}/_bmad/bmm/workflows/diagrams/_shared"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
# Core Excalidraw resources (universal knowledge)
-helpers: "{project-root}/.bmad/core/resources/excalidraw/excalidraw-helpers.md"
-json_validation: "{project-root}/.bmad/core/resources/excalidraw/validate-json-instructions.md"
+helpers: "{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md"
# Domain-specific resources (technical diagrams)
templates: "{shared_path}/excalidraw-templates.yaml"
diff --git a/src/modules/bmm/workflows/document-project/instructions.md b/src/modules/bmm/workflows/document-project/instructions.md
index 591155a1..ae8686fe 100644
--- a/src/modules/bmm/workflows/document-project/instructions.md
+++ b/src/modules/bmm/workflows/document-project/instructions.md
@@ -1,7 +1,7 @@
# Document Project Workflow Router
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/document-project/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/document-project/workflow.yaml
Communicate all responses in {communication_language}
@@ -10,7 +10,7 @@
-
+
mode: data
data_request: project_config
@@ -36,7 +36,7 @@
-
+
mode: validate
calling_workflow: document-project
@@ -179,7 +179,7 @@ Your choice [1/2/3]:
-
+
mode: update
action: complete_workflow
workflow_name: document-project
diff --git a/src/modules/bmm/workflows/document-project/workflow.yaml b/src/modules/bmm/workflows/document-project/workflow.yaml
index 76f871dd..c0b1725b 100644
--- a/src/modules/bmm/workflows/document-project/workflow.yaml
+++ b/src/modules/bmm/workflows/document-project/workflow.yaml
@@ -5,7 +5,7 @@ description: "Analyzes and documents brownfield projects by scanning codebase, a
author: "BMad"
# Critical variables
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ user_skill_level: "{config_source}:user_skill_level"
date: system-generated
# Module path and component files
-installed_path: "{project-root}/.bmad/bmm/workflows/document-project"
+installed_path: "{project-root}/_bmad/bmm/workflows/document-project"
template: false # This is an action workflow with multiple output files
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml b/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml
index c9d8945f..a333cc4b 100644
--- a/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml
+++ b/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml
@@ -4,22 +4,22 @@ description: "Exhaustive deep-dive documentation of specific project areas"
author: "BMad"
# This is a sub-workflow called by document-project/workflow.yaml
-parent_workflow: "{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml"
+parent_workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
# Critical variables inherited from parent
-config_source: "{project-root}/.bmad/bmb/config.yaml"
+config_source: "{project-root}/_bmad/bmb/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
date: system-generated
# Module path and component files
-installed_path: "{project-root}/.bmad/bmm/workflows/document-project/workflows"
+installed_path: "{project-root}/_bmad/bmm/workflows/document-project/workflows"
template: false # Action workflow
instructions: "{installed_path}/deep-dive-instructions.md"
-validation: "{project-root}/.bmad/bmm/workflows/document-project/checklist.md"
+validation: "{project-root}/_bmad/bmm/workflows/document-project/checklist.md"
# Templates
-deep_dive_template: "{project-root}/.bmad/bmm/workflows/document-project/templates/deep-dive-template.md"
+deep_dive_template: "{project-root}/_bmad/bmm/workflows/document-project/templates/deep-dive-template.md"
# Runtime inputs (passed from parent workflow)
workflow_mode: "deep_dive"
diff --git a/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml b/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml
index 61c22feb..f62aba9b 100644
--- a/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml
+++ b/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml
@@ -4,22 +4,22 @@ description: "Complete project documentation workflow (initial scan or full resc
author: "BMad"
# This is a sub-workflow called by document-project/workflow.yaml
-parent_workflow: "{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml"
+parent_workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
# Critical variables inherited from parent
-config_source: "{project-root}/.bmad/bmb/config.yaml"
+config_source: "{project-root}/_bmad/bmb/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
date: system-generated
# Data files
-documentation_requirements_csv: "{project-root}/.bmad/bmm/workflows/document-project/documentation-requirements.csv"
+documentation_requirements_csv: "{project-root}/_bmad/bmm/workflows/document-project/documentation-requirements.csv"
# Module path and component files
-installed_path: "{project-root}/.bmad/bmm/workflows/document-project/workflows"
+installed_path: "{project-root}/_bmad/bmm/workflows/document-project/workflows"
template: false # Action workflow
instructions: "{installed_path}/full-scan-instructions.md"
-validation: "{project-root}/.bmad/bmm/workflows/document-project/checklist.md"
+validation: "{project-root}/_bmad/bmm/workflows/document-project/checklist.md"
# Runtime inputs (passed from parent workflow)
workflow_mode: "" # "initial_scan" or "full_rescan"
diff --git a/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md b/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md
index b301b9e2..122bb0e8 100644
--- a/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md
+++ b/src/modules/bmm/workflows/generate-project-context/steps/step-02-generate.md
@@ -28,8 +28,8 @@ This step will generate content and present choices for each rule category:
## PROTOCOL INTEGRATION:
-- When 'A' selected: Execute {project-root}/.bmad/core/tasks/advanced-elicitation.xml
-- When 'P' selected: Execute {project-root}/.bmad/core/workflows/party-mode
+- When 'A' selected: Execute {project-root}/\_bmad/core/tasks/advanced-elicitation.xml
+- When 'P' selected: Execute {project-root}/\_bmad/core/workflows/party-mode
- PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
- User accepts/rejects protocol changes before proceeding
diff --git a/src/modules/bmm/workflows/generate-project-context/workflow.md b/src/modules/bmm/workflows/generate-project-context/workflow.md
index 522ff392..db86e620 100644
--- a/src/modules/bmm/workflows/generate-project-context/workflow.md
+++ b/src/modules/bmm/workflows/generate-project-context/workflow.md
@@ -27,7 +27,7 @@ This uses **micro-file architecture** for disciplined execution:
### Configuration Loading
-Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
+Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
@@ -35,7 +35,7 @@ Load config from `{project-root}/.bmad/bmm/config.yaml` and resolve:
### Paths
-- `installed_path` = `{project-root}/.bmad/bmm/workflows/generate-project-context`
+- `installed_path` = `{project-root}/_bmad/bmm/workflows/generate-project-context`
- `template_path` = `{installed_path}/project-context-template.md`
- `output_file` = `{output_folder}/project-context.md`
diff --git a/src/modules/bmm/workflows/testarch/atdd/instructions.md b/src/modules/bmm/workflows/testarch/atdd/instructions.md
index a2f81a6b..5fcb1328 100644
--- a/src/modules/bmm/workflows/testarch/atdd/instructions.md
+++ b/src/modules/bmm/workflows/testarch/atdd/instructions.md
@@ -2,7 +2,7 @@
# Acceptance Test-Driven Development (ATDD)
-**Workflow ID**: `.bmad/bmm/testarch/atdd`
+**Workflow ID**: `_bmad/bmm/testarch/atdd`
**Version**: 4.0 (BMad v6)
---
@@ -54,7 +54,7 @@ Generates failing acceptance tests BEFORE implementation following TDD's red-gre
5. **Load Knowledge Base Fragments**
- **Critical:** Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` to load:
+ **Critical:** Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` to load:
**Core Patterns (Always load):**
- `data-factories.md` - Factory patterns using faker (override patterns, nested factories, API seeding, 498 lines, 5 examples)
diff --git a/src/modules/bmm/workflows/testarch/atdd/workflow.yaml b/src/modules/bmm/workflows/testarch/atdd/workflow.yaml
index c084ec4e..12b8808b 100644
--- a/src/modules/bmm/workflows/testarch/atdd/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/atdd/workflow.yaml
@@ -4,7 +4,7 @@ description: "Generate failing acceptance tests before implementation using TDD
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/atdd"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/atdd"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/atdd-checklist-template.md"
diff --git a/src/modules/bmm/workflows/testarch/automate/instructions.md b/src/modules/bmm/workflows/testarch/automate/instructions.md
index 3f494949..7ba8da51 100644
--- a/src/modules/bmm/workflows/testarch/automate/instructions.md
+++ b/src/modules/bmm/workflows/testarch/automate/instructions.md
@@ -2,7 +2,7 @@
# Test Automation Expansion
-**Workflow ID**: `.bmad/bmm/testarch/automate`
+**Workflow ID**: `_bmad/bmm/testarch/automate`
**Version**: 4.0 (BMad v6)
---
@@ -87,7 +87,7 @@ Expands test automation coverage by generating comprehensive test suites at appr
6. **Load Knowledge Base Fragments**
- **Critical:** Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` to load:
+ **Critical:** Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` to load:
**Core Testing Patterns (Always load):**
- `test-levels-framework.md` - Test level selection (E2E vs API vs Component vs Unit with decision matrix, 467 lines, 4 examples)
diff --git a/src/modules/bmm/workflows/testarch/automate/workflow.yaml b/src/modules/bmm/workflows/testarch/automate/workflow.yaml
index 27925a70..e244c051 100644
--- a/src/modules/bmm/workflows/testarch/automate/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/automate/workflow.yaml
@@ -4,7 +4,7 @@ description: "Expand test automation coverage after implementation or analyze ex
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/automate"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/automate"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: false
diff --git a/src/modules/bmm/workflows/testarch/ci/instructions.md b/src/modules/bmm/workflows/testarch/ci/instructions.md
index 2504b933..acca1f80 100644
--- a/src/modules/bmm/workflows/testarch/ci/instructions.md
+++ b/src/modules/bmm/workflows/testarch/ci/instructions.md
@@ -2,7 +2,7 @@
# CI/CD Pipeline Setup
-**Workflow ID**: `.bmad/bmm/testarch/ci`
+**Workflow ID**: `_bmad/bmm/testarch/ci`
**Version**: 4.0 (BMad v6)
---
diff --git a/src/modules/bmm/workflows/testarch/ci/workflow.yaml b/src/modules/bmm/workflows/testarch/ci/workflow.yaml
index cd173c6f..223af205 100644
--- a/src/modules/bmm/workflows/testarch/ci/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/ci/workflow.yaml
@@ -4,7 +4,7 @@ description: "Scaffold CI/CD quality pipeline with test execution, burn-in loops
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/ci"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/ci"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/testarch/framework/instructions.md b/src/modules/bmm/workflows/testarch/framework/instructions.md
index b3459c5d..9f7af84e 100644
--- a/src/modules/bmm/workflows/testarch/framework/instructions.md
+++ b/src/modules/bmm/workflows/testarch/framework/instructions.md
@@ -2,7 +2,7 @@
# Test Framework Setup
-**Workflow ID**: `.bmad/bmm/testarch/framework`
+**Workflow ID**: `_bmad/bmm/testarch/framework`
**Version**: 4.0 (BMad v6)
---
@@ -355,7 +355,7 @@ Read `{config_source}` and check `config.tea_use_playwright_utils`.
**If `config.tea_use_playwright_utils: true` (Playwright Utils Integration):**
-Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` and load:
+Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` and load:
- `overview.md` - Playwright utils installation and design principles
- `fixtures-composition.md` - mergeTests composition with playwright-utils
@@ -375,7 +375,7 @@ Recommend adding burn-in and network-error-monitor to merged fixtures for enhanc
**If `config.tea_use_playwright_utils: false` (Traditional Patterns):**
-Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` and load:
+Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` and load:
- `fixture-architecture.md` - Pure function → fixture → `mergeTests` composition with auto-cleanup (406 lines, 5 examples)
- `data-factories.md` - Faker-based factories with overrides, nested factories, API seeding, auto-cleanup (498 lines, 5 examples)
diff --git a/src/modules/bmm/workflows/testarch/framework/workflow.yaml b/src/modules/bmm/workflows/testarch/framework/workflow.yaml
index da9f9fa0..07fcea0c 100644
--- a/src/modules/bmm/workflows/testarch/framework/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/framework/workflow.yaml
@@ -4,7 +4,7 @@ description: "Initialize production-ready test framework architecture (Playwrigh
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/framework"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/framework"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
diff --git a/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md b/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md
index 66d89c56..36ac99ec 100644
--- a/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md
+++ b/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md
@@ -50,7 +50,7 @@ This workflow performs a comprehensive assessment of non-functional requirements
**Actions:**
-1. Load relevant knowledge fragments from `{project-root}/.bmad/bmm/testarch/tea-index.csv`:
+1. Load relevant knowledge fragments from `{project-root}/_bmad/bmm/testarch/tea-index.csv`:
- `nfr-criteria.md` - Non-functional requirements criteria and thresholds (security, performance, reliability, maintainability with code examples, 658 lines, 4 examples)
- `ci-burn-in.md` - CI/CD burn-in patterns for reliability validation (10-iteration detection, sharding, selective execution, 678 lines, 4 examples)
- `test-quality.md` - Test quality expectations for maintainability (deterministic, isolated, explicit assertions, length/time limits, 658 lines, 5 examples)
diff --git a/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml b/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml
index db71579e..ce3f7381 100644
--- a/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml
@@ -4,7 +4,7 @@ description: "Assess non-functional requirements (performance, security, reliabi
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/nfr-assess"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/nfr-assess"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/nfr-report-template.md"
diff --git a/src/modules/bmm/workflows/testarch/test-design/instructions.md b/src/modules/bmm/workflows/testarch/test-design/instructions.md
index 37bf4135..1aa22a3d 100644
--- a/src/modules/bmm/workflows/testarch/test-design/instructions.md
+++ b/src/modules/bmm/workflows/testarch/test-design/instructions.md
@@ -2,7 +2,7 @@
# Test Design and Risk Assessment
-**Workflow ID**: `.bmad/bmm/testarch/test-design`
+**Workflow ID**: `_bmad/bmm/testarch/test-design`
**Version**: 4.0 (BMad v6)
---
@@ -74,7 +74,7 @@ The workflow auto-detects which mode to use based on project phase.
3. **Load Knowledge Base Fragments (System-Level)**
- **Critical:** Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` to load:
+ **Critical:** Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` to load:
- `nfr-criteria.md` - NFR validation approach (security, performance, reliability, maintainability)
- `test-levels-framework.md` - Test levels strategy guidance
- `risk-governance.md` - Testability risk identification
@@ -108,7 +108,7 @@ The workflow auto-detects which mode to use based on project phase.
4. **Load Knowledge Base Fragments (Epic-Level)**
- **Critical:** Consult `{project-root}/.bmad/bmm/testarch/tea-index.csv` to load:
+ **Critical:** Consult `{project-root}/_bmad/bmm/testarch/tea-index.csv` to load:
- `risk-governance.md` - Risk classification framework (6 categories: TECH, SEC, PERF, DATA, BUS, OPS), automated scoring, gate decision engine, owner tracking (625 lines, 4 examples)
- `probability-impact.md` - Risk scoring methodology (probability × impact matrix, automated classification, dynamic re-assessment, gate integration, 604 lines, 4 examples)
- `test-levels-framework.md` - Test level selection guidance (E2E vs API vs Component vs Unit with decision matrix, characteristics, when to use each, 467 lines, 4 examples)
diff --git a/src/modules/bmm/workflows/testarch/test-design/test-design-template.md b/src/modules/bmm/workflows/testarch/test-design/test-design-template.md
index 188530b5..829e6e3a 100644
--- a/src/modules/bmm/workflows/testarch/test-design/test-design-template.md
+++ b/src/modules/bmm/workflows/testarch/test-design/test-design-template.md
@@ -281,5 +281,5 @@
---
**Generated by**: BMad TEA Agent - Test Architect Module
-**Workflow**: `.bmad/bmm/testarch/test-design`
+**Workflow**: `_bmad/bmm/testarch/test-design`
**Version**: 4.0 (BMad v6)
diff --git a/src/modules/bmm/workflows/testarch/test-design/workflow.yaml b/src/modules/bmm/workflows/testarch/test-design/workflow.yaml
index 176230e0..b5fbd661 100644
--- a/src/modules/bmm/workflows/testarch/test-design/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/test-design/workflow.yaml
@@ -4,7 +4,7 @@ description: "Dual-mode workflow: (1) System-level testability review in Solutio
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/test-design"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/test-design"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/test-design-template.md"
diff --git a/src/modules/bmm/workflows/testarch/test-review/instructions.md b/src/modules/bmm/workflows/testarch/test-review/instructions.md
index c308db79..d817d2a6 100644
--- a/src/modules/bmm/workflows/testarch/test-review/instructions.md
+++ b/src/modules/bmm/workflows/testarch/test-review/instructions.md
@@ -52,7 +52,7 @@ This workflow performs comprehensive test quality reviews using TEA's knowledge
1. Check playwright-utils flag:
- Read `{config_source}` and check `config.tea_use_playwright_utils`
-2. Load relevant knowledge fragments from `{project-root}/.bmad/bmm/testarch/tea-index.csv`:
+2. Load relevant knowledge fragments from `{project-root}/_bmad/bmm/testarch/tea-index.csv`:
**Core Patterns (Always load):**
- `test-quality.md` - Definition of Done (deterministic tests, isolated with cleanup, explicit assertions, <300 lines, <1.5 min, 658 lines, 5 examples)
diff --git a/src/modules/bmm/workflows/testarch/test-review/workflow.yaml b/src/modules/bmm/workflows/testarch/test-review/workflow.yaml
index d44f8302..58dad5ee 100644
--- a/src/modules/bmm/workflows/testarch/test-review/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/test-review/workflow.yaml
@@ -4,7 +4,7 @@ description: "Review test quality using comprehensive knowledge base and best pr
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/test-review"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/test-review"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/test-review-template.md"
diff --git a/src/modules/bmm/workflows/testarch/trace/instructions.md b/src/modules/bmm/workflows/testarch/trace/instructions.md
index 645fa65c..77e930c1 100644
--- a/src/modules/bmm/workflows/testarch/trace/instructions.md
+++ b/src/modules/bmm/workflows/testarch/trace/instructions.md
@@ -64,7 +64,7 @@ This phase focuses on mapping requirements to tests, analyzing coverage, and ide
**Actions:**
-1. Load relevant knowledge fragments from `{project-root}/.bmad/bmm/testarch/tea-index.csv`:
+1. Load relevant knowledge fragments from `{project-root}/_bmad/bmm/testarch/tea-index.csv`:
- `test-priorities-matrix.md` - P0/P1/P2/P3 risk framework with automated priority calculation, risk-based mapping, tagging strategy (389 lines, 2 examples)
- `risk-governance.md` - Risk-based testing approach: 6 categories (TECH, SEC, PERF, DATA, BUS, OPS), automated scoring, gate decision engine, coverage traceability (625 lines, 4 examples)
- `probability-impact.md` - Risk scoring methodology: probability × impact matrix, automated classification, dynamic re-assessment, gate integration (604 lines, 4 examples)
@@ -476,10 +476,10 @@ This phase uses traceability results to make a quality gate decision (PASS/CONCE
## References
-- Traceability Matrix: `.bmad/output/traceability-matrix.md`
-- Test Design: `.bmad/output/test-design-epic-2.md`
+- Traceability Matrix: `_bmad/output/traceability-matrix.md`
+- Test Design: `_bmad/output/test-design-epic-2.md`
- Test Results: `ci-artifacts/test-report-2025-01-15.xml`
-- NFR Assessment: `.bmad/output/nfr-assessment-release-1.2.md`
+- NFR Assessment: `_bmad/output/nfr-assessment-release-1.2.md`
```
3. **Include evidence links** (if `require_evidence: true`):
@@ -515,7 +515,7 @@ This phase uses traceability results to make a quality gate decision (PASS/CONCE
- **Decision**: CONCERNS
- **Reason**: P1 coverage 88% (below 90%)
- - **Document**: [gate-decision-story-1.3.md](.bmad/output/gate-decision-story-1.3.md)
+ - **Document**: [gate-decision-story-1.3.md](_bmad/output/gate-decision-story-1.3.md)
- **Action**: Deploy with follow-up story for AC-5
```
@@ -536,7 +536,7 @@ This phase uses traceability results to make a quality gate decision (PASS/CONCE
- Create follow-up story for AC-5 E2E test
- Deploy to staging for validation
- Full Report: .bmad/output/gate-decision-story-1.3.md
+ Full Report: _bmad/output/gate-decision-story-1.3.md
```
3. **Request sign-off** (if `require_sign_off: true`):
diff --git a/src/modules/bmm/workflows/testarch/trace/workflow.yaml b/src/modules/bmm/workflows/testarch/trace/workflow.yaml
index 41eb0e5f..fc5193ef 100644
--- a/src/modules/bmm/workflows/testarch/trace/workflow.yaml
+++ b/src/modules/bmm/workflows/testarch/trace/workflow.yaml
@@ -4,7 +4,7 @@ description: "Generate requirements-to-tests traceability matrix, analyze covera
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ document_output_language: "{config_source}:document_output_language"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/testarch/trace"
+installed_path: "{project-root}/_bmad/bmm/workflows/testarch/trace"
instructions: "{installed_path}/instructions.md"
validation: "{installed_path}/checklist.md"
template: "{installed_path}/trace-template.md"
diff --git a/src/modules/bmm/workflows/workflow-status/init/instructions.md b/src/modules/bmm/workflows/workflow-status/init/instructions.md
index 92f63e45..6fd628e5 100644
--- a/src/modules/bmm/workflows/workflow-status/init/instructions.md
+++ b/src/modules/bmm/workflows/workflow-status/init/instructions.md
@@ -1,6 +1,6 @@
# Workflow Init - Project Setup Instructions
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: workflow-init/workflow.yaml
Communicate in {communication_language} with {user_name}
This workflow handles BOTH new projects AND legacy projects following the BMad Method
diff --git a/src/modules/bmm/workflows/workflow-status/init/workflow.yaml b/src/modules/bmm/workflows/workflow-status/init/workflow.yaml
index 19204b88..da42ebcc 100644
--- a/src/modules/bmm/workflows/workflow-status/init/workflow.yaml
+++ b/src/modules/bmm/workflows/workflow-status/init/workflow.yaml
@@ -4,7 +4,7 @@ description: "Initialize a new BMM project by determining level, type, and creat
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
sprint_artifacts: "{config_source}:sprint_artifacts"
user_name: "{config_source}:user_name"
@@ -15,12 +15,12 @@ user_skill_level: "{config_source}:user_skill_level"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/workflow-status/init"
+installed_path: "{project-root}/_bmad/bmm/workflows/workflow-status/init"
instructions: "{installed_path}/instructions.md"
-template: "{project-root}/.bmad/bmm/workflows/workflow-status/workflow-status-template.yaml"
+template: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow-status-template.yaml"
# Path data files
-path_files: "{project-root}/.bmad/bmm/workflows/workflow-status/paths/"
+path_files: "{project-root}/_bmad/bmm/workflows/workflow-status/paths/"
# Output configuration
default_output_file: "{output_folder}/bmm-workflow-status.yaml"
diff --git a/src/modules/bmm/workflows/workflow-status/instructions.md b/src/modules/bmm/workflows/workflow-status/instructions.md
index 93d04302..28df92b7 100644
--- a/src/modules/bmm/workflows/workflow-status/instructions.md
+++ b/src/modules/bmm/workflows/workflow-status/instructions.md
@@ -1,7 +1,7 @@
# Workflow Status Check - Multi-Mode Service
-The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml
+The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project-root}/\_bmad/bmm/workflows/workflow-status/workflow.yaml
This workflow operates in multiple modes: interactive (default), validate, data, init-check, update
Other workflows can call this as a service to avoid duplicating status logic
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
@@ -42,7 +42,7 @@
Launching workflow-init to set up your project tracking...
-
+
Exit workflow and let workflow-init take over
diff --git a/src/modules/bmm/workflows/workflow-status/project-levels.yaml b/src/modules/bmm/workflows/workflow-status/project-levels.yaml
index f47f7f44..628573ec 100644
--- a/src/modules/bmm/workflows/workflow-status/project-levels.yaml
+++ b/src/modules/bmm/workflows/workflow-status/project-levels.yaml
@@ -1,5 +1,5 @@
# BMM Project Scale Levels - Source of Truth
-# Reference: /.bmad/bmm/README.md lines 77-85
+# Reference: /_bmad/bmm/README.md lines 77-85
levels:
0:
diff --git a/src/modules/bmm/workflows/workflow-status/workflow.yaml b/src/modules/bmm/workflows/workflow-status/workflow.yaml
index c2576104..946489e1 100644
--- a/src/modules/bmm/workflows/workflow-status/workflow.yaml
+++ b/src/modules/bmm/workflows/workflow-status/workflow.yaml
@@ -4,7 +4,7 @@ description: 'Lightweight status checker - answers "what should I do now?" for a
author: "BMad"
# Critical variables from config
-config_source: "{project-root}/.bmad/bmm/config.yaml"
+config_source: "{project-root}/_bmad/bmm/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ user_skill_level: "{config_source}:user_skill_level"
date: system-generated
# Workflow components
-installed_path: "{project-root}/.bmad/bmm/workflows/workflow-status"
+installed_path: "{project-root}/_bmad/bmm/workflows/workflow-status"
instructions: "{installed_path}/instructions.md"
# Template for status file creation (used by workflow-init)
diff --git a/src/modules/cis/agents/README.md b/src/modules/cis/agents/README.md
index bf9edf91..9b18a2ba 100644
--- a/src/modules/cis/agents/README.md
+++ b/src/modules/cis/agents/README.md
@@ -96,7 +96,7 @@ Every CIS agent includes:
## Configuration
-All agents load configuration from `/.bmad/cis/config.yaml`:
+All agents load configuration from `/_bmad/cis/config.yaml`:
- `project_name` - Project identification
- `output_folder` - Where workflow results are saved
diff --git a/src/modules/cis/agents/brainstorming-coach.agent.yaml b/src/modules/cis/agents/brainstorming-coach.agent.yaml
index 3c7bde5f..fc2df635 100644
--- a/src/modules/cis/agents/brainstorming-coach.agent.yaml
+++ b/src/modules/cis/agents/brainstorming-coach.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/brainstorming-coach.md"
+ id: "_bmad/cis/agents/brainstorming-coach.md"
name: Carson
title: Elite Brainstorming Specialist
icon: 🧠
@@ -16,14 +16,14 @@ agent:
menu:
- trigger: brainstorm
- workflow: "{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml"
+ workflow: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
description: Guide me through Brainstorming any topic
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/agents/creative-problem-solver.agent.yaml b/src/modules/cis/agents/creative-problem-solver.agent.yaml
index ac886ebd..9e30b37f 100644
--- a/src/modules/cis/agents/creative-problem-solver.agent.yaml
+++ b/src/modules/cis/agents/creative-problem-solver.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/creative-problem-solver.md"
+ id: "_bmad/cis/agents/creative-problem-solver.md"
name: Dr. Quinn
title: Master Problem Solver
icon: 🔬
@@ -16,14 +16,14 @@ agent:
menu:
- trigger: solve
- workflow: "{project-root}/.bmad/cis/workflows/problem-solving/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml"
description: Apply systematic problem-solving methodologies
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/agents/design-thinking-coach.agent.yaml b/src/modules/cis/agents/design-thinking-coach.agent.yaml
index b81e4b8c..ac2c37b7 100644
--- a/src/modules/cis/agents/design-thinking-coach.agent.yaml
+++ b/src/modules/cis/agents/design-thinking-coach.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/design-thinking-coach.md"
+ id: "_bmad/cis/agents/design-thinking-coach.md"
name: Maya
title: Design Thinking Maestro
icon: 🎨
@@ -16,14 +16,14 @@ agent:
menu:
- trigger: design
- workflow: "{project-root}/.bmad/cis/workflows/design-thinking/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/design-thinking/workflow.yaml"
description: Guide human-centered design process
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/agents/innovation-strategist.agent.yaml b/src/modules/cis/agents/innovation-strategist.agent.yaml
index ccb94bba..7684ce3a 100644
--- a/src/modules/cis/agents/innovation-strategist.agent.yaml
+++ b/src/modules/cis/agents/innovation-strategist.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/innovation-strategist.md"
+ id: "_bmad/cis/agents/innovation-strategist.md"
name: Victor
title: Disruptive Innovation Oracle
icon: ⚡
@@ -16,14 +16,14 @@ agent:
menu:
- trigger: innovate
- workflow: "{project-root}/.bmad/cis/workflows/innovation-strategy/workflow.yaml"
+ workflow: "{project-root}/_bmad/cis/workflows/innovation-strategy/workflow.yaml"
description: Identify disruption opportunities and business model innovation
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/agents/presentation-master.agent.yaml b/src/modules/cis/agents/presentation-master.agent.yaml
index e879d81a..84e01bbd 100644
--- a/src/modules/cis/agents/presentation-master.agent.yaml
+++ b/src/modules/cis/agents/presentation-master.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/presentation-master.md"
+ id: "_bmad/cis/agents/presentation-master.md"
name: Caravaggio
title: Visual Communication + Presentation Expert
icon: 🎨
@@ -52,10 +52,10 @@ agent:
description: Generate single expressive image that explains ideas creatively and memorably
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/agents/storyteller.agent.yaml b/src/modules/cis/agents/storyteller.agent.yaml
index a479839b..dee40280 100644
--- a/src/modules/cis/agents/storyteller.agent.yaml
+++ b/src/modules/cis/agents/storyteller.agent.yaml
@@ -2,7 +2,7 @@
agent:
metadata:
- id: ".bmad/cis/agents/storyteller.md"
+ id: "_bmad/cis/agents/storyteller.md"
name: Sophia
title: Master Storyteller
icon: 📖
@@ -16,14 +16,14 @@ agent:
menu:
- trigger: story
- exec: "{project-root}/.bmad/cis/workflows/storytelling/workflow.yaml"
+ exec: "{project-root}/_bmad/cis/workflows/storytelling/workflow.yaml"
description: Craft compelling narrative using proven frameworks
- trigger: party-mode
- exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
+ exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
description: Consult with other expert agents from the party
- trigger: advanced-elicitation
- exec: "{project-root}/.bmad/core/tasks/advanced-elicitation.xml"
+ exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
description: Advanced elicitation techniques to challenge the LLM to get better results
web-only: true
diff --git a/src/modules/cis/readme.md b/src/modules/cis/readme.md
index 3316e74f..51dc4bff 100644
--- a/src/modules/cis/readme.md
+++ b/src/modules/cis/readme.md
@@ -103,7 +103,7 @@ agent cis/brainstorming-coach
## Configuration
-Edit `/.bmad/cis/config.yaml`:
+Edit `/_bmad/cis/config.yaml`:
```yaml
output_folder: ./creative-outputs
diff --git a/src/modules/cis/workflows/README.md b/src/modules/cis/workflows/README.md
index f500ec5e..5305e27b 100644
--- a/src/modules/cis/workflows/README.md
+++ b/src/modules/cis/workflows/README.md
@@ -98,7 +98,7 @@ agent cis/brainstorming-coach
## Configuration
-Edit `/.bmad/cis/config.yaml`:
+Edit `/_bmad/cis/config.yaml`:
| Setting | Purpose | Default |
| ---------------------- | ----------------------- | ------------------ |
diff --git a/src/modules/cis/workflows/design-thinking/instructions.md b/src/modules/cis/workflows/design-thinking/instructions.md
index a42afd72..8cc88b60 100644
--- a/src/modules/cis/workflows/design-thinking/instructions.md
+++ b/src/modules/cis/workflows/design-thinking/instructions.md
@@ -1,7 +1,7 @@
# Design Thinking Workflow Instructions
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project_root}/.bmad/cis/workflows/design-thinking/workflow.yaml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project_root}/\_bmad/cis/workflows/design-thinking/workflow.yaml
Load and understand design methods from: {design_methods}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
⚠️ CHECKPOINT PROTOCOL: After EVERY tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.
diff --git a/src/modules/cis/workflows/design-thinking/workflow.yaml b/src/modules/cis/workflows/design-thinking/workflow.yaml
index 26c90f4d..c5f0a0a5 100644
--- a/src/modules/cis/workflows/design-thinking/workflow.yaml
+++ b/src/modules/cis/workflows/design-thinking/workflow.yaml
@@ -4,7 +4,7 @@ description: "Guide human-centered design processes using empathy-driven methodo
author: "BMad"
# Critical variables load from config_source
-config_source: "{project-root}/.bmad/cis/config.yaml"
+config_source: "{project-root}/_bmad/cis/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ date: system-generated
# Example: data="{path}/product-context.md" provides project context
# Module path and component files
-installed_path: "{project-root}/.bmad/cis/workflows/design-thinking"
+installed_path: "{project-root}/_bmad/cis/workflows/design-thinking"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
@@ -30,9 +30,9 @@ web_bundle:
name: "design-thinking"
description: "Guide human-centered design processes using empathy-driven methodologies. This workflow walks through the design thinking phases - Empathize, Define, Ideate, Prototype, and Test - to create solutions deeply rooted in user needs."
author: "BMad"
- instructions: ".bmad/cis/workflows/design-thinking/instructions.md"
- template: ".bmad/cis/workflows/design-thinking/template.md"
+ instructions: "_bmad/cis/workflows/design-thinking/instructions.md"
+ template: "_bmad/cis/workflows/design-thinking/template.md"
web_bundle_files:
- - ".bmad/cis/workflows/design-thinking/instructions.md"
- - ".bmad/cis/workflows/design-thinking/template.md"
- - ".bmad/cis/workflows/design-thinking/design-methods.csv"
+ - "_bmad/cis/workflows/design-thinking/instructions.md"
+ - "_bmad/cis/workflows/design-thinking/template.md"
+ - "_bmad/cis/workflows/design-thinking/design-methods.csv"
diff --git a/src/modules/cis/workflows/innovation-strategy/instructions.md b/src/modules/cis/workflows/innovation-strategy/instructions.md
index 64e591c1..ef158a85 100644
--- a/src/modules/cis/workflows/innovation-strategy/instructions.md
+++ b/src/modules/cis/workflows/innovation-strategy/instructions.md
@@ -1,7 +1,7 @@
# Innovation Strategy Workflow Instructions
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project_root}/.bmad/cis/workflows/innovation-strategy/workflow.yaml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project_root}/\_bmad/cis/workflows/innovation-strategy/workflow.yaml
Load and understand innovation frameworks from: {innovation_frameworks}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
⚠️ CHECKPOINT PROTOCOL: After EVERY tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.
diff --git a/src/modules/cis/workflows/innovation-strategy/workflow.yaml b/src/modules/cis/workflows/innovation-strategy/workflow.yaml
index 70651aa5..907915c4 100644
--- a/src/modules/cis/workflows/innovation-strategy/workflow.yaml
+++ b/src/modules/cis/workflows/innovation-strategy/workflow.yaml
@@ -4,7 +4,7 @@ description: "Identify disruption opportunities and architect business model inn
author: "BMad"
# Critical variables load from config_source
-config_source: "{project-root}/.bmad/cis/config.yaml"
+config_source: "{project-root}/_bmad/cis/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ date: system-generated
# Example: data="{path}/industry-analysis.md" provides market context
# Module path and component files
-installed_path: "{project-root}/.bmad/cis/workflows/innovation-strategy"
+installed_path: "{project-root}/_bmad/cis/workflows/innovation-strategy"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
@@ -30,9 +30,9 @@ web_bundle:
name: "innovation-strategy"
description: "Identify disruption opportunities and architect business model innovation. This workflow guides strategic analysis of markets, competitive dynamics, and business model innovation to uncover sustainable competitive advantages and breakthrough opportunities."
author: "BMad"
- instructions: ".bmad/cis/workflows/innovation-strategy/instructions.md"
- template: ".bmad/cis/workflows/innovation-strategy/template.md"
+ instructions: "_bmad/cis/workflows/innovation-strategy/instructions.md"
+ template: "_bmad/cis/workflows/innovation-strategy/template.md"
web_bundle_files:
- - ".bmad/cis/workflows/innovation-strategy/instructions.md"
- - ".bmad/cis/workflows/innovation-strategy/template.md"
- - ".bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv"
+ - "_bmad/cis/workflows/innovation-strategy/instructions.md"
+ - "_bmad/cis/workflows/innovation-strategy/template.md"
+ - "_bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv"
diff --git a/src/modules/cis/workflows/problem-solving/instructions.md b/src/modules/cis/workflows/problem-solving/instructions.md
index 5f2c3fdd..b3c3a7b3 100644
--- a/src/modules/cis/workflows/problem-solving/instructions.md
+++ b/src/modules/cis/workflows/problem-solving/instructions.md
@@ -1,7 +1,7 @@
# Problem Solving Workflow Instructions
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project_root}/.bmad/cis/workflows/problem-solving/workflow.yaml
+The workflow execution engine is governed by: {project_root}/\_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project_root}/\_bmad/cis/workflows/problem-solving/workflow.yaml
Load and understand solving methods from: {solving_methods}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
⚠️ CHECKPOINT PROTOCOL: After EVERY tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.
diff --git a/src/modules/cis/workflows/problem-solving/workflow.yaml b/src/modules/cis/workflows/problem-solving/workflow.yaml
index 97e8694b..09559c8e 100644
--- a/src/modules/cis/workflows/problem-solving/workflow.yaml
+++ b/src/modules/cis/workflows/problem-solving/workflow.yaml
@@ -4,7 +4,7 @@ description: "Apply systematic problem-solving methodologies to crack complex ch
author: "BMad"
# Critical variables load from config_source
-config_source: "{project-root}/.bmad/cis/config.yaml"
+config_source: "{project-root}/_bmad/cis/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ date: system-generated
# Example: data="{path}/problem-brief.md" provides context
# Module path and component files
-installed_path: "{project-root}/.bmad/cis/workflows/problem-solving"
+installed_path: "{project-root}/_bmad/cis/workflows/problem-solving"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
@@ -30,9 +30,9 @@ web_bundle:
name: "problem-solving"
description: "Apply systematic problem-solving methodologies to crack complex challenges. This workflow guides through problem diagnosis, root cause analysis, creative solution generation, evaluation, and implementation planning using proven frameworks."
author: "BMad"
- instructions: ".bmad/cis/workflows/problem-solving/instructions.md"
- template: ".bmad/cis/workflows/problem-solving/template.md"
+ instructions: "_bmad/cis/workflows/problem-solving/instructions.md"
+ template: "_bmad/cis/workflows/problem-solving/template.md"
web_bundle_files:
- - ".bmad/cis/workflows/problem-solving/instructions.md"
- - ".bmad/cis/workflows/problem-solving/template.md"
- - ".bmad/cis/workflows/problem-solving/solving-methods.csv"
+ - "_bmad/cis/workflows/problem-solving/instructions.md"
+ - "_bmad/cis/workflows/problem-solving/template.md"
+ - "_bmad/cis/workflows/problem-solving/solving-methods.csv"
diff --git a/src/modules/cis/workflows/storytelling/instructions.md b/src/modules/cis/workflows/storytelling/instructions.md
index 811e625b..0c0fcbe3 100644
--- a/src/modules/cis/workflows/storytelling/instructions.md
+++ b/src/modules/cis/workflows/storytelling/instructions.md
@@ -3,8 +3,8 @@
## Workflow
-The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml
-You MUST have already loaded and processed: {project_root}/.bmad/cis/workflows/storytelling/workflow.yaml
+The workflow execution engine is governed by: {project_root}/_bmad/core/tasks/workflow.xml
+You MUST have already loaded and processed: {project_root}/_bmad/cis/workflows/storytelling/workflow.yaml
Communicate all responses in {communication_language}
⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.
⚠️ CHECKPOINT PROTOCOL: After EVERY tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.
diff --git a/src/modules/cis/workflows/storytelling/workflow.yaml b/src/modules/cis/workflows/storytelling/workflow.yaml
index 49f57513..ddc5a62f 100644
--- a/src/modules/cis/workflows/storytelling/workflow.yaml
+++ b/src/modules/cis/workflows/storytelling/workflow.yaml
@@ -4,7 +4,7 @@ description: "Craft compelling narratives using proven story frameworks and tech
author: "BMad"
# Critical variables load from config_source
-config_source: "{project-root}/.bmad/cis/config.yaml"
+config_source: "{project-root}/_bmad/cis/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ date: system-generated
# Example: data="{path}/brand-info.md" provides brand context
# Module path and component files
-installed_path: "{project-root}/.bmad/cis/workflows/storytelling"
+installed_path: "{project-root}/_bmad/cis/workflows/storytelling"
template: "{installed_path}/template.md"
instructions: "{installed_path}/instructions.md"
@@ -30,9 +30,9 @@ web_bundle:
name: "storytelling"
description: "Craft compelling narratives using proven story frameworks and techniques. This workflow guides users through structured narrative development, applying appropriate story frameworks to create emotionally resonant and engaging stories for any purpose."
author: "BMad"
- instructions: ".bmad/cis/workflows/storytelling/instructions.md"
- template: ".bmad/cis/workflows/storytelling/template.md"
+ instructions: "_bmad/cis/workflows/storytelling/instructions.md"
+ template: "_bmad/cis/workflows/storytelling/template.md"
web_bundle_files:
- - ".bmad/cis/workflows/storytelling/instructions.md"
- - ".bmad/cis/workflows/storytelling/template.md"
- - ".bmad/cis/workflows/storytelling/story-types.csv"
+ - "_bmad/cis/workflows/storytelling/instructions.md"
+ - "_bmad/cis/workflows/storytelling/template.md"
+ - "_bmad/cis/workflows/storytelling/story-types.csv"
diff --git a/src/utility/agent-components/activation-rules.txt b/src/utility/agent-components/activation-rules.txt
new file mode 100644
index 00000000..3a9a6a57
--- /dev/null
+++ b/src/utility/agent-components/activation-rules.txt
@@ -0,0 +1,7 @@
+
+ ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.
+
+ Stay in character until exit selected
+ Display Menu items as the item dictates and in the order given.
+ Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml
+
\ No newline at end of file
diff --git a/src/utility/agent-components/activation-steps.txt b/src/utility/agent-components/activation-steps.txt
new file mode 100644
index 00000000..860be6a7
--- /dev/null
+++ b/src/utility/agent-components/activation-steps.txt
@@ -0,0 +1,13 @@
+ Load persona from this current agent file (already in context)
+ 🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
+ - Load and read {project-root}/_bmad/{{module}}/config.yaml NOW
+ - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
+ - VERIFY: If config not loaded, STOP and report error to user
+ - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
+
+ Remember: user's name is {user_name}
+ {AGENT_SPECIFIC_STEPS}
+ Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of ALL menu items from menu section
+ STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command match
+ On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"
+ When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions
\ No newline at end of file
diff --git a/src/utility/agent-components/agent-command-header.md b/src/utility/agent-components/agent-command-header.md
new file mode 100644
index 00000000..d4f9b5d6
--- /dev/null
+++ b/src/utility/agent-components/agent-command-header.md
@@ -0,0 +1 @@
+You must fully embody this agent's persona and follow all activation instructions, steps and rules exactly as specified. NEVER break character until given an exit command.
diff --git a/src/utility/templates/agent.customize.template.yaml b/src/utility/agent-components/agent.customize.template.yaml
similarity index 100%
rename from src/utility/templates/agent.customize.template.yaml
rename to src/utility/agent-components/agent.customize.template.yaml
diff --git a/src/utility/agent-components/handler-action.txt b/src/utility/agent-components/handler-action.txt
new file mode 100644
index 00000000..21dd31e1
--- /dev/null
+++ b/src/utility/agent-components/handler-action.txt
@@ -0,0 +1,4 @@
+
+ When menu item has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
+ When menu item has: action="text" → Execute the text directly as an inline instruction
+
\ No newline at end of file
diff --git a/src/utility/models/fragments/handler-data.xml b/src/utility/agent-components/handler-data.txt
similarity index 100%
rename from src/utility/models/fragments/handler-data.xml
rename to src/utility/agent-components/handler-data.txt
diff --git a/src/utility/agent-components/handler-exec.txt b/src/utility/agent-components/handler-exec.txt
new file mode 100644
index 00000000..5dbc1368
--- /dev/null
+++ b/src/utility/agent-components/handler-exec.txt
@@ -0,0 +1,6 @@
+
+ When menu item or handler has: exec="path/to/file.md":
+ 1. Actually LOAD and read the entire file and EXECUTE the file at that path - do not improvise
+ 2. Read the complete file and follow all instructions within it
+ 3. If there is data="some/path/data-foo.md" with the same item, pass that data path to the executed file as context.
+
\ No newline at end of file
diff --git a/src/utility/agent-components/handler-multi.txt b/src/utility/agent-components/handler-multi.txt
new file mode 100644
index 00000000..7c8f535a
--- /dev/null
+++ b/src/utility/agent-components/handler-multi.txt
@@ -0,0 +1,14 @@
+
+ When menu item has: type="multi" with nested handlers
+ 1. Display the multi item text as a single menu option
+ 2. Parse all nested handlers within the multi item
+ 3. For each nested handler:
+ - Use the 'match' attribute for fuzzy matching user input (or Exact Match of character code in brackets [])
+ - Execute based on handler attributes (exec, workflow, action)
+ 4. When user input matches a handler's 'match' pattern:
+ - For exec="path/to/file.md": follow the `handler type="exec"` instructions
+ - For workflow="path/to/workflow.yaml": follow the `handler type="workflow"` instructions
+ - For action="...": Perform the specified action directly
+ 5. Support both exact matches and fuzzy matching based on the match attribute
+ 6. If no handler matches, prompt user to choose from available options
+
\ No newline at end of file
diff --git a/src/utility/agent-components/handler-tmpl.txt b/src/utility/agent-components/handler-tmpl.txt
new file mode 100644
index 00000000..a190504b
--- /dev/null
+++ b/src/utility/agent-components/handler-tmpl.txt
@@ -0,0 +1,5 @@
+
+ 1. When menu item has: tmpl="path/to/template.md"
+ 2. Load template file, parse as markdown with {{mustache}} style variables
+ 3. Make template content available as {template} to action/exec/workflow handlers
+
\ No newline at end of file
diff --git a/src/utility/agent-components/handler-validate-workflow.txt b/src/utility/agent-components/handler-validate-workflow.txt
new file mode 100644
index 00000000..aca04055
--- /dev/null
+++ b/src/utility/agent-components/handler-validate-workflow.txt
@@ -0,0 +1,7 @@
+
+ When command has: validate-workflow="path/to/workflow.yaml"
+ 1. You MUST LOAD the file at: {project-root}/_bmad/core/tasks/validate-workflow.xml
+ 2. READ its entire contents and EXECUTE all instructions in that file
+ 3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
+ 4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
+
\ No newline at end of file
diff --git a/src/utility/agent-components/handler-workflow.txt b/src/utility/agent-components/handler-workflow.txt
new file mode 100644
index 00000000..84c0d9ea
--- /dev/null
+++ b/src/utility/agent-components/handler-workflow.txt
@@ -0,0 +1,10 @@
+
+ When menu item has: workflow="path/to/workflow.yaml":
+
+ 1. CRITICAL: Always LOAD {project-root}/_bmad/core/tasks/workflow.xml
+ 2. Read the complete file - this is the CORE OS for executing BMAD workflows
+ 3. Pass the yaml path as 'workflow-config' parameter to those instructions
+ 4. Execute workflow.xml instructions precisely following all steps
+ 5. Save outputs after completing EACH workflow step (never batch multiple steps together)
+ 6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
+
\ No newline at end of file
diff --git a/src/utility/agent-components/menu-handlers.txt b/src/utility/agent-components/menu-handlers.txt
new file mode 100644
index 00000000..3dd1ae9c
--- /dev/null
+++ b/src/utility/agent-components/menu-handlers.txt
@@ -0,0 +1,6 @@
+
+ {DYNAMIC_EXTRACT_LIST}
+
+ {DYNAMIC_HANDLERS}
+
+
diff --git a/src/utility/models/action-command-header.md b/src/utility/models/action-command-header.md
deleted file mode 100644
index e69de29b..00000000
diff --git a/src/utility/models/agent-activation-ide.xml b/src/utility/models/agent-activation-ide.xml
deleted file mode 100644
index 7e47c288..00000000
--- a/src/utility/models/agent-activation-ide.xml
+++ /dev/null
@@ -1,51 +0,0 @@
-
-
- Load persona from this current file containing this activation you are reading now
- Override with {project-root}/.bmad/_cfg/agents/{agent-filename} if exists (replace, not merge)
- Execute critical-actions section if present in current agent XML
- Show greeting + numbered list of ALL commands IN ORDER from current agent's cmds section
- CRITICAL HALT. AWAIT user input. NEVER continue without it.
-
-
- Number → cmd[n] | Text → fuzzy match *commands
- exec, tmpl, data, action, validate-workflow
-
-
- When command has: run-progressive-workflow="path/to/x.yaml" You MUST:
- 1. CRITICAL: Always LOAD {project-root}/.bmad/core/tasks/workflow.xml
- 2. READ its entire contents - the is the CORE OS for EXECUTING workflows
- 3. Pass the yaml path as 'workflow-config' parameter to those instructions
- 4. Follow workflow.xml instructions EXACTLY as written
- 5. Save outputs after EACH section (never batch)
-
-
- When command has: validate-workflow="path/to/workflow.yaml" You MUST:
- 1. You MUST LOAD the file at: {project-root}/.bmad/core/tasks/validate-workflow.xml
- 2. READ its entire contents and EXECUTE all instructions in that file
- 3. Pass the workflow, and also check the workflow location for a checklist.md to pass as the checklist
- 4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
-
-
- When command has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
- When command has: action="text" → Execute the text directly as a critical action prompt
-
-
- When command has: data="path/to/x.json|yaml|yml"
- Load the file, parse as JSON/YAML, make available as {data} to subsequent operations
-
-
- When command has: tmpl="path/to/x.md"
- Load file, parse as markdown with {{mustache}} templates, make available to action/exec/workflow
-
-
- When command has: exec="path"
- Actually LOAD and EXECUTE the file at that path - do not improvise
-
-
-
-
- Stay in character until *exit
- Number all option lists, use letters for sub-options
- Load files ONLY when executing
-
-
\ No newline at end of file
diff --git a/src/utility/models/agent-activation-web.xml b/src/utility/models/agent-activation-web.xml
deleted file mode 100644
index 4545cf0b..00000000
--- a/src/utility/models/agent-activation-web.xml
+++ /dev/null
@@ -1,50 +0,0 @@
-
-
- Load persona from this current agent xml block containing this activation you are reading now
- Show greeting + numbered list of ALL commands IN ORDER from current agent's cmds section
- CRITICAL HALT. AWAIT user input. NEVER continue without it.
-
-
-
- All dependencies are bundled within this XML file as <file> elements with CDATA content.
- When you need to access a file path like ".bmad/core/tasks/workflow.xml":
- 1. Find the <file id=".bmad/core/tasks/workflow.xml"> element in this document
- 2. Extract the content from within the CDATA section
- 3. Use that content as if you read it from the filesystem
-
-
- NEVER attempt to read files from filesystem - all files are bundled in this XML
- File paths starting with ".bmad/" or "{project-root}/.bmad/" refer to <file id="..."> elements
- When instructions reference a file path, locate the corresponding <file> element by matching the id attribute
- YAML files are bundled with only their web_bundle section content (flattened to root level)
-
-
-
- Number → cmd[n] | Text → fuzzy match *commands
- exec, tmpl, data, action, validate-workflow
-
-
- When command has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
- When command has: action="text" → Execute the text directly as a critical action prompt
-
-
- When command has: data="path/to/x.json|yaml|yml"
- Locate <file id="path/to/x.json|yaml|yml"> in this bundle, extract CDATA, parse as JSON/YAML, make available as {data}
-
-
- When command has: tmpl="path/to/x.md"
- Locate <file id="path/to/x.md"> in this bundle, extract CDATA, parse as markdown with {{mustache}} templates
-
-
- When command has: exec="path"
- Locate <file id="path"> in this bundle, extract CDATA, and EXECUTE that content
-
-
-
-
- Stay in character until *exit
- Number all option lists, use letters for sub-options
- All file content is bundled in <file> elements - locate by id attribute
- NEVER attempt filesystem operations - everything is in this XML
-
-
\ No newline at end of file
diff --git a/src/utility/models/agent-command-header.md b/src/utility/models/agent-command-header.md
deleted file mode 100644
index 9f54aaeb..00000000
--- a/src/utility/models/agent-command-header.md
+++ /dev/null
@@ -1 +0,0 @@
-You must fully embody this agent's persona and follow all activation instructions, steps and rules exactly as specified. NEVER break character until given an exit command.
diff --git a/src/utility/models/agent-config-template.md b/src/utility/models/agent-config-template.md
deleted file mode 100644
index 3c35dedf..00000000
--- a/src/utility/models/agent-config-template.md
+++ /dev/null
@@ -1,23 +0,0 @@
-```xml
-
-
-
- ALWAYS respond in {core:communication_language}.
-
-
-
-
-
-
-
-
-
- The users name is {core:user_name}
-
-
-
-
-
-
-
-```
diff --git a/src/utility/models/agent-in-team-activation.xml b/src/utility/models/agent-in-team-activation.xml
deleted file mode 100644
index 19dd4f92..00000000
--- a/src/utility/models/agent-in-team-activation.xml
+++ /dev/null
@@ -1,3 +0,0 @@
-
-
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/activation-rules.xml b/src/utility/models/fragments/activation-rules.xml
deleted file mode 100644
index fa9685cc..00000000
--- a/src/utility/models/fragments/activation-rules.xml
+++ /dev/null
@@ -1,7 +0,0 @@
-
- ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.
-
- Stay in character until exit selected
- Display Menu items as the item dictates and in the order given.
- Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/activation-steps.xml b/src/utility/models/fragments/activation-steps.xml
deleted file mode 100644
index 127fa6fd..00000000
--- a/src/utility/models/fragments/activation-steps.xml
+++ /dev/null
@@ -1,16 +0,0 @@
-Load persona from this current agent file (already in context)
-🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
- - Load and read {project-root}/.bmad/{{module}}/config.yaml NOW
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
- - VERIFY: If config not loaded, STOP and report error to user
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
-Remember: user's name is {user_name}
-{AGENT_SPECIFIC_STEPS}
-Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
- ALL menu items from menu section
-STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command
- match
-On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
- to clarify | No match → show "Not recognized"
-When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions
\ No newline at end of file
diff --git a/src/utility/models/fragments/handler-action.xml b/src/utility/models/fragments/handler-action.xml
deleted file mode 100644
index 1a35a692..00000000
--- a/src/utility/models/fragments/handler-action.xml
+++ /dev/null
@@ -1,4 +0,0 @@
-
- When menu item has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
- When menu item has: action="text" → Execute the text directly as an inline instruction
-
diff --git a/src/utility/models/fragments/handler-exec.xml b/src/utility/models/fragments/handler-exec.xml
deleted file mode 100644
index 4542dc4d..00000000
--- a/src/utility/models/fragments/handler-exec.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-
- When menu item or handler has: exec="path/to/file.md":
- 1. Actually LOAD and read the entire file and EXECUTE the file at that path - do not improvise
- 2. Read the complete file and follow all instructions within it
- 3. If there is data="some/path/data-foo.md" with the same item, pass that data path to the executed file as context.
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/handler-multi.xml b/src/utility/models/fragments/handler-multi.xml
deleted file mode 100644
index da062230..00000000
--- a/src/utility/models/fragments/handler-multi.xml
+++ /dev/null
@@ -1,14 +0,0 @@
-
- When menu item has: type="multi" with nested handlers
- 1. Display the multi item text as a single menu option
- 2. Parse all nested handlers within the multi item
- 3. For each nested handler:
- - Use the 'match' attribute for fuzzy matching user input (or Exact Match of character code in brackets [])
- - Execute based on handler attributes (exec, workflow, action)
- 4. When user input matches a handler's 'match' pattern:
- - For exec="path/to/file.md": follow the `handler type="exec"` instructions
- - For workflow="path/to/workflow.yaml": follow the `handler type="workflow"` instructions
- - For action="...": Perform the specified action directly
- 5. Support both exact matches and fuzzy matching based on the match attribute
- 6. If no handler matches, prompt user to choose from available options
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/handler-tmpl.xml b/src/utility/models/fragments/handler-tmpl.xml
deleted file mode 100644
index c1fc8f4b..00000000
--- a/src/utility/models/fragments/handler-tmpl.xml
+++ /dev/null
@@ -1,5 +0,0 @@
-
- When menu item has: tmpl="path/to/template.md"
- Load template file, parse as markdown with {{mustache}} style variables
- Make template content available as {template} to action/exec/workflow handlers
-
diff --git a/src/utility/models/fragments/handler-validate-workflow.xml b/src/utility/models/fragments/handler-validate-workflow.xml
deleted file mode 100644
index af01e463..00000000
--- a/src/utility/models/fragments/handler-validate-workflow.xml
+++ /dev/null
@@ -1,7 +0,0 @@
-
- When command has: validate-workflow="path/to/workflow.yaml"
- 1. You MUST LOAD the file at: {project-root}/.bmad/core/tasks/validate-workflow.xml
- 2. READ its entire contents and EXECUTE all instructions in that file
- 3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
- 4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/handler-workflow.xml b/src/utility/models/fragments/handler-workflow.xml
deleted file mode 100644
index 72b14887..00000000
--- a/src/utility/models/fragments/handler-workflow.xml
+++ /dev/null
@@ -1,9 +0,0 @@
-
- When menu item has: workflow="path/to/workflow.yaml"
- 1. CRITICAL: Always LOAD {project-root}/.bmad/core/tasks/workflow.xml
- 2. Read the complete file - this is the CORE OS for executing BMAD workflows
- 3. Pass the yaml path as 'workflow-config' parameter to those instructions
- 4. Execute workflow.xml instructions precisely following all steps
- 5. Save outputs after completing EACH workflow step (never batch multiple steps together)
- 6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
-
\ No newline at end of file
diff --git a/src/utility/models/fragments/menu-handlers.xml b/src/utility/models/fragments/menu-handlers.xml
deleted file mode 100644
index c28b6c98..00000000
--- a/src/utility/models/fragments/menu-handlers.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-
- {DYNAMIC_EXTRACT_LIST}
-
-{DYNAMIC_HANDLERS}
-
-
diff --git a/src/utility/models/fragments/web-bundle-activation-steps.xml b/src/utility/models/fragments/web-bundle-activation-steps.xml
deleted file mode 100644
index ce4fa813..00000000
--- a/src/utility/models/fragments/web-bundle-activation-steps.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-Load persona from this current agent XML block containing this activation you are reading now
-{AGENT_SPECIFIC_STEPS}
-Show greeting + numbered list of ALL commands IN ORDER from current agent's menu section
-CRITICAL HALT. AWAIT user input. NEVER continue without it.
-On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
- to clarify | No match → show "Not recognized"
-When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions
-
-
-
- All dependencies are bundled within this XML file as <file> elements with CDATA content.
- When you need to access a file path like ".bmad/core/tasks/workflow.xml":
- 1. Find the <file id=".bmad/core/tasks/workflow.xml"> element in this document
- 2. Extract the content from within the CDATA section
- 3. Use that content as if you read it from the filesystem
-
-
- NEVER attempt to read files from filesystem - all files are bundled in this XML
- File paths starting with ".bmad/" refer to <file id="..."> elements
- When instructions reference a file path, locate the corresponding <file> element by matching the id attribute
- YAML files are bundled with only their web_bundle section content (flattened to root level)
-
-
-
-
- Stay in character until *exit
- Number all option lists, use letters for sub-options
- All file content is bundled in <file> elements - locate by id attribute
- NEVER attempt filesystem operations - everything is in this XML
- Menu triggers use asterisk (*) - display exactly as shown
-
\ No newline at end of file
diff --git a/tools/cli/README.md b/tools/cli/README.md
index 822567cb..ec4f8cff 100644
--- a/tools/cli/README.md
+++ b/tools/cli/README.md
@@ -1,609 +1,3 @@
# BMad CLI Tool
-The BMad CLI handles installation and web bundling for the BMAD-METHOD framework. It compiles YAML agents into two distinct formats: **IDE-integrated agents** (filesystem-aware, customizable) and **web bundles** (self-contained, dependency-embedded).
-
-## Table of Contents
-
-- [BMad CLI Tool](#bmad-cli-tool)
- - [Table of Contents](#table-of-contents)
- - [Overview](#overview)
- - [Commands](#commands)
- - [Installation](#installation)
- - [Bundling](#bundling)
- - [Utilities](#utilities)
- - [Installation System](#installation-system)
- - [Installation Flow](#installation-flow)
- - [IDE Support](#ide-support)
- - [Custom Module Configuration](#custom-module-configuration)
- - [Platform Specifics](#platform-specifics)
- - [Manifest System](#manifest-system)
- - [Advanced Features](#advanced-features)
- - [Bundling System](#bundling-system)
- - [Bundling Flow](#bundling-flow)
- - [Agent Compilation](#agent-compilation)
- - [Compilation Engine](#compilation-engine)
- - [Fragment System](#fragment-system)
- - [Input: Agent YAML](#input-agent-yaml)
- - [Output: IDE (Markdown with XML)](#output-ide-markdown-with-xml)
- - [Architecture](#architecture)
- - [Directory Structure](#directory-structure)
- - [Fragment Library](#fragment-library)
- - [Key Differences: Installation vs Bundling](#key-differences-installation-vs-bundling)
- - [Development Workflows](#development-workflows)
- - [Testing Compilation](#testing-compilation)
- - [Adding New Menu Handlers](#adding-new-menu-handlers)
- - [Regenerating Manifests](#regenerating-manifests)
- - [Related Documentation](#related-documentation)
- - [Support](#support)
-
----
-
-## Overview
-
-The CLI provides two primary functions:
-
-1. **Installation**: Compiles agents from YAML and installs to IDE environments with full customization support
-2. **Bundling**: Packages agents and dependencies into standalone web-ready XML files
-
-Both use the same YAML→XML compilation engine but produce different outputs optimized for their environments.
-
----
-
-## Commands
-
-### Installation
-
-```bash
-# Interactive installation
-npm run install:bmad
-
-# Direct CLI usage
-node tools/cli/bmad-cli.js install --target /path/to/project --modules bmm,bmb --ides codex
-
-# Flags:
-# --target Target project directory
-# --modules Comma-separated: bmm, bmb, cis
-# --ides Comma-separated IDE codes (see IDE Support)
-# --non-interactive Skip all prompts
-```
-
-### Bundling
-
-```bash
-# Bundle all modules
-npm run bundle
-
-# Bundle specific items
-node tools/cli/bundlers/bundle-web.js all # Everything
-node tools/cli/bundlers/bundle-web.js module bmm # One module
-node tools/cli/bundlers/bundle-web.js agent bmm pm # One agent
-```
-
-### Utilities
-
-```bash
-npm run bmad:status # Installation status
-npm run validate:bundles # Validate web bundles
-node tools/cli/regenerate-manifests.js # Regenerate agent-manifest.csv files
-```
-
----
-
-## Installation System
-
-The installer is a multi-stage system that handles agent compilation, IDE integration, module configuration, platform-specific behaviors, and manifest generation.
-
-### Installation Flow
-
-```
-1. Collect User Input
- - Target directory, modules, IDEs
- - Custom module configuration (via module.yaml)
-
-2. Pre-Installation
- - Validate target, check conflicts, backup existing installations
- - Resolve module dependencies (4-pass system)
-
-3. Install Core + Modules
- - Copy files to {target}/.bmad/
- - Compile agents: YAML → Markdown/XML (forWebBundle: false)
- - Merge customize.yaml files if they exist
- - Inject activation blocks based on agent capabilities
-
-4. IDE Integration
- - Initialize selected IDE handlers
- - Generate IDE-specific artifacts (commands/rules/workflows)
- - Execute platform-specific hooks (IDE+module combinations)
-
-5. Generate Manifests
- - manifest.yaml (installation metadata)
- - workflow-manifest.csv (workflow catalog)
- - agent-manifest.csv (agent metadata)
- - task-manifest.csv (legacy)
- - files-manifest.csv (all files with SHA256 hashes)
-
-6. Validate & Finalize
- - Verify file integrity, agent compilation, IDE artifacts
- - Display summary and next steps
-```
-
-**Output Structure**:
-
-```
-{target}/
-├── .bmad/
-│ ├── core/ # Always installed
-│ ├── {module}/ # Selected modules
-│ │ ├── agents/ # Compiled .md files
-│ │ ├── workflows/
-│ │ └── config.yaml
-│ └── _cfg/ # Manifests
-└── .{ide}/ # IDE-specific artifacts
- └── ... # Format varies by IDE
-```
-
-### IDE Support
-
-The installer supports **15 IDE environments** through a base-derived architecture. Each IDE handler extends `BaseIDE` and implements IDE-specific artifact generation.
-
-**Supported IDEs** (as of v6-alpha):
-
-| Code | Name | Artifact Location |
-| ---------------- | ----------------- | ------------------------ |
-| `codex` | Claude Code | `.claude/commands/` |
-| `claude-code` | Claude Code (alt) | `.claude/commands/` |
-| `opencode` | OpenCode | `.opencode` |
-| `windsurf` | Windsurf | `.windsurf/workflows/` |
-| `cursor` | Cursor | `.cursor/rules/` |
-| `cline` | Cline | `.clinerules/workflows/` |
-| `github-copilot` | GitHub Copilot | `.github/copilot/` |
-| `crush` | Crush | `.crush/` |
-| `auggie` | Auggie | `.auggie/` |
-| `gemini` | Google Gemini | `.gemini/` |
-| `qwen` | Qwen | `.qwen/` |
-| `roo` | Roo | `.roo/` |
-| `rovo-dev` | Rovo | `.rovodev/` |
-| `trae` | Trae | `.trae/` |
-| `iflow` | iFlow | `.iflow/` |
-| `kilo` | Kilo | `.kilo/` |
-
-**Handler Architecture**:
-
-- Base class: `tools/cli/installers/lib/ide/_base-ide.js`
-- Handler implementations: `tools/cli/installers/lib/ide/{ide-code}.js`
-- Dynamic discovery: IDE manager scans directory and auto-registers handlers
-- Each handler implements: `setup()`, `createArtifacts()`, `cleanup()`, `getAgentsFromBmad()`
-
-**Adding New IDE Support**:
-
-1. Create handler file: `tools/cli/installers/lib/ide/your-ide.js`
-2. Extend `BaseIDE`, set `ideCode`, `ideName`, `artifactType`
-3. Implement artifact generation methods
-4. IDE auto-discovered on next run
-
-### Custom Module Configuration
-
-Modules define interactive configuration menus via `module.yaml` files in their `_module-installer/` directories.
-
-**Config File Location**:
-
-- Core: `src/core/module.yaml`
-- Modules: `src/modules/{module}/module.yaml`
-
-**Configuration Types**:
-
-- `select`: Radio button choices
-- `multiselect`: Checkboxes
-- `input`: Text input with validation
-- `confirm`: Yes/no
-
-**Variable Substitution**:
-
-- `{project-root}` → Absolute target path
-- `{directory_name}` → Project directory basename
-- `{module}` → Current module name
-- `{value:config_id}` → Reference another config value
-
-**Config Persistence**:
-
-- Values saved to module's `config.yaml`
-- Existing values detected on reinstall
-- User prompted: "Use existing or change?"
-
-**Processor**: `tools/cli/installers/lib/core/config-collector.js`
-
-### Platform Specifics
-
-Platform specifics are **IDE+module combination hooks** that execute custom logic when specific IDE and module are installed together.
-
-**Two-Layer Architecture**:
-
-1. **Module-Level**: `src/modules/{module}/_module-installer/platform-specifics/{ide}.js`
- - Module provides custom behavior for specific IDEs
- - Example: BMM creates subagents when installed with Claude Code
-
-2. **IDE-Level**: Embedded in IDE handler's `createArtifacts()` method
- - IDE provides custom handling for specific modules
- - Example: Windsurf configures cascade workflows for BMM
-
-**Execution Timing**: After standard installation, before validation
-
-**Common Use Cases**:
-
-- Creating subagent variations (PM-technical, PM-market)
-- Configuring IDE-specific workflow integrations
-- Adding custom commands or rules based on module features
-- Adjusting UI/UX for module-specific patterns
-
-**Platform Registry**: `tools/cli/installers/lib/ide/shared/platform-codes.js`
-
-### Manifest System
-
-The installer generates **5 manifest files** in `{target}/.bmad/_cfg/`:
-
-**1. Installation Manifest** (`manifest.yaml`)
-
-- Installation metadata: version, timestamps, target directory
-- Installed modules and versions
-- Integrated IDEs and their configurations
-- User configuration values
-
-**2. Workflow Manifest** (`workflow-manifest.csv`)
-
-- Columns: module, workflow_path, workflow_name, description, scale_level
-- Used by workflow command generators
-- RFC 4180 compliant CSV format
-
-**3. Agent Manifest** (`agent-manifest.csv`)
-
-- Columns: module, agent_path, agent_name, role, identity_summary, communication_style, expertise, approach, responsibilities, workflows
-- 10-column metadata for each agent
-- Used by IDE integrations and documentation
-
-**4. Task Manifest** (`task-manifest.csv`)
-
-- Legacy compatibility (deprecated in v6)
-- Columns: module, task_path, task_name, objective, agent
-
-**5. Files Manifest** (`files-manifest.csv`)
-
-- Complete file tracking with SHA256 hashes
-- Columns: file_path, file_type, module, hash
-- Enables integrity validation and change detection
-
-**Generator**: `tools/cli/installers/lib/core/manifest-generator.js`
-
-**Use Cases**:
-
-- Update detection (compare current vs manifest hashes)
-- Workflow command generation for IDEs
-- Installation validation and integrity checks
-- Rollback capability
-
-### Advanced Features
-
-**Dependency Resolution** (4-Pass System):
-
-- Pass 1: Explicit dependencies from module metadata
-- Pass 2: Template references in workflows
-- Pass 3: Cross-module workflow/agent references
-- Pass 4: Transitive dependencies
-
-**Agent Activation Injection**:
-
-- Detects which handlers each agent uses (workflow, exec, tmpl, data, action)
-- Injects only needed handler fragments from `src/utility/models/fragments/`
-- Keeps compiled agents lean and purpose-built
-
-**Module Injection System**:
-
-- Conditional content injection based on user config
-- Can inject menu items, text blocks, workflow steps
-- File: `tools/cli/installers/lib/ide/shared/module-injections.js`
-
-**Conflict Resolution**:
-
-- Detects existing installations
-- Options: Update (preserve customizations), Backup (timestamp), Cancel
-- Auto-backup to `.bmad-backup-{timestamp}` if selected
-
-**Workflow Command Auto-Generation**:
-
-- Reads workflow-manifest.csv
-- Generates IDE commands for each workflow
-- IDE-specific formatting (Claude Code .md, Windsurf YAML, etc.)
-
-**Validation & Integrity**:
-
-- Verifies all manifest files exist
-- Validates file hashes against files-manifest.csv
-- Checks agent compilation completeness
-- Confirms IDE artifacts created
-
----
-
-## Bundling System
-
-Web bundling creates self-contained XML packages with all dependencies embedded for web deployment.
-
-### Bundling Flow
-
-```
-1. Discover modules and agents from src/modules/
-2. For each agent:
- - Compile with YamlXmlBuilder (forWebBundle: true)
- - Use web-bundle-activation-steps.xml fragment
- - Resolve ALL dependencies recursively:
- - Scan menu items for workflow references
- - Load workflows → extract web_bundle section
- - Find all file references (templates, data, sub-workflows)
- - Wrap each in
- - Build consolidated bundle: agent + all deps
-3. Output to: web-bundles/{module}/agents/{name}.xml
-```
-
-**Key Differences from Installation**:
-
-- No customize.yaml merging (base agents only)
-- No metadata (reduces file size)
-- All dependencies bundled inline (no filesystem access)
-- Uses web-specific activation fragment
-- Output: Standalone XML files
-
-**Output Structure**:
-
-```
-web-bundles/
-├── bmm/
-│ ├── agents/
-│ │ ├── pm.xml
-│ │ ├── architect.xml
-│ │ ├── sm.xml
-│ │ └── dev.xml
-│ └── teams/
-│ └── dev-team.xml
-├── bmb/
-│ └── agents/
-│ └── bmad-builder.xml
-└── cis/
- └── agents/
- └── creative-director.xml
-```
-
-**Bundler**: `tools/cli/bundlers/web-bundler.js`
-
----
-
-## Agent Compilation
-
-Both installation and bundling use the same YAML→XML compiler with different configurations.
-
-### Compilation Engine
-
-**Core File**: `tools/cli/lib/yaml-xml-builder.js`
-
-**Process**:
-
-1. Load YAML agent definition
-2. Merge with customize.yaml (installation only)
-3. Analyze agent to detect required handlers
-4. Build activation block:
- - IDE: Uses `activation-steps.xml` (filesystem-aware)
- - Web: Uses `web-bundle-activation-steps.xml` (bundled files)
-5. Convert to XML structure
-6. Output as markdown (IDE) or standalone XML (web)
-
-**Key Option Flags**:
-
-- `forWebBundle: true` - Use web activation, omit metadata
-- `includeMetadata: true` - Include build hash (IDE only)
-- `skipActivation: true` - Omit activation (team bundles)
-
-### Fragment System
-
-Reusable XML fragments in `src/utility/models/fragments/`:
-
-- `activation-steps.xml` - IDE activation (loads config.yaml at runtime)
-- `web-bundle-activation-steps.xml` - Web activation (uses bundled files)
-- `activation-rules.xml` - Validation rules (IDE only)
-- `menu-handlers.xml` - Menu handler wrapper
-- `handler-workflow.xml` - Workflow handler
-- `handler-exec.xml` - Exec command handler
-- `handler-tmpl.xml` - Template handler
-- `handler-data.xml` - Data handler
-- `handler-action.xml` - Action handler
-
-**Dynamic Injection**: Agent analyzer detects which handlers are used, activation builder injects only those fragments.
-
-### Input: Agent YAML
-
-```yaml
-agent:
- metadata:
- id: 'bmad/bmm/agents/pm.md'
- name: 'PM'
- title: 'Product Manager'
- persona:
- role: 'Product Manager'
- identity: 'You are an experienced PM...'
- menu:
- - trigger: '*create-brief'
- workflow: '{project-root}/.bmad/bmm/workflows/.../workflow.yaml'
-```
-
-### Output: IDE (Markdown with XML)
-
-````markdown
-
-
-# Product Manager
-
-```xml
-
-
- Load {project-root}/.bmad/bmm/config.yaml at runtime
- ...
-
- ...
-
-
-```
-````
-
-````
-
-### Output: Web (Standalone XML)
-
-```xml
-
-
- All dependencies bundled inline below
- ...
-
- ...
-
-
-
-
- ...
-
-
-````
-
----
-
-## Architecture
-
-### Directory Structure
-
-```
-tools/cli/
-├── bmad-cli.js # Main CLI entry
-├── commands/ # CLI command handlers
-│ ├── install.js
-│ ├── status.js
-│ ├── list.js
-│ ├── update.js
-│ └── uninstall.js
-├── bundlers/ # Web bundling
-│ ├── bundle-web.js # CLI entry
-│ └── web-bundler.js # WebBundler class
-├── installers/
-│ └── lib/
-│ ├── core/ # Core installer logic
-│ │ ├── installer.js
-│ │ ├── manifest-generator.js
-│ │ ├── manifest.js
-│ │ ├── dependency-resolver.js
-│ │ ├── config-collector.js
-│ │ └── csv-parser.js
-│ ├── modules/ # Module processing
-│ │ └── manager.js
-│ └── ide/ # IDE integrations
-│ ├── _base-ide.js
-│ ├── {14 IDE handlers}.js
-│ ├── manager.js
-│ └── shared/
-│ ├── bmad-artifacts.js
-│ ├── platform-codes.js
-│ ├── module-injections.js
-│ └── workflow-command-generator.js
-├── lib/ # Shared compilation
-│ ├── yaml-xml-builder.js # YAML→XML compiler
-│ ├── activation-builder.js # Activation generator
-│ ├── agent-analyzer.js # Handler detection
-│ ├── xml-handler.js # Builder wrapper
-│ └── paths.js
-├── regenerate-manifests.js
-└── test-yaml-builder.js
-```
-
-### Fragment Library
-
-```
-src/utility/models/fragments/
-├── activation-steps.xml
-├── web-bundle-activation-steps.xml
-├── activation-rules.xml
-├── menu-handlers.xml
-└── handler-*.xml # 5 handler types
-```
-
----
-
-## Key Differences: Installation vs Bundling
-
-| Aspect | Installation (IDE) | Bundling (Web) |
-| ----------------------- | ----------------------------- | --------------------------------- |
-| **Trigger** | `npm run install:bmad` | `npm run bundle` |
-| **Entry Point** | `commands/install.js` | `bundlers/bundle-web.js` |
-| **Compiler Flag** | `forWebBundle: false` | `forWebBundle: true` |
-| **Output Format** | Markdown `.md` | Standalone XML `.xml` |
-| **Output Location** | `{target}/.bmad/` + IDE dirs | `web-bundles/` |
-| **Customization** | Merges `customize.yaml` | Base agents only |
-| **Dependencies** | Referenced by path | Bundled inline (CDATA) |
-| **Activation Fragment** | `activation-steps.xml` | `web-bundle-activation-steps.xml` |
-| **Filesystem Access** | Required | Not needed |
-| **Build Metadata** | Included (hash) | Excluded |
-| **Path Format** | `{project-root}` placeholders | Stripped, wrapped as `` |
-| **Use Case** | Local IDE development | Web deployment |
-
-**Activation Differences**:
-
-- **IDE**: Loads config.yaml at runtime from filesystem
-- **Web**: Accesses bundled content via `` references
-
----
-
-## Development Workflows
-
-### Testing Compilation
-
-```bash
-# Test YAML→XML compiler
-node tools/cli/test-yaml-builder.js
-
-# Test installation
-node tools/cli/bmad-cli.js install --target ./test-project --modules bmm --ides codex
-
-# Test bundling
-node tools/cli/bundlers/bundle-web.js agent bmm pm
-
-# Validate bundles
-npm run validate:bundles
-```
-
-### Adding New Menu Handlers
-
-To add a new handler type (e.g., `validate-workflow`):
-
-1. Create fragment: `src/utility/models/fragments/handler-validate-workflow.xml`
-2. Update `agent-analyzer.js` to detect the new attribute
-3. Update `activation-builder.js` to load/inject the fragment
-4. Test with an agent using the handler
-
-### Regenerating Manifests
-
-```bash
-# Regenerate agent-manifest.csv for all modules
-node tools/cli/regenerate-manifests.js
-
-# Location: src/modules/{module}/agents/agent-manifest.csv
-```
-
----
-
-## Related Documentation
-
-- **Project Guide**: `CLAUDE.md`
-- **BMM Workflows**: `src/modules/bmm/workflows/README.md`
-- **Module Structure**: `src/modules/bmb/workflows/create-module/module-structure.md`
-- **Agent Creation**: `src/modules/bmb/workflows/create-agent/README.md`
-
----
-
-## Support
-
-- **Issues**:
-- **Discord**: (#general-dev, #bugs-issues)
-- **YouTube**:
+Revised CLI tool docs coming....
diff --git a/tools/cli/commands/build.js b/tools/cli/commands/build.js
index 95d2a77f..ff4419cc 100644
--- a/tools/cli/commands/build.js
+++ b/tools/cli/commands/build.js
@@ -80,7 +80,7 @@ module.exports = {
*/
async function buildAgent(projectDir, agentName) {
// First check standalone agents in bmad/agents/{agentname}/
- const standaloneAgentDir = path.join(projectDir, '.bmad', 'agents', agentName);
+ const standaloneAgentDir = path.join(projectDir, '_bmad', 'agents', agentName);
let standaloneYamlPath = path.join(standaloneAgentDir, `${agentName}.agent.yaml`);
// If exact match doesn't exist, look for any .agent.yaml file in the directory
@@ -99,7 +99,7 @@ async function buildAgent(projectDir, agentName) {
// Build the standalone agent
console.log(chalk.cyan(` Building standalone agent ${agentName}...`));
- const customizePath = path.join(projectDir, '.bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
+ const customizePath = path.join(projectDir, '_bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
const customizeExists = await fs.pathExists(customizePath);
await builder.buildAgent(standaloneYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
@@ -109,7 +109,7 @@ async function buildAgent(projectDir, agentName) {
}
// Find the agent YAML file in .claude/commands/bmad/
- const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', '.bmad');
+ const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', '_bmad');
// Search all module directories for the agent
const modules = await fs.readdir(bmadCommandsDir);
@@ -149,7 +149,7 @@ async function buildAllAgents(projectDir) {
let builtCount = 0;
// First, build standalone agents in bmad/agents/
- const standaloneAgentsDir = path.join(projectDir, '.bmad', 'agents');
+ const standaloneAgentsDir = path.join(projectDir, '_bmad', 'agents');
if (await fs.pathExists(standaloneAgentsDir)) {
console.log(chalk.cyan('\nBuilding standalone agents...'));
const agentDirs = await fs.readdir(standaloneAgentsDir);
@@ -177,7 +177,7 @@ async function buildAllAgents(projectDir) {
console.log(chalk.cyan(` Building standalone agent ${agentName}...`));
- const customizePath = path.join(projectDir, '.bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
+ const customizePath = path.join(projectDir, '_bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
const customizeExists = await fs.pathExists(customizePath);
await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
diff --git a/tools/cli/installers/lib/core/detector.js b/tools/cli/installers/lib/core/detector.js
index 28a91de7..50176dae 100644
--- a/tools/cli/installers/lib/core/detector.js
+++ b/tools/cli/installers/lib/core/detector.js
@@ -135,7 +135,7 @@ class Detector {
}
/**
- * Detect legacy installation (.bmad-method, .bmm, .cis)
+ * Detect legacy installation (_bmad-method, .bmm, .cis)
* @param {string} projectDir - Project directory to check
* @returns {Object} Legacy installation details
*/
@@ -147,8 +147,8 @@ class Detector {
paths: [],
};
- // Check for legacy core (.bmad-method)
- const legacyCorePath = path.join(projectDir, '.bmad-method');
+ // Check for legacy core (_bmad-method)
+ const legacyCorePath = path.join(projectDir, '_bmad-method');
if (await fs.pathExists(legacyCorePath)) {
result.hasLegacy = true;
result.legacyCore = true;
@@ -161,7 +161,7 @@ class Detector {
if (
entry.isDirectory() &&
entry.name.startsWith('.') &&
- entry.name !== '.bmad-method' &&
+ entry.name !== '_bmad-method' &&
!entry.name.startsWith('.git') &&
!entry.name.startsWith('.vscode') &&
!entry.name.startsWith('.idea')
@@ -204,7 +204,7 @@ class Detector {
/**
* Detect legacy BMAD v4 footprints (case-sensitive path checks)
- * V4 used .bmad-method as default folder name
+ * V4 used _bmad-method as default folder name
* V6+ uses configurable folder names and ALWAYS has _cfg/manifest.yaml with installation.version
* @param {string} projectDir - Project directory to check
* @returns {{ hasLegacyV4: boolean, offenders: string[] }}
diff --git a/tools/cli/installers/lib/core/installer.js b/tools/cli/installers/lib/core/installer.js
index aadb34fc..d853aff4 100644
--- a/tools/cli/installers/lib/core/installer.js
+++ b/tools/cli/installers/lib/core/installer.js
@@ -1,23 +1,3 @@
-/**
- * File: tools/cli/installers/lib/core/installer.js
- *
- * BMAD Method - Business Model Agile Development Method
- * Repository: https://github.com/paulpreibisch/BMAD-METHOD
- *
- * Copyright (c) 2025 Paul Preibisch
- * Licensed under the Apache License, Version 2.0
- *
- * ---
- *
- * @fileoverview Core BMAD installation orchestrator with AgentVibes injection point support
- * @context Manages complete BMAD installation flow including core agents, modules, IDE configs, and optional TTS integration
- * @architecture Orchestrator pattern - coordinates Detector, ModuleManager, IdeManager, and file operations to build complete BMAD installation
- * @dependencies fs-extra, ora, chalk, detector.js, module-manager.js, ide-manager.js, config.js
- * @entrypoints Called by install.js command via installer.install(config)
- * @patterns Injection point processing (AgentVibes), placeholder replacement (.bmad), module dependency resolution
- * @related GitHub AgentVibes#34 (injection points), ui.js (user prompts), copyFileWithPlaceholderReplacement()
- */
-
const path = require('node:path');
const fs = require('fs-extra');
const chalk = require('chalk');
@@ -32,13 +12,11 @@ const { Config } = require('../../../lib/config');
const { XmlHandler } = require('../../../lib/xml-handler');
const { DependencyResolver } = require('./dependency-resolver');
const { ConfigCollector } = require('./config-collector');
-// processInstallation no longer needed - LLMs understand {project-root}
const { getProjectRoot, getSourcePath, getModulePath } = require('../../../lib/project-root');
const { AgentPartyGenerator } = require('../../../lib/agent-party-generator');
const { CLIUtils } = require('../../../lib/cli-utils');
const { ManifestGenerator } = require('./manifest-generator');
const { IdeConfigManager } = require('./ide-config-manager');
-const { replaceAgentSidecarFolders } = require('./post-install-sidecar-replacement');
const { CustomHandler } = require('../custom/handler');
class Installer {
@@ -67,7 +45,7 @@ class Installer {
// Check if project directory exists
if (!(await fs.pathExists(projectDir))) {
// Project doesn't exist yet, return default
- return path.join(projectDir, '.bmad');
+ return path.join(projectDir, '_bmad');
}
// V6+ strategy: Look for ANY directory with _cfg/manifest.yaml
@@ -89,13 +67,13 @@ class Installer {
// No V6+ installation found, return default
// This will be used for new installations
- return path.join(projectDir, '.bmad');
+ return path.join(projectDir, '_bmad');
}
/**
* @function copyFileWithPlaceholderReplacement
* @intent Copy files from BMAD source to installation directory with dynamic content transformation
- * @why Enables installation-time customization: .bmad replacement + optional AgentVibes TTS injection
+ * @why Enables installation-time customization: _bmad replacement + optional AgentVibes TTS injection
* @param {string} sourcePath - Absolute path to source file in BMAD repository
* @param {string} targetPath - Absolute path to destination file in user's project
* @param {string} bmadFolderName - User's chosen bmad folder name (default: 'bmad')
@@ -472,8 +450,8 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
});
}
- // Always use .bmad as the folder name
- const bmadFolderName = '.bmad';
+ // Always use _bmad as the folder name
+ const bmadFolderName = '_bmad';
this.bmadFolderName = bmadFolderName; // Store for use in other methods
// Store AgentVibes configuration for injection point processing
@@ -602,7 +580,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// If there are custom files, back them up temporarily
if (customFiles.length > 0) {
- const tempBackupDir = path.join(projectDir, '.bmad-custom-backup-temp');
+ const tempBackupDir = path.join(projectDir, '_bmad-custom-backup-temp');
await fs.ensureDir(tempBackupDir);
spinner.start(`Backing up ${customFiles.length} custom files...`);
@@ -619,7 +597,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// For modified files, back them up to temp directory (will be restored as .bak files after install)
if (modifiedFiles.length > 0) {
- const tempModifiedBackupDir = path.join(projectDir, '.bmad-modified-backup-temp');
+ const tempModifiedBackupDir = path.join(projectDir, '_bmad-modified-backup-temp');
await fs.ensureDir(tempModifiedBackupDir);
console.log(chalk.yellow(`\nDEBUG: Backing up ${modifiedFiles.length} modified files to temp location`));
@@ -653,7 +631,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Back up custom files
if (customFiles.length > 0) {
- const tempBackupDir = path.join(projectDir, '.bmad-custom-backup-temp');
+ const tempBackupDir = path.join(projectDir, '_bmad-custom-backup-temp');
await fs.ensureDir(tempBackupDir);
spinner.start(`Backing up ${customFiles.length} custom files...`);
@@ -669,7 +647,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Back up modified files
if (modifiedFiles.length > 0) {
- const tempModifiedBackupDir = path.join(projectDir, '.bmad-modified-backup-temp');
+ const tempModifiedBackupDir = path.join(projectDir, '_bmad-modified-backup-temp');
await fs.ensureDir(tempModifiedBackupDir);
spinner.start(`Backing up ${modifiedFiles.length} modified files...`);
@@ -1316,29 +1294,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
console.log(chalk.dim('Review the .bak files to see your changes and merge if needed.\n'));
}
- // Reinstall custom agents from _cfg/custom/agents/ sources
- const customAgentResults = await this.reinstallCustomAgents(projectDir, bmadDir);
- if (customAgentResults.count > 0) {
- console.log(chalk.green(`\n✓ Reinstalled ${customAgentResults.count} custom agent${customAgentResults.count > 1 ? 's' : ''}`));
- for (const agent of customAgentResults.agents) {
- console.log(chalk.dim(` - ${agent}`));
- }
- }
-
- // Replace {agent_sidecar_folder} placeholders in all agent files
- console.log(chalk.dim('\n Configuring agent sidecar folders...'));
- const sidecarResults = await replaceAgentSidecarFolders(bmadDir);
-
- if (sidecarResults.filesReplaced > 0) {
- console.log(
- chalk.green(
- ` ✓ Updated ${sidecarResults.filesReplaced} agent file(s) with ${sidecarResults.totalReplacements} sidecar reference(s)`,
- ),
- );
- } else {
- console.log(chalk.dim(' No agent sidecar references found'));
- }
-
// Display completion message
const { UI } = require('../../../lib/ui');
const ui = new UI();
@@ -1852,7 +1807,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Create customize template if it doesn't exist
if (!(await fs.pathExists(customizePath))) {
- const genericTemplatePath = getSourcePath('utility', 'templates', 'agent.customize.template.yaml');
+ const genericTemplatePath = getSourcePath('utility', 'agent-components', 'agent.customize.template.yaml');
if (await fs.pathExists(genericTemplatePath)) {
await this.copyFileWithPlaceholderReplacement(genericTemplatePath, customizePath, this.bmadFolderName || 'bmad');
console.log(chalk.dim(` Created customize: ${moduleName}-${agentName}.customize.yaml`));
@@ -1868,8 +1823,8 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// DO NOT replace {project-root} - LLMs understand this placeholder at runtime
// const processedContent = xmlContent.replaceAll('{project-root}', projectDir);
- // Replace .bmad with actual folder name
- xmlContent = xmlContent.replaceAll('.bmad', this.bmadFolderName || 'bmad');
+ // Replace _bmad with actual folder name
+ xmlContent = xmlContent.replaceAll('_bmad', this.bmadFolderName || 'bmad');
// Replace {agent_sidecar_folder} if configured
const coreConfig = this.configCollector.collectedConfig.core || {};
@@ -1916,7 +1871,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Resolve path variables
const resolvedSidecarFolder = agentSidecarFolder
.replaceAll('{project-root}', projectDir)
- .replaceAll('.bmad', this.bmadFolderName || 'bmad');
+ .replaceAll('_bmad', this.bmadFolderName || 'bmad');
// Create sidecar directory for this agent
const agentSidecarDir = path.join(resolvedSidecarFolder, agentName);
@@ -1942,20 +1897,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
console.log(chalk.dim(` Built agent: ${agentName}.md${hasSidecar ? ' (with sidecar)' : ''}`));
}
- // Handle legacy .md agents - inject activation if needed
- else if (agentFile.endsWith('.md')) {
- const agentPath = path.join(agentsPath, agentFile);
- let content = await fs.readFile(agentPath, 'utf8');
-
- // Check if content has agent XML and no activation block
- if (content.includes(' 0) {
- spinner.stop();
console.log(chalk.yellow('\nChecking custom module sources before compilation...'));
const customModuleSources = new Map();
@@ -2196,15 +2132,12 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
const projectRoot = getProjectRoot();
const installedModules = manifest.modules || [];
await this.handleMissingCustomSources(customModuleSources, bmadDir, projectRoot, 'compile-agents', installedModules);
-
- spinner.start('Rebuilding agent files...');
}
let agentCount = 0;
let taskCount = 0;
// Process all modules in bmad directory
- spinner.text = 'Rebuilding agent files...';
const entries = await fs.readdir(bmadDir, { withFileTypes: true });
for (const entry of entries) {
@@ -2213,7 +2146,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Special handling for standalone agents in bmad/agents/ directory
if (entry.name === 'agents') {
- spinner.text = 'Building standalone agents...';
await this.buildStandaloneAgents(bmadDir, projectDir);
// Count standalone agents
@@ -2245,16 +2177,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
}
}
- // Reinstall custom agents from _cfg/custom/agents/ sources
- spinner.start('Rebuilding custom agents...');
- const customAgentResults = await this.reinstallCustomAgents(projectDir, bmadDir);
- if (customAgentResults.count > 0) {
- spinner.succeed(`Rebuilt ${customAgentResults.count} custom agent${customAgentResults.count > 1 ? 's' : ''}`);
- agentCount += customAgentResults.count;
- } else {
- spinner.succeed('No custom agents found to rebuild');
- }
-
// Skip full manifest regeneration during compileAgents to preserve custom agents
// Custom agents are already added to manifests during individual installation
// Only regenerate YAML manifest for IDE updates if needed
@@ -2269,36 +2191,20 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
// Update IDE configurations using the existing IDE list from manifest
if (existingIdes && existingIdes.length > 0) {
- spinner.start('Updating IDE configurations...');
-
for (const ide of existingIdes) {
- spinner.text = `Updating ${ide}...`;
-
- // Stop spinner before IDE setup to prevent blocking any potential prompts
- // However, we pass _alreadyConfigured to skip all prompts during compile
- spinner.stop();
-
await this.ideManager.setup(ide, projectDir, bmadDir, {
selectedModules: installedModules,
skipModuleInstall: true, // Skip module installation, just update IDE files
verbose: config.verbose,
preCollectedConfig: { _alreadyConfigured: true }, // Skip all interactive prompts during compile
});
-
- // Restart spinner for next IDE
- if (existingIdes.indexOf(ide) < existingIdes.length - 1) {
- spinner.start('Updating IDE configurations...');
- }
}
-
console.log(chalk.green('✓ IDE configurations updated'));
} else {
console.log(chalk.yellow('⚠️ No IDEs configured. Skipping IDE update.'));
}
-
return { agentCount, taskCount };
} catch (error) {
- spinner.fail('Compilation failed');
throw error;
}
}
@@ -2610,19 +2516,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
lastModified: new Date().toISOString(),
};
- const existingBmadFolderName = path.basename(bmadDir);
- const newBmadFolderName = this.configCollector.collectedConfig.core?.bmad_folder || existingBmadFolderName;
-
- if (existingBmadFolderName === newBmadFolderName) {
- // Normal quick update - start the spinner
- console.log(chalk.cyan('Updating BMAD installation...'));
- } else {
- // Folder name has changed - stop spinner and let install() handle it
- spinner.stop();
- console.log(chalk.yellow(`\n⚠️ Folder name will change: ${existingBmadFolderName} → ${newBmadFolderName}`));
- console.log(chalk.yellow('The installer will handle the folder migration.\n'));
- }
-
// Build the config object for the installer
const installConfig = {
directory: projectDir,
@@ -2690,14 +2583,14 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
console.log(chalk.yellow.bold('\n⚠️ Legacy BMAD v4 detected'));
console.log(chalk.dim('The installer found legacy artefacts in your project.\n'));
- // Separate .bmad* folders (auto-backup) from other offending paths (manual cleanup)
+ // Separate _bmad* folders (auto-backup) from other offending paths (manual cleanup)
const bmadFolders = legacyV4.offenders.filter((p) => {
const name = path.basename(p);
- return name.startsWith('.bmad'); // Only dot-prefixed folders get auto-backed up
+ return name.startsWith('_bmad'); // Only dot-prefixed folders get auto-backed up
});
const otherOffenders = legacyV4.offenders.filter((p) => {
const name = path.basename(p);
- return !name.startsWith('.bmad'); // Everything else is manual cleanup
+ return !name.startsWith('_bmad'); // Everything else is manual cleanup
});
const inquirer = require('inquirer');
@@ -2730,7 +2623,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
}
}
- // Handle .bmad* folders with automatic backup
+ // Handle _bmad* folders with automatic backup
if (bmadFolders.length > 0) {
console.log(chalk.cyan('The following legacy folders will be moved to v4-backup:'));
for (const p of bmadFolders) console.log(chalk.dim(` - ${p}`));
@@ -2846,7 +2739,7 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
if (fileEntry.path) {
// Paths are relative to bmadDir. Legacy manifests incorrectly prefixed 'bmad/' -
// strip it if present. This is safe because no real path inside bmadDir would
- // start with 'bmad/' (you'd never have .bmad/bmad/... as an actual structure).
+ // start with 'bmad/' (you'd never have _bmad/bmad/... as an actual structure).
const relativePath = fileEntry.path.startsWith('bmad/') ? fileEntry.path.slice(5) : fileEntry.path;
const absolutePath = path.join(bmadDir, relativePath);
installedFilesMap.set(path.normalize(absolutePath), {
@@ -3099,165 +2992,6 @@ If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
return nodes;
}
- /**
- * Reinstall custom agents from backup and source locations
- * This preserves custom agents across quick updates/reinstalls
- * @param {string} projectDir - Project directory
- * @param {string} bmadDir - BMAD installation directory
- * @returns {Object} Result with count and agent names
- */
- async reinstallCustomAgents(projectDir, bmadDir) {
- const {
- discoverAgents,
- loadAgentConfig,
- extractManifestData,
- addToManifest,
- createIdeSlashCommands,
- updateManifestYaml,
- } = require('../../../lib/agent/installer');
- const { compileAgent } = require('../../../lib/agent/compiler');
-
- const results = { count: 0, agents: [] };
-
- // Check multiple locations for custom agents
- const sourceLocations = [
- path.join(bmadDir, '_cfg', 'custom', 'agents'), // Backup location
- path.join(bmadDir, 'custom', 'src', 'agents'), // BMAD folder source location
- path.join(projectDir, 'custom', 'src', 'agents'), // Project root source location
- ];
-
- let foundAgents = [];
- let processedAgents = new Set(); // Track to avoid duplicates
-
- // Discover agents from all locations
- for (const location of sourceLocations) {
- if (await fs.pathExists(location)) {
- const agents = discoverAgents(location);
- // Only add agents we haven't processed yet
- const newAgents = agents.filter((agent) => !processedAgents.has(agent.name));
- foundAgents.push(...newAgents);
- for (const agent of newAgents) processedAgents.add(agent.name);
- }
- }
-
- if (foundAgents.length === 0) {
- return results;
- }
-
- try {
- const customAgentsDir = path.join(bmadDir, 'custom', 'agents');
- await fs.ensureDir(customAgentsDir);
-
- const manifestFile = path.join(bmadDir, '_cfg', 'agent-manifest.csv');
- const manifestYamlFile = path.join(bmadDir, '_cfg', 'manifest.yaml');
-
- for (const agent of foundAgents) {
- try {
- const agentConfig = loadAgentConfig(agent.yamlFile);
- const finalAgentName = agent.name; // Already named correctly from save
-
- // Determine agent type from the name (e.g., "fred-commit-poet" → "commit-poet")
- let agentType = finalAgentName;
- const parts = finalAgentName.split('-');
- if (parts.length >= 2) {
- // Try to extract type (last part or last two parts)
- // For "fred-commit-poet", we want "commit-poet"
- // This is heuristic - could be improved with metadata storage
- agentType = parts.slice(-2).join('-'); // Take last 2 parts as type
- }
-
- // Create target directory - use relative path if agent is in a subdirectory
- const agentTargetDir = agent.relativePath
- ? path.join(customAgentsDir, agent.relativePath)
- : path.join(customAgentsDir, finalAgentName);
- await fs.ensureDir(agentTargetDir);
-
- // Calculate paths
- const compiledFileName = `${finalAgentName}.md`;
- const compiledPath = path.join(agentTargetDir, compiledFileName);
- const relativePath = path.relative(projectDir, compiledPath);
-
- // Compile with embedded defaults (answers are already in defaults section)
- const { xml, metadata } = compileAgent(
- await fs.readFile(agent.yamlFile, 'utf8'),
- agentConfig.defaults || {},
- finalAgentName,
- relativePath,
- { config: config.coreConfig },
- );
-
- // Write compiled agent
- await fs.writeFile(compiledPath, xml, 'utf8');
-
- // Backup source YAML to _cfg/custom/agents if not already there
- const cfgAgentsBackupDir = path.join(bmadDir, '_cfg', 'custom', 'agents');
- await fs.ensureDir(cfgAgentsBackupDir);
- const backupYamlPath = path.join(cfgAgentsBackupDir, `${finalAgentName}.agent.yaml`);
-
- // Only backup if source is not already in backup location
- if (agent.yamlFile !== backupYamlPath) {
- await fs.copy(agent.yamlFile, backupYamlPath);
- }
-
- // Copy sidecar files for agents with hasSidecar flag
- if (agentConfig.hasSidecar === true && agent.type === 'expert') {
- const { copyAgentSidecarFiles } = require('../../../lib/agent/installer');
-
- // Get agent sidecar folder from config or use default
- const agentSidecarFolder = config.coreConfig?.agent_sidecar_folder;
-
- // Resolve path variables
- const resolvedSidecarFolder = agentSidecarFolder.replaceAll('{project-root}', projectDir).replaceAll('.bmad', bmadDir);
-
- // Create sidecar directory for this agent
- const agentSidecarDir = path.join(resolvedSidecarFolder, finalAgentName);
- await fs.ensureDir(agentSidecarDir);
-
- // Copy sidecar files (preserve existing, add new)
- const sidecarResult = copyAgentSidecarFiles(agent.path, agentSidecarDir, agent.yamlFile);
-
- if (sidecarResult.copied.length > 0 || sidecarResult.preserved.length > 0) {
- console.log(chalk.dim(` Sidecar: ${sidecarResult.copied.length} new, ${sidecarResult.preserved.length} preserved`));
- }
- }
-
- // Update manifest CSV
- if (await fs.pathExists(manifestFile)) {
- // Preserve YAML metadata for persona name, but override id for filename
- const manifestMetadata = {
- ...metadata,
- id: relativePath, // Use the compiled agent path for id
- name: metadata.name || finalAgentName, // Use YAML metadata.name (persona name) or fallback
- title: metadata.title, // Use YAML title
- icon: metadata.icon, // Use YAML icon
- };
- const manifestData = extractManifestData(xml, manifestMetadata, relativePath, 'custom');
- manifestData.name = finalAgentName; // Use filename for the name field
- manifestData.path = relativePath;
- addToManifest(manifestFile, manifestData);
- }
-
- // Create IDE slash commands (async function)
- await createIdeSlashCommands(projectDir, finalAgentName, relativePath, metadata);
-
- // Update manifest.yaml
- if (await fs.pathExists(manifestYamlFile)) {
- updateManifestYaml(manifestYamlFile, finalAgentName, agentType);
- }
-
- results.count++;
- results.agents.push(finalAgentName);
- } catch (agentError) {
- console.log(chalk.yellow(` ⚠️ Failed to reinstall ${agent.name}: ${agentError.message}`));
- }
- }
- } catch (error) {
- console.log(chalk.yellow(` ⚠️ Error reinstalling custom agents: ${error.message}`));
- }
-
- return results;
- }
-
/**
* Copy IDE-specific documentation to BMAD docs
* @param {Array} ides - List of selected IDEs
diff --git a/tools/cli/installers/lib/core/manifest-generator.js b/tools/cli/installers/lib/core/manifest-generator.js
index cd382378..e3b46e42 100644
--- a/tools/cli/installers/lib/core/manifest-generator.js
+++ b/tools/cli/installers/lib/core/manifest-generator.js
@@ -23,7 +23,7 @@ class ManifestGenerator {
/**
* Generate all manifests for the installation
- * @param {string} bmadDir - .bmad
+ * @param {string} bmadDir - _bmad
* @param {Array} selectedModules - Selected modules for installation
* @param {Array} installedFiles - All installed files (optional, for hash tracking)
*/
@@ -47,7 +47,7 @@ class ManifestGenerator {
// But all modules should be included in the final manifest
this.preservedModules = [...new Set([...preservedModules, ...selectedModules, ...installedModules])]; // Include all installed modules
this.bmadDir = bmadDir;
- this.bmadFolderName = path.basename(bmadDir); // Get the actual folder name (e.g., '.bmad' or 'bmad')
+ this.bmadFolderName = path.basename(bmadDir); // Get the actual folder name (e.g., '_bmad' or 'bmad')
this.allInstalledFiles = installedFiles;
if (!Object.prototype.hasOwnProperty.call(options, 'ides')) {
diff --git a/tools/cli/installers/lib/core/post-install-sidecar-replacement.js b/tools/cli/installers/lib/core/post-install-sidecar-replacement.js
deleted file mode 100644
index da351c50..00000000
--- a/tools/cli/installers/lib/core/post-install-sidecar-replacement.js
+++ /dev/null
@@ -1,79 +0,0 @@
-/**
- * Post-installation sidecar folder replacement utility
- * Replaces {agent_sidecar_folder} placeholders in all installed agents
- */
-
-const fs = require('fs-extra');
-const path = require('node:path');
-const yaml = require('yaml');
-const glob = require('glob');
-const chalk = require('chalk');
-
-/**
- * Replace {agent_sidecar_folder} placeholders in all agent files
- * @param {string} bmadDir - Path to .bmad directory
- * @returns {Object} Statistics about replacements made
- */
-async function replaceAgentSidecarFolders(bmadDir) {
- const results = {
- filesScanned: 0,
- filesReplaced: 0,
- totalReplacements: 0,
- errors: [],
- };
-
- try {
- // Load core config to get agent_sidecar_folder value
- const coreConfigPath = path.join(bmadDir, 'bmb', 'config.yaml');
-
- if (!(await fs.pathExists(coreConfigPath))) {
- throw new Error(`Core config not found at ${coreConfigPath}`);
- }
-
- const coreConfigContent = await fs.readFile(coreConfigPath, 'utf8');
- const coreConfig = yaml.parse(coreConfigContent);
- const agentSidecarFolder = coreConfig.agent_sidecar_folder;
-
- // Use the literal value from config, don't resolve the placeholders
- console.log(chalk.dim(`\n Replacing {agent_sidecar_folder} with: ${agentSidecarFolder}`));
-
- // Find all agent .md files
- const agentPattern = path.join(bmadDir, '**/*.md');
- const agentFiles = glob.sync(agentPattern);
-
- for (const agentFile of agentFiles) {
- results.filesScanned++;
-
- try {
- let content = await fs.readFile(agentFile, 'utf8');
-
- // Check if file contains {agent_sidecar_folder}
- if (content.includes('{agent_sidecar_folder}')) {
- // Replace all occurrences
- const originalContent = content;
- content = content.replaceAll('{agent_sidecar_folder}', agentSidecarFolder);
-
- // Only write if content changed
- if (content !== originalContent) {
- await fs.writeFile(agentFile, content, 'utf8');
-
- const replacementCount = (originalContent.match(/{agent_sidecar_folder}/g) || []).length;
- results.filesReplaced++;
- results.totalReplacements += replacementCount;
-
- console.log(chalk.dim(` ✓ Replaced ${replacementCount} occurrence(s) in ${path.relative(bmadDir, agentFile)}`));
- }
- }
- } catch (error) {
- results.errors.push(`Error processing ${agentFile}: ${error.message}`);
- }
- }
-
- return results;
- } catch (error) {
- results.errors.push(`Fatal error: ${error.message}`);
- return results;
- }
-}
-
-module.exports = { replaceAgentSidecarFolders };
diff --git a/tools/cli/installers/lib/custom/handler.js b/tools/cli/installers/lib/custom/handler.js
index 23c4c493..204e89ad 100644
--- a/tools/cli/installers/lib/custom/handler.js
+++ b/tools/cli/installers/lib/custom/handler.js
@@ -316,7 +316,7 @@ class CustomHandler {
// Create customize template if it doesn't exist
if (!(await fs.pathExists(customizePath))) {
const { getSourcePath } = require('../../../lib/project-root');
- const genericTemplatePath = getSourcePath('utility', 'templates', 'agent.customize.template.yaml');
+ const genericTemplatePath = getSourcePath('utility', 'agent-components', 'agent.customize.template.yaml');
if (await fs.pathExists(genericTemplatePath)) {
// Copy with placeholder replacement
let templateContent = await fs.readFile(genericTemplatePath, 'utf8');
@@ -355,7 +355,7 @@ class CustomHandler {
const projectDir = path.dirname(bmadDir);
const resolvedSidecarFolder = config.agent_sidecar_folder
.replaceAll('{project-root}', projectDir)
- .replaceAll('.bmad', path.basename(bmadDir));
+ .replaceAll('_bmad', path.basename(bmadDir));
// Create sidecar directory for this agent
const agentSidecarDir = path.join(resolvedSidecarFolder, agentName);
diff --git a/tools/cli/installers/lib/ide/_base-ide.js b/tools/cli/installers/lib/ide/_base-ide.js
index e46f2b87..ba06460e 100644
--- a/tools/cli/installers/lib/ide/_base-ide.js
+++ b/tools/cli/installers/lib/ide/_base-ide.js
@@ -31,18 +31,11 @@ class BaseIdeSetup {
/**
* Get the agent command activation header from the central template
- * @returns {string} The activation header text (without XML tags)
+ * @returns {string} The activation header text
*/
async getAgentCommandHeader() {
- const headerPath = path.join(getSourcePath(), 'src', 'utility', 'models', 'agent-command-header.md');
- try {
- const content = await fs.readFile(headerPath, 'utf8');
- // Strip the tags to get plain text
- return content.replaceAll(/|<\/critical>/g, '').trim();
- } catch {
- // Fallback if file doesn't exist
- return "You must fully embody this agent's persona and follow all activation instructions, steps and rules exactly as specified. NEVER break character until given an exit command.";
- }
+ const headerPath = path.join(getSourcePath(), 'src', 'utility', 'agent-components', 'agent-command-header.md');
+ return await fs.readFile(headerPath, 'utf8');
}
/**
@@ -527,26 +520,26 @@ class BaseIdeSetup {
}
/**
- * Write file with content (replaces .bmad placeholder)
+ * Write file with content (replaces _bmad placeholder)
* @param {string} filePath - File path
* @param {string} content - File content
*/
async writeFile(filePath, content) {
- // Replace .bmad placeholder if present
- if (typeof content === 'string' && content.includes('.bmad')) {
- content = content.replaceAll('.bmad', this.bmadFolderName);
+ // Replace _bmad placeholder if present
+ if (typeof content === 'string' && content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', this.bmadFolderName);
}
- // Replace escape sequence .bmad with literal .bmad
- if (typeof content === 'string' && content.includes('.bmad')) {
- content = content.replaceAll('.bmad', '.bmad');
+ // Replace escape sequence _bmad with literal _bmad
+ if (typeof content === 'string' && content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', '_bmad');
}
await this.ensureDir(path.dirname(filePath));
await fs.writeFile(filePath, content, 'utf8');
}
/**
- * Copy file from source to destination (replaces .bmad placeholder in text files)
+ * Copy file from source to destination (replaces _bmad placeholder in text files)
* @param {string} source - Source file path
* @param {string} dest - Destination file path
*/
@@ -563,14 +556,14 @@ class BaseIdeSetup {
// Read the file content
let content = await fs.readFile(source, 'utf8');
- // Replace .bmad placeholder with actual folder name
- if (content.includes('.bmad')) {
- content = content.replaceAll('.bmad', this.bmadFolderName);
+ // Replace _bmad placeholder with actual folder name
+ if (content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', this.bmadFolderName);
}
- // Replace escape sequence .bmad with literal .bmad
- if (content.includes('.bmad')) {
- content = content.replaceAll('.bmad', '.bmad');
+ // Replace escape sequence _bmad with literal _bmad
+ if (content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', '_bmad');
}
// Write to dest with replaced content
diff --git a/tools/cli/installers/lib/ide/antigravity.js b/tools/cli/installers/lib/ide/antigravity.js
index e1f118ec..71898b56 100644
--- a/tools/cli/installers/lib/ide/antigravity.js
+++ b/tools/cli/installers/lib/ide/antigravity.js
@@ -119,7 +119,7 @@ class AntigravitySetup extends BaseIdeSetup {
await this.ensureDir(bmadWorkflowsDir);
// Generate agent launchers using AgentCommandGenerator
- // This creates small launcher files that reference the actual agents in .bmad/
+ // This creates small launcher files that reference the actual agents in _bmad/
const agentGen = new AgentCommandGenerator(this.bmadFolderName);
const { artifacts: agentArtifacts, counts: agentCounts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
diff --git a/tools/cli/installers/lib/ide/claude-code.js b/tools/cli/installers/lib/ide/claude-code.js
index 6faf92f8..bc96d4c2 100644
--- a/tools/cli/installers/lib/ide/claude-code.js
+++ b/tools/cli/installers/lib/ide/claude-code.js
@@ -118,7 +118,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
await this.ensureDir(bmadCommandsDir);
// Generate agent launchers using AgentCommandGenerator
- // This creates small launcher files that reference the actual agents in .bmad/
+ // This creates small launcher files that reference the actual agents in _bmad/
const agentGen = new AgentCommandGenerator(this.bmadFolderName);
const { artifacts: agentArtifacts, counts: agentCounts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
diff --git a/tools/cli/installers/lib/ide/codex.js b/tools/cli/installers/lib/ide/codex.js
index 6cf22a7a..e538fa6f 100644
--- a/tools/cli/installers/lib/ide/codex.js
+++ b/tools/cli/installers/lib/ide/codex.js
@@ -265,8 +265,8 @@ class CodexSetup extends BaseIdeSetup {
'',
chalk.white(' /prompts installed globally to your HOME DIRECTORY.'),
'',
- chalk.yellow(' ⚠️ These prompts reference a specific .bmad path'),
- chalk.dim(" To use with other projects, you'd need to copy the .bmad dir"),
+ chalk.yellow(' ⚠️ These prompts reference a specific _bmad path'),
+ chalk.dim(" To use with other projects, you'd need to copy the _bmad dir"),
'',
chalk.green(' ✓ You can now use /commands in Codex CLI'),
chalk.dim(' Example: /bmad-bmm-agents-pm'),
diff --git a/tools/cli/installers/lib/ide/gemini.js b/tools/cli/installers/lib/ide/gemini.js
index 978062a2..1d57d4f4 100644
--- a/tools/cli/installers/lib/ide/gemini.js
+++ b/tools/cli/installers/lib/ide/gemini.js
@@ -174,8 +174,8 @@ ${contentWithoutFrontmatter}
// Note: {user_name} and other {config_values} are left as-is for runtime substitution by Gemini
const tomlContent = template
.replaceAll('{{title}}', title)
- .replaceAll('{.bmad}', '.bmad')
- .replaceAll('{.bmad}', this.bmadFolderName)
+ .replaceAll('{_bmad}', '_bmad')
+ .replaceAll('{_bmad}', this.bmadFolderName)
.replaceAll('{{module}}', agent.module)
.replaceAll('{{name}}', agent.name);
@@ -196,8 +196,8 @@ ${contentWithoutFrontmatter}
// Replace template variables
const tomlContent = template
.replaceAll('{{taskName}}', taskName)
- .replaceAll('{.bmad}', '.bmad')
- .replaceAll('{.bmad}', this.bmadFolderName)
+ .replaceAll('{_bmad}', '_bmad')
+ .replaceAll('{_bmad}', this.bmadFolderName)
.replaceAll('{{module}}', task.module)
.replaceAll('{{filename}}', task.filename);
diff --git a/tools/cli/installers/lib/ide/roo.js b/tools/cli/installers/lib/ide/roo.js
index 1352b311..4f0f2f1b 100644
--- a/tools/cli/installers/lib/ide/roo.js
+++ b/tools/cli/installers/lib/ide/roo.js
@@ -45,11 +45,11 @@ class RooSetup extends BaseIdeSetup {
continue;
}
- // Read the actual agent file from .bmad for metadata extraction (installed agents are .md files)
+ // Read the actual agent file from _bmad for metadata extraction (installed agents are .md files)
const agentPath = path.join(bmadDir, artifact.module, 'agents', `${artifact.name}.md`);
const content = await this.readFile(agentPath);
- // Create command file that references the actual .bmad agent
+ // Create command file that references the actual _bmad agent
await this.createCommandFile({ module: artifact.module, name: artifact.name, path: agentPath }, content, commandPath, projectDir);
addedCount++;
diff --git a/tools/cli/installers/lib/ide/shared/agent-command-generator.js b/tools/cli/installers/lib/ide/shared/agent-command-generator.js
index f111dcb9..20b89304 100644
--- a/tools/cli/installers/lib/ide/shared/agent-command-generator.js
+++ b/tools/cli/installers/lib/ide/shared/agent-command-generator.js
@@ -65,8 +65,8 @@ class AgentCommandGenerator {
.replaceAll('{{module}}', agent.module)
.replaceAll('{{path}}', agentPathInModule)
.replaceAll('{{description}}', agent.description || `${agent.name} agent`)
- .replaceAll('.bmad', this.bmadFolderName)
- .replaceAll('.bmad', '.bmad');
+ .replaceAll('_bmad', this.bmadFolderName)
+ .replaceAll('_bmad', '_bmad');
}
/**
diff --git a/tools/cli/installers/lib/ide/shared/workflow-command-generator.js b/tools/cli/installers/lib/ide/shared/workflow-command-generator.js
index 921388ea..ec77a232 100644
--- a/tools/cli/installers/lib/ide/shared/workflow-command-generator.js
+++ b/tools/cli/installers/lib/ide/shared/workflow-command-generator.js
@@ -109,7 +109,7 @@ class WorkflowCommandGenerator {
// Convert source path to installed path
// From: /Users/.../src/modules/bmm/workflows/.../workflow.yaml
- // To: {project-root}/.bmad/bmm/workflows/.../workflow.yaml
+ // To: {project-root}/_bmad/bmm/workflows/.../workflow.yaml
let workflowPath = workflow.path;
// Extract the relative path from source
@@ -131,8 +131,8 @@ class WorkflowCommandGenerator {
.replaceAll('{{module}}', workflow.module)
.replaceAll('{{description}}', workflow.description)
.replaceAll('{{workflow_path}}', workflowPath)
- .replaceAll('.bmad', this.bmadFolderName)
- .replaceAll('.bmad', '.bmad');
+ .replaceAll('_bmad', this.bmadFolderName)
+ .replaceAll('_bmad', '_bmad');
}
/**
diff --git a/tools/cli/installers/lib/ide/templates/agent-command-template.md b/tools/cli/installers/lib/ide/templates/agent-command-template.md
index be2461fa..89713631 100644
--- a/tools/cli/installers/lib/ide/templates/agent-command-template.md
+++ b/tools/cli/installers/lib/ide/templates/agent-command-template.md
@@ -6,7 +6,7 @@ description: '{{description}}'
You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-1. LOAD the FULL agent file from @.bmad/{{module}}/agents/{{path}}
+1. LOAD the FULL agent file from @_bmad/{{module}}/agents/{{path}}
2. READ its entire contents - this contains the complete agent persona, menu, and instructions
3. Execute ALL activation steps exactly as written in the agent file
4. Follow the agent's persona and menu system precisely
diff --git a/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml b/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml
index 2022c3f0..2dc4c2c5 100644
--- a/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml
+++ b/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml
@@ -3,12 +3,12 @@ prompt = """
CRITICAL: You are now the BMad '{{title}}' agent.
PRE-FLIGHT CHECKLIST:
-1. [ ] IMMEDIATE ACTION: Load and parse @{.bmad}/{{module}}/config.yaml - store ALL config values in memory for use throughout the session.
-2. [ ] IMMEDIATE ACTION: Read and internalize the full agent definition at @{.bmad}/{{module}}/agents/{{name}}.md.
+1. [ ] IMMEDIATE ACTION: Load and parse @{_bmad}/{{module}}/config.yaml - store ALL config values in memory for use throughout the session.
+2. [ ] IMMEDIATE ACTION: Read and internalize the full agent definition at @{_bmad}/{{module}}/agents/{{name}}.md.
3. [ ] CONFIRM: The user's name from config is {user_name}.
Only after all checks are complete, greet the user by name and display the menu.
Acknowledge this checklist is complete in your first response.
-AGENT DEFINITION: @{.bmad}/{{module}}/agents/{{name}}.md
+AGENT DEFINITION: @{_bmad}/{{module}}/agents/{{name}}.md
"""
diff --git a/tools/cli/installers/lib/ide/templates/gemini-task-command.toml b/tools/cli/installers/lib/ide/templates/gemini-task-command.toml
index a6c10647..2dbedaaa 100644
--- a/tools/cli/installers/lib/ide/templates/gemini-task-command.toml
+++ b/tools/cli/installers/lib/ide/templates/gemini-task-command.toml
@@ -3,10 +3,10 @@ prompt = """
Execute the following BMad Method task workflow:
PRE-FLIGHT CHECKLIST:
-1. [ ] IMMEDIATE ACTION: Load and parse @{.bmad}/{{module}}/config.yaml.
-2. [ ] IMMEDIATE ACTION: Read and load the task definition at @{.bmad}/{{module}}/tasks/{{filename}}.
+1. [ ] IMMEDIATE ACTION: Load and parse @{_bmad}/{{module}}/config.yaml.
+2. [ ] IMMEDIATE ACTION: Read and load the task definition at @{_bmad}/{{module}}/tasks/{{filename}}.
Follow all instructions and complete the task as defined.
-TASK DEFINITION: @{.bmad}/{{module}}/tasks/{{filename}}
+TASK DEFINITION: @{_bmad}/{{module}}/tasks/{{filename}}
"""
diff --git a/tools/cli/installers/lib/ide/templates/workflow-command-template.md b/tools/cli/installers/lib/ide/templates/workflow-command-template.md
index 4d00f3a8..5c9e436c 100644
--- a/tools/cli/installers/lib/ide/templates/workflow-command-template.md
+++ b/tools/cli/installers/lib/ide/templates/workflow-command-template.md
@@ -5,7 +5,7 @@ description: '{{description}}'
IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
-1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+1. Always LOAD the FULL @_bmad/core/tasks/workflow.xml
2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{{workflow_path}}
3. Pass the yaml path {{workflow_path}} as 'workflow-config' parameter to the workflow.xml instructions
4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
diff --git a/tools/cli/installers/lib/modules/manager.js b/tools/cli/installers/lib/modules/manager.js
index 23bd74d3..4a4cbf86 100644
--- a/tools/cli/installers/lib/modules/manager.js
+++ b/tools/cli/installers/lib/modules/manager.js
@@ -47,7 +47,7 @@ class ModuleManager {
}
/**
- * Copy a file and replace .bmad placeholder with actual folder name
+ * Copy a file and replace _bmad placeholder with actual folder name
* @param {string} sourcePath - Source file path
* @param {string} targetPath - Target file path
*/
@@ -62,14 +62,14 @@ class ModuleManager {
// Read the file content
let content = await fs.readFile(sourcePath, 'utf8');
- // Replace escape sequence .bmad with literal .bmad
- if (content.includes('.bmad')) {
- content = content.replaceAll('.bmad', '.bmad');
+ // Replace escape sequence _bmad with literal _bmad
+ if (content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', '_bmad');
}
- // Replace .bmad placeholder with actual folder name
- if (content.includes('.bmad')) {
- content = content.replaceAll('.bmad', this.bmadFolderName);
+ // Replace _bmad placeholder with actual folder name
+ if (content.includes('_bmad')) {
+ content = content.replaceAll('_bmad', this.bmadFolderName);
}
// Write to target with replaced content
@@ -695,8 +695,8 @@ class ModuleManager {
// IMPORTANT: Replace escape sequence and placeholder BEFORE parsing YAML
// Otherwise parsing will fail on the placeholder
- yamlContent = yamlContent.replaceAll('.bmad', '.bmad');
- yamlContent = yamlContent.replaceAll('.bmad', this.bmadFolderName);
+ yamlContent = yamlContent.replaceAll('_bmad', '_bmad');
+ yamlContent = yamlContent.replaceAll('_bmad', this.bmadFolderName);
try {
// First check if web_bundle exists by parsing
@@ -815,7 +815,7 @@ class ModuleManager {
// Create customize template if it doesn't exist
if (!(await fs.pathExists(customizePath))) {
const { getSourcePath } = require('../../../lib/project-root');
- const genericTemplatePath = getSourcePath('utility', 'templates', 'agent.customize.template.yaml');
+ const genericTemplatePath = getSourcePath('utility', 'agent-components', 'agent.customize.template.yaml');
if (await fs.pathExists(genericTemplatePath)) {
await this.copyFileWithPlaceholderReplacement(genericTemplatePath, customizePath);
console.log(chalk.dim(` Created customize: ${moduleName}-${agentName}.customize.yaml`));
@@ -853,9 +853,9 @@ class ModuleManager {
// Compile with customizations if any
const { xml } = compileAgent(yamlContent, {}, agentName, relativePath, { config: this.coreConfig });
- // Replace .bmad placeholder if needed
- if (xml.includes('.bmad') && this.bmadFolderName) {
- const processedXml = xml.replaceAll('.bmad', this.bmadFolderName);
+ // Replace _bmad placeholder if needed
+ if (xml.includes('_bmad') && this.bmadFolderName) {
+ const processedXml = xml.replaceAll('_bmad', this.bmadFolderName);
await fs.writeFile(targetMdPath, processedXml, 'utf8');
} else {
await fs.writeFile(targetMdPath, xml, 'utf8');
@@ -872,7 +872,7 @@ class ModuleManager {
const projectDir = path.dirname(bmadDir);
const resolvedSidecarFolder = agentSidecarFolder
.replaceAll('{project-root}', projectDir)
- .replaceAll('.bmad', path.basename(bmadDir));
+ .replaceAll('_bmad', path.basename(bmadDir));
// Create sidecar directory for this agent
const agentSidecarDir = path.join(resolvedSidecarFolder, agentName);
@@ -931,28 +931,23 @@ class ModuleManager {
* @param {string} moduleName - Module name
*/
async processAgentFiles(modulePath, moduleName) {
- const agentsPath = path.join(modulePath, 'agents');
-
- // Check if agents directory exists
- if (!(await fs.pathExists(agentsPath))) {
- return; // No agents to process
- }
-
- // Get all agent MD files recursively
- const agentFiles = await this.findAgentMdFiles(agentsPath);
-
- for (const agentFile of agentFiles) {
- if (!agentFile.endsWith('.md')) continue;
-
- let content = await fs.readFile(agentFile, 'utf8');
-
- // Check if content has agent XML and no activation block
- if (content.includes('';
@@ -83,7 +80,7 @@ class ActivationBuilder {
const handlerFragments = [];
for (const attrType of profile.usedAttributes) {
- const fragmentName = `handler-${attrType}.xml`;
+ const fragmentName = `handler-${attrType}.txt`;
try {
const handler = await this.loadFragment(fragmentName);
handlerFragments.push(handler);
@@ -103,9 +100,7 @@ class ActivationBuilder {
* @returns {string} Steps XML
*/
async buildSteps(metadata = {}, agentSpecificActions = [], forWebBundle = false) {
- // Use web-specific fragment for web bundles, standard fragment otherwise
- const fragmentName = forWebBundle ? 'web-bundle-activation-steps.xml' : 'activation-steps.xml';
- const stepsTemplate = await this.loadFragment(fragmentName);
+ const stepsTemplate = await this.loadFragment('activation-steps.txt');
// Extract basename from agent ID (e.g., "bmad/bmm/agents/pm.md" → "pm")
const agentBasename = metadata.id ? metadata.id.split('/').pop().replace('.md', '') : metadata.name || 'agent';
diff --git a/tools/cli/lib/agent-party-generator.js b/tools/cli/lib/agent-party-generator.js
index 1528ae68..d2b0cad6 100644
--- a/tools/cli/lib/agent-party-generator.js
+++ b/tools/cli/lib/agent-party-generator.js
@@ -1,5 +1,6 @@
const path = require('node:path');
const fs = require('fs-extra');
+const { escapeXml } = require('../../lib/xml-utils');
const AgentPartyGenerator = {
/**
@@ -47,9 +48,9 @@ const AgentPartyGenerator = {
for (const agent of agents) {
xmlContent += `
- ${this.escapeXml(agent.role || '')}
- ${this.escapeXml(agent.identity || '')}
- ${this.escapeXml(agent.communicationStyle || '')}
+ ${escapeXml(agent.role || '')}
+ ${escapeXml(agent.identity || '')}
+ ${escapeXml(agent.communicationStyle || '')}
${agent.principles || ''}
\n`;
@@ -124,19 +125,6 @@ const AgentPartyGenerator = {
return match ? match[1] : '';
},
- /**
- * Escape XML special characters
- */
- escapeXml(text) {
- if (!text) return '';
- return text
- .replaceAll('&', '&')
- .replaceAll('<', '<')
- .replaceAll('>', '>')
- .replaceAll('"', '"')
- .replaceAll("'", ''');
- },
-
/**
* Apply config overrides to agent details
* @param {Object} details - Original agent details
diff --git a/tools/cli/lib/agent/compiler.js b/tools/cli/lib/agent/compiler.js
index d381b34e..a22a62ea 100644
--- a/tools/cli/lib/agent/compiler.js
+++ b/tools/cli/lib/agent/compiler.js
@@ -8,22 +8,7 @@ const yaml = require('yaml');
const fs = require('node:fs');
const path = require('node:path');
const { processAgentYaml, extractInstallConfig, stripInstallConfig, getDefaultValues } = require('./template-engine');
-
-// Use existing BMAD builder if available
-let YamlXmlBuilder;
-try {
- YamlXmlBuilder = require('../../lib/yaml-xml-builder').YamlXmlBuilder;
-} catch {
- YamlXmlBuilder = null;
-}
-
-/**
- * Escape XML special characters
- */
-function escapeXml(text) {
- if (!text) return '';
- return text.replaceAll('&', '&').replaceAll('<', '<').replaceAll('>', '>').replaceAll('"', '"').replaceAll("'", ''');
-}
+const { escapeXml } = require('../../../lib/xml-utils');
/**
* Build frontmatter for agent
diff --git a/tools/cli/lib/agent/installer.js b/tools/cli/lib/agent/installer.js
index 14140615..c83c8269 100644
--- a/tools/cli/lib/agent/installer.js
+++ b/tools/cli/lib/agent/installer.js
@@ -17,7 +17,7 @@ const { extractInstallConfig, getDefaultValues } = require('./template-engine');
*/
function findBmadConfig(startPath = process.cwd()) {
// Look for common BMAD folder names
- const possibleNames = ['.bmad', 'bmad', '.bmad-method'];
+ const possibleNames = ['_bmad'];
for (const name of possibleNames) {
const configPath = path.join(startPath, name, 'bmb', 'config.yaml');
@@ -42,7 +42,7 @@ function findBmadConfig(startPath = process.cwd()) {
* @returns {string} Resolved path
*/
function resolvePath(pathStr, context) {
- return pathStr.replaceAll('{project-root}', context.projectRoot).replaceAll('{bmad-folder}', context.bmadFolder);
+ return pathStr.replaceAll('{project-root}', context.projectRoot).replaceAll('{bmad-folder}', context_bmadFolder);
}
/**
@@ -273,7 +273,7 @@ function installAgent(agentInfo, answers, targetPath, options = {}) {
// Resolve path variables
const resolvedSidecarFolder = agentSidecarFolder
.replaceAll('{project-root}', options.projectRoot || process.cwd())
- .replaceAll('.bmad', options.bmadFolder || '.bmad');
+ .replaceAll('_bmad', options_bmadFolder || '_bmad');
// Create sidecar directory for this agent
const agentSidecarDir = path.join(resolvedSidecarFolder, agentFolderName);
@@ -407,7 +407,7 @@ function detectBmadProject(targetPath) {
// Walk up directory tree looking for BMAD installation
while (checkPath !== root) {
- const possibleNames = ['.bmad'];
+ const possibleNames = ['_bmad'];
for (const name of possibleNames) {
const bmadFolder = path.join(checkPath, name);
const cfgFolder = path.join(bmadFolder, '_cfg');
@@ -689,7 +689,7 @@ function saveAgentSource(agentInfo, cfgFolder, agentName, answers = {}) {
*/
async function createIdeSlashCommands(projectRoot, agentName, agentPath, metadata) {
// Read manifest.yaml to get installed IDEs
- const manifestPath = path.join(projectRoot, '.bmad', '_cfg', 'manifest.yaml');
+ const manifestPath = path.join(projectRoot, '_bmad', '_cfg', 'manifest.yaml');
let installedIdes = ['claude-code']; // Default to Claude Code if no manifest
if (fs.existsSync(manifestPath)) {
diff --git a/tools/cli/lib/ui.js b/tools/cli/lib/ui.js
index f0ef3f99..d9b827bb 100644
--- a/tools/cli/lib/ui.js
+++ b/tools/cli/lib/ui.js
@@ -136,7 +136,7 @@ class UI {
// Create the bmad directory based on core config
const path = require('node:path');
const fs = require('fs-extra');
- const bmadFolderName = '.bmad';
+ const bmadFolderName = '_bmad';
const bmadDir = path.join(confirmedDirectory, bmadFolderName);
await fs.ensureDir(bmadDir);
@@ -535,7 +535,7 @@ class UI {
// Show backup info and restore command
console.log('\n' + chalk.white.bold('Backups & Recovery:\n'));
console.log(chalk.dim(' Pre-injection backups are stored in:'));
- console.log(chalk.cyan(' ~/.bmad-tts-backups/\n'));
+ console.log(chalk.cyan(' ~/_bmad-tts-backups/\n'));
console.log(chalk.dim(' To restore original files (removes TTS instructions):'));
console.log(chalk.cyan(` bmad-tts-injector.sh --restore ${result.path}\n`));
diff --git a/tools/cli/lib/xml-handler.js b/tools/cli/lib/xml-handler.js
index 193808e4..a6111b1a 100644
--- a/tools/cli/lib/xml-handler.js
+++ b/tools/cli/lib/xml-handler.js
@@ -44,18 +44,7 @@ class XmlHandler {
* @returns {Object} Parsed activation block
*/
async loadActivationTemplate() {
- const templatePath = getSourcePath('utility', 'models', 'agent-activation-ide.xml');
-
- try {
- const xmlContent = await fs.readFile(templatePath, 'utf8');
-
- // Parse the XML directly (file is now pure XML)
- const parsed = await this.parser.parseStringPromise(xmlContent);
- return parsed.activation;
- } catch (error) {
- console.error('Failed to load activation template:', error);
- return null;
- }
+ console.error('Failed to load activation template:', error);
}
/**
@@ -136,51 +125,10 @@ class XmlHandler {
}
/**
- * Simple string-based injection (fallback method for legacy XML agents)
- * This preserves formatting better than XML parsing
+ * TODO: DELETE THIS METHOD
*/
injectActivationSimple(agentContent, metadata = {}) {
- // Check if already has activation
- if (agentContent.includes(' (line ? ' ' + line : ''))
- .join('\n');
-
- // Replace {agent-filename} with actual filename if metadata provided
- if (metadata.module && metadata.name) {
- const agentFilename = `${metadata.module}-${metadata.name}.md`;
- activationBlock = activationBlock.replace('{agent-filename}', agentFilename);
- }
-
- // Find where to insert (after tag)
- const agentMatch = agentContent.match(/(]*>)/);
- if (!agentMatch) {
- return agentContent;
- }
-
- const insertPos = agentMatch.index + agentMatch[0].length;
-
- // Insert the activation block
- const before = agentContent.slice(0, insertPos);
- const after = agentContent.slice(insertPos);
-
- return before + '\n' + activationBlock + after;
- } catch (error) {
- console.error('Error in simple injection:', error);
- return agentContent;
- }
+ console.error('Error in simple injection:', error);
}
/**
diff --git a/tools/cli/lib/yaml-xml-builder.js b/tools/cli/lib/yaml-xml-builder.js
index 365320ab..6f5db1a5 100644
--- a/tools/cli/lib/yaml-xml-builder.js
+++ b/tools/cli/lib/yaml-xml-builder.js
@@ -4,6 +4,7 @@ const path = require('node:path');
const crypto = require('node:crypto');
const { AgentAnalyzer } = require('./agent-analyzer');
const { ActivationBuilder } = require('./activation-builder');
+const { escapeXml } = require('../../lib/xml-utils');
/**
* Converts agent YAML files to XML format with smart activation injection
@@ -241,15 +242,15 @@ class YamlXmlBuilder {
let xml = ' \n';
if (persona.role) {
- xml += ` ${this.escapeXml(persona.role)}\n`;
+ xml += ` ${escapeXml(persona.role)}\n`;
}
if (persona.identity) {
- xml += ` ${this.escapeXml(persona.identity)}\n`;
+ xml += ` ${escapeXml(persona.identity)}\n`;
}
if (persona.communication_style) {
- xml += ` ${this.escapeXml(persona.communication_style)}\n`;
+ xml += ` ${escapeXml(persona.communication_style)}\n`;
}
if (persona.principles) {
@@ -260,7 +261,7 @@ class YamlXmlBuilder {
} else {
principlesText = persona.principles;
}
- xml += ` ${this.escapeXml(principlesText)}\n`;
+ xml += ` ${escapeXml(principlesText)}\n`;
}
xml += ' \n';
@@ -277,7 +278,7 @@ class YamlXmlBuilder {
let xml = ' \n';
for (const memory of memories) {
- xml += ` ${this.escapeXml(memory)}\n`;
+ xml += ` ${escapeXml(memory)}\n`;
}
xml += ' \n';
@@ -314,7 +315,7 @@ class YamlXmlBuilder {
for (const prompt of promptsArray) {
xml += ` \n`;
xml += ` \n`;
- xml += `${this.escapeXml(prompt.content || '')}\n`;
+ xml += `${escapeXml(prompt.content || '')}\n`;
xml += ` \n`;
xml += ` \n`;
}
@@ -351,7 +352,7 @@ class YamlXmlBuilder {
// Handle multi format menu items with nested handlers
if (item.multi && item.triggers && Array.isArray(item.triggers)) {
- xml += ` - ${this.escapeXml(item.multi)}\n`;
+ xml += `
- ${escapeXml(item.multi)}\n`;
xml += this.buildNestedHandlers(item.triggers);
xml += `
\n`;
}
@@ -381,7 +382,7 @@ class YamlXmlBuilder {
if (item.data) attrs.push(`data="${item.data}"`);
if (item.action) attrs.push(`action="${item.action}"`);
- xml += ` - ${this.escapeXml(item.description || '')}
\n`;
+ xml += ` - ${escapeXml(item.description || '')}
\n`;
}
}
}
@@ -412,7 +413,7 @@ class YamlXmlBuilder {
// For nested handlers in multi items, we don't need cmd attribute
// The match attribute will handle fuzzy matching
- const attrs = [`match="${this.escapeXml(execData.description || '')}"`];
+ const attrs = [`match="${escapeXml(execData.description || '')}"`];
// Add handler attributes based on exec data
if (execData.route) attrs.push(`exec="${execData.route}"`);
@@ -482,19 +483,6 @@ class YamlXmlBuilder {
return result;
}
- /**
- * Escape XML special characters
- */
- escapeXml(text) {
- if (!text) return '';
- return text
- .replaceAll('&', '&')
- .replaceAll('<', '<')
- .replaceAll('>', '>')
- .replaceAll('"', '"')
- .replaceAll("'", ''');
- }
-
/**
* Calculate file hash for build tracking
*/
diff --git a/tools/flattener/xml.js b/tools/flattener/xml.js
index a8d999f2..229f9a88 100644
--- a/tools/flattener/xml.js
+++ b/tools/flattener/xml.js
@@ -1,11 +1,5 @@
const fs = require('fs-extra');
-
-function escapeXml(string_) {
- if (typeof string_ !== 'string') {
- return String(string_);
- }
- return string_.replaceAll('&', '&').replaceAll('<', '<').replaceAll("'", ''');
-}
+const { escapeXml } = require('../lib/xml-utils');
function indentFileContent(content) {
if (typeof content !== 'string') {
diff --git a/tools/lib/xml-utils.js b/tools/lib/xml-utils.js
new file mode 100644
index 00000000..48237315
--- /dev/null
+++ b/tools/lib/xml-utils.js
@@ -0,0 +1,13 @@
+/**
+ * Escape XML special characters in a string
+ * @param {string} text - The text to escape
+ * @returns {string} The escaped text
+ */
+function escapeXml(text) {
+ if (!text) return '';
+ return text.replaceAll('&', '&').replaceAll('<', '<').replaceAll('>', '>').replaceAll('"', '"').replaceAll("'", ''');
+}
+
+module.exports = {
+ escapeXml,
+};
diff --git a/tools/migrate-custom-module-paths.js b/tools/migrate-custom-module-paths.js
index 843421a4..2c51b820 100755
--- a/tools/migrate-custom-module-paths.js
+++ b/tools/migrate-custom-module-paths.js
@@ -12,7 +12,7 @@ const chalk = require('chalk');
* Find BMAD directory in project
*/
function findBmadDir(projectDir = process.cwd()) {
- const possibleNames = ['.bmad'];
+ const possibleNames = ['_bmad'];
for (const name of possibleNames) {
const bmadDir = path.join(projectDir, name);