installer cleanup

Author: Brian Madison

src/bmm/module-help.csv

@@ -1,11 +1,11 @@
 module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs
-core,,Advanced Elicitation,AE,10,_bmad/core/workflows/advanced-elicitation/workflow.xml,bmad:advanced-elicitation,false,,,"Apply elicitation methods iteratively to enhance content being generated, presenting options and allowing reshuffle or full method listing for comprehensive content improvement",,
-core,,Brainstorming,BS,20,_bmad/core/workflows/brainstorming/workflow.md,bmad:brainstorming,false,analyst,,Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods,{output_folder}/brainstorming/brainstorming-session-{{date}}.md,,
-core,,Party Mode,PM,30,_bmad/core/workflows/party-mode/workflow.md,bmad:party-mode,false,party-mode facilitator,,Orchestrates group discussions between all installed BMAD agents enabling natural multi-agent conversations,,
-core,,bmad-help,BH,40,_bmad/core/tasks/bmad-help.md,bmad:help,false,system,,Get unstuck by showing what workflow steps come next or answering questions about what to do in the BMad Method,,
-core,,Index Docs,ID,50,_bmad/core/tasks/index-docs.xml,bmad:index-docs,false,llm,,Generates or updates an index.md of all documents in the specified directory,,
-core,,Execute Workflow,WF,60,_bmad/core/tasks/workflow.xml,bmad:workflow,false,llm,,Execute given workflow by loading its configuration following instructions and producing output,,
-core,,Shard Document,SD,70,_bmad/core/tasks/shard-doc.xml,bmad:shard-doc,false,llm,,Splits large markdown documents into smaller organized files based on level 2 sections,,
-core,,Editorial Review - Prose,EP,80,_bmad/core/tasks/editorial-review-prose.xml,bmad:editorial-review-prose,false,llm,reader_type,Clinical copy-editor that reviews text for communication issues,,"three-column markdown table with suggested fixes",
-core,,Editorial Review - Structure,ES,90,_bmad/core/tasks/editorial-review-structure.xml,bmad:editorial-review-structure,false,llm,,Structural editor that proposes cuts reorganization and simplification while preserving comprehension,,
-core,,Adversarial Review (General),AR,100,_bmad/core/tasks/review-adversarial-general.xml,bmad:review-adversarial-general,false,llm,,Cynically review content and produce findings,,
+core,,Advanced Elicitation,AE,10,_bmad/core/workflows/advanced-elicitation/workflow.xml,bmad_advanced-elicitation,false,,,"Apply elicitation methods iteratively to enhance content being generated, presenting options and allowing reshuffle or full method listing for comprehensive content improvement",,
+core,,Brainstorming,BS,20,_bmad/core/workflows/brainstorming/workflow.md,bmad_brainstorming,false,analyst,,Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods,{output_folder}/brainstorming/brainstorming-session-{{date}}.md,,
+core,,Party Mode,PM,30,_bmad/core/workflows/party-mode/workflow.md,bmad_party-mode,false,party-mode facilitator,,Orchestrates group discussions between all installed BMAD agents enabling natural multi-agent conversations,,
+core,,bmad-help,BH,40,_bmad/core/tasks/bmad-help.md,bmad_help,false,system,,Get unstuck by showing what workflow steps come next or answering questions about what to do in the BMad Method,,
+core,,Index Docs,ID,50,_bmad/core/tasks/index-docs.xml,bmad_index-docs,false,llm,,Generates or updates an index.md of all documents in the specified directory,,
+core,,Execute Workflow,WF,60,_bmad/core/tasks/workflow.xml,bmad_workflow,false,llm,,Execute given workflow by loading its configuration following instructions and producing output,,
+core,,Shard Document,SD,70,_bmad/core/tasks/shard-doc.xml,bmad_shard-doc,false,llm,,Splits large markdown documents into smaller organized files based on level 2 sections,,
+core,,Editorial Review - Prose,EP,80,_bmad/core/tasks/editorial-review-prose.xml,bmad_editorial-review-prose,false,llm,reader_type,Clinical copy-editor that reviews text for communication issues,,"three-column markdown table with suggested fixes",
+core,,Editorial Review - Structure,ES,90,_bmad/core/tasks/editorial-review-structure.xml,bmad_editorial-review-structure,false,llm,,Structural editor that proposes cuts reorganization and simplification while preserving comprehension,,
+core,,Adversarial Review (General),AR,100,_bmad/core/tasks/review-adversarial-general.xml,bmad_review-adversarial-general,false,llm,,Cynically review content and produce findings,,

src/core/module-help.csv

@@ -2,9 +2,9 @@
 
 ## Overview
 
-Standardize IDE installers to use **flat file naming** and centralize duplicated code in shared utilities.
+Standardize IDE installers to use **flat file naming** with **underscores** (Windows-compatible) and centralize duplicated code in shared utilities.
 
-**Key Rule: Only folder-based IDEs convert to colon format. IDEs already using dashes keep using dashes.**
+**Key Rule: All IDEs use underscore format for Windows compatibility (colons don't work on Windows).**
 
 ## Current State Analysis
 
@@ -15,10 +15,10 @@ Standardize IDE installers to use **flat file naming** and centralize duplicated
 | **claude-code** | Hierarchical | `.claude/commands/bmad/{module}/agents/{name}.md` |
 | **cursor** | Hierarchical | `.cursor/commands/bmad/{module}/agents/{name}.md` |
 | **crush** | Hierarchical | `.crush/commands/bmad/{module}/agents/{name}.md` |
-| **antigravity** | Flattened (dashes) | `.agent/workflows/bmad-module-agents-name.md` |
-| **codex** | Flattened (dashes) | `~/.codex/prompts/bmad-module-agents-name.md` |
-| **cline** | Flattened (dashes) | `.clinerules/workflows/bmad-module-type-name.md` |
-| **roo** | Flattened (dashes) | `.roo/commands/bmad-{module}-agent-{name}.md` |
+| **antigravity** | Flattened (underscores) | `.agent/workflows/bmad_module_agents_name.md` |
+| **codex** | Flattened (underscores) | `~/.codex/prompts/bmad_module_agents_name.md` |
+| **cline** | Flattened (underscores) | `.clinerules/workflows/bmad_module_type_name.md` |
+| **roo** | Flattened (underscores) | `.roo/commands/bmad_module_agent_name.md` |
 | **auggie** | Hybrid | `.augment/commands/bmad/agents/{module}-{name}.md` |
 | **iflow** | Hybrid | `.iflow/commands/bmad/agents/{module}-{name}.md` |
 | **trae** | Different (rules) | `.trae/rules/bmad-agent-{module}-{name}.md` |
@@ -40,35 +40,24 @@ All currently create artifacts with **nested relative paths** like `{module}/age
 
 ## Target Standardization
 
-### For Folder-Based IDEs (convert to colon format)
+### For All IDEs (underscore format - Windows-compatible)
 
-**IDEs affected:** claude-code, cursor, crush
+**IDEs affected:** claude-code, cursor, crush, antigravity, codex, cline, roo
 
 ```
-Format: bmad:{module}:{type}:{name}.md
+Format: bmad_{module}_{type}_{name}.md
 
 Examples:
-- Agent:      bmad:bmm:agents:pm.md
-- Agent:      bmad:core:agents:dev.md
-- Workflow:   bmad:bmm:workflows:correct-course.md
-- Task:       bmad:bmm:tasks:bmad-help.md
-- Tool:       bmad:core:tools:code-review.md
-- Custom:     bmad:custom:agents:fred-commit-poet.md
+- Agent:      bmad_bmm_agents_pm.md
+- Agent:      bmad_core_agents_dev.md
+- Workflow:   bmad_bmm_workflows_correct-course.md
+- Task:       bmad_bmm_tasks_bmad-help.md
+- Tool:       bmad_core_tools_code-review.md
+- Custom:     bmad_custom_agents_fred-commit-poet.md
 ```
 
-### For Already-Flat IDEs (keep using dashes)
-
-**IDEs affected:** antigravity, codex, cline, roo
-
-```
-Format: bmad-{module}-{type}-{name}.md
-
-Examples:
-- Agent:      bmad-bmm-agents-pm.md
-- Workflow:   bmad-bmm-workflows-correct-course.md
-- Task:       bmad-bmm-tasks-bmad-help.md
-- Custom:     bmad-custom-agents-fred-commit-poet.md
-```
+**Note:** Type segments (agents, workflows, tasks, tools) are filtered out from names:
+- `bmm/agents/pm.md` → `bmad_bmm_pm.md` (not `bmad_bmm_agents_pm.md`)
 
 ### For Hybrid IDEs (keep as-is)
 
@@ -88,57 +77,50 @@ These use `{module}-{name}.md` format within subdirectories - keep as-is.
 
 ```javascript
 /**
- * Convert hierarchical path to flat colon-separated name (for folder-based IDEs)
+ * Convert hierarchical path to flat underscore-separated name (Windows-compatible)
  * @param {string} module - Module name (e.g., 'bmm', 'core')
- * @param {string} type - Artifact type ('agents', 'workflows', 'tasks', 'tools')
+ * @param {string} type - Artifact type ('agents', 'workflows', 'tasks', 'tools') - filtered out
  * @param {string} name - Artifact name (e.g., 'pm', 'correct-course')
- * @returns {string} Flat filename like 'bmad:bmm:agents:pm.md'
- */
-function toColonName(module, type, name) {
-  return `bmad:${module}:${type}:${name}.md`;
-}
-
-/**
- * Convert relative path to flat colon-separated name (for folder-based IDEs)
- * @param {string} relativePath - Path like 'bmm/agents/pm.md'
- * @returns {string} Flat filename like 'bmad:bmm:agents:pm.md'
+ * @returns {string} Flat filename like 'bmad_bmm_pm.md'
  */
-function toColonPath(relativePath) {
-  const withoutExt = relativePath.replace('.md', '');
-  const parts = withoutExt.split(/[\/\\]/);
-  return `bmad:${parts.join(':')}.md`;
+function toUnderscoreName(module, type, name) {
+  return `bmad_${module}_${name}.md`;
 }
 
 /**
- * Convert hierarchical path to flat dash-separated name (for flat IDEs)
+ * Convert relative path to flat underscore-separated name (Windows-compatible)
  * @param {string} relativePath - Path like 'bmm/agents/pm.md'
- * @returns {string} Flat filename like 'bmad-bmm-agents-pm.md'
+ * @returns {string} Flat filename like 'bmad_bmm_pm.md'
  */
-function toDashPath(relativePath) {
+function toUnderscorePath(relativePath) {
   const withoutExt = relativePath.replace('.md', '');
   const parts = withoutExt.split(/[\/\\]/);
-  return `bmad-${parts.join('-')}.md`;
+  // Filter out type segments (agents, workflows, tasks, tools)
+  const filtered = parts.filter((p) => !TYPE_SEGMENTS.includes(p));
+  return `bmad_${filtered.join('_')}.md`;
 }
 
 /**
- * Create custom agent colon name
+ * Create custom agent underscore name
  * @param {string} agentName - Custom agent name
- * @returns {string} Flat filename like 'bmad:custom:agents:fred-commit-poet.md'
+ * @returns {string} Flat filename like 'bmad_custom_fred-commit-poet.md'
  */
-function customAgentColonName(agentName) {
-  return `bmad:custom:agents:${agentName}.md`;
+function customAgentUnderscoreName(agentName) {
+  return `bmad_custom_${agentName}.md`;
 }
 
-/**
- * Create custom agent dash name
- * @param {string} agentName - Custom agent name
- * @returns {string} Flat filename like 'bmad-custom-agents-fred-commit-poet.md'
- */
-function customAgentDashName(agentName) {
-  return `bmad-custom-agents-${agentName}.md`;
-}
+// Backward compatibility aliases
+const toColonName = toUnderscoreName;
+const toColonPath = toUnderscorePath;
+const toDashPath = toUnderscorePath;
+const customAgentColonName = customAgentUnderscoreName;
+const customAgentDashName = customAgentUnderscoreName;
 
 module.exports = {
+  toUnderscoreName,
+  toUnderscorePath,
+  customAgentUnderscoreName,
+  // Backward compatibility
   toColonName,
   toColonPath,
   toDashPath,
@@ -157,34 +139,26 @@ module.exports = {
 **Changes:**
 1. Import path utilities
 2. Change `relativePath` to use flat format
-3. Add method `writeColonArtifacts()` for folder-based IDEs
-4. Add method `writeDashArtifacts()` for flat IDEs
+3. Add method `writeColonArtifacts()` for folder-based IDEs (uses underscore)
+4. Add method `writeDashArtifacts()` for flat IDEs (uses underscore)
 
-### Phase 3: Update Folder-Based IDEs
+### Phase 3: Update All IDEs
 
 **Files to modify:**
 - `claude-code.js`
 - `cursor.js`
 - `crush.js`
-
-**Changes:**
-1. Import `toColonPath`, `customAgentColonName` from path-utils
-2. Change from hierarchical to flat colon naming
-3. Update cleanup to handle flat structure
-
-### Phase 4: Update Flat IDEs
-
-**Files to modify:**
 - `antigravity.js`
 - `codex.js`
 - `cline.js`
 - `roo.js`
 
 **Changes:**
-1. Import `toDashPath`, `customAgentDashName` from path-utils
-2. Replace local `flattenFilename()` with shared `toDashPath()`
+1. Import utilities from path-utils
+2. Change from hierarchical to flat underscore naming
+3. Update cleanup to handle flat structure (`startsWith('bmad')`)
 
-### Phase 5: Update Base Class
+### Phase 4: Update Base Class
 
 **File:** `_base-ide.js`
 
@@ -195,24 +169,23 @@ module.exports = {
 ## Migration Checklist
 
 ### New Files
-- [ ] Create `shared/path-utils.js`
-
-### Folder-Based IDEs (convert to colon format)
-- [ ] Update `shared/agent-command-generator.js` - add `writeColonArtifacts()`
-- [ ] Update `shared/task-tool-command-generator.js` - add `writeColonArtifacts()`
-- [ ] Update `shared/workflow-command-generator.js` - add `writeColonArtifacts()`
-- [ ] Update `claude-code.js` - convert to colon format
-- [ ] Update `cursor.js` - convert to colon format
-- [ ] Update `crush.js` - convert to colon format
-
-### Flat IDEs (standardize dash format)
-- [ ] Update `shared/agent-command-generator.js` - add `writeDashArtifacts()`
-- [ ] Update `shared/task-tool-command-generator.js` - add `writeDashArtifacts()`
-- [ ] Update `shared/workflow-command-generator.js` - add `writeDashArtifacts()`
-- [ ] Update `antigravity.js` - use shared `toDashPath()`
-- [ ] Update `codex.js` - use shared `toDashPath()`
-- [ ] Update `cline.js` - use shared `toDashPath()`
-- [ ] Update `roo.js` - use shared `toDashPath()`
+- [x] Create `shared/path-utils.js`
+
+### All IDEs (convert to underscore format)
+- [x] Update `shared/agent-command-generator.js` - update for underscore
+- [x] Update `shared/task-tool-command-generator.js` - update for underscore
+- [x] Update `shared/workflow-command-generator.js` - update for underscore
+- [x] Update `claude-code.js` - convert to underscore format
+- [x] Update `cursor.js` - convert to underscore format
+- [x] Update `crush.js` - convert to underscore format
+- [ ] Update `antigravity.js` - use underscore format
+- [ ] Update `codex.js` - use underscore format
+- [ ] Update `cline.js` - use underscore format
+- [ ] Update `roo.js` - use underscore format
+
+### CSV Command Files
+- [x] Update `src/core/module-help.csv` - change colons to underscores
+- [x] Update `src/bmm/module-help.csv` - change colons to underscores
 
 ### Base Class
 - [ ] Update `_base-ide.js` - add deprecation notice
@@ -228,7 +201,8 @@ module.exports = {
 
 ## Notes
 
-1. **Keep segments**: agents, workflows, tasks, tools all become part of the flat name
-2. **Colon vs Dash**: Colons for folder-based IDEs converting to flat, dashes for already-flat IDEs
+1. **Filter type segments**: agents, workflows, tasks, tools are filtered out from flat names
+2. **Underscore format**: Universal underscore format for Windows compatibility
 3. **Custom agents**: Follow the same pattern as regular agents
-4. **Backward compatibility**: Cleanup will remove old folder structure
+4. **Backward compatibility**: Old function names kept as aliases
+5. **Cleanup**: Will remove old `bmad:` format files on next install

tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md

@@ -127,8 +127,8 @@ class AntigravitySetup extends BaseIdeSetup {
     const { artifacts: agentArtifacts, counts: agentCounts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
     // Write agent launcher files with FLATTENED naming using shared utility
-    // Antigravity ignores directory structure, so we flatten to: bmad-module-name.md
-    // This creates slash commands like /bmad-bmm-dev instead of /dev
+    // Antigravity ignores directory structure, so we flatten to: bmad_module_name.md
+    // This creates slash commands like /bmad_bmm_dev instead of /dev
     const agentCount = await agentGen.writeDashArtifacts(bmadWorkflowsDir, agentArtifacts);
 
     // Process Antigravity specific injections for installed modules
@@ -167,7 +167,7 @@ class AntigravitySetup extends BaseIdeSetup {
       );
     }
     console.log(chalk.dim(`  - Workflows directory: ${path.relative(projectDir, bmadWorkflowsDir)}`));
-    console.log(chalk.yellow(`\n  Note: Antigravity uses flattened slash commands (e.g., /bmad-module-agents-name)`));
+    console.log(chalk.yellow(`\n  Note: Antigravity uses flattened slash commands (e.g., /bmad_module_agents_name)`));
 
     return {
       success: true,
@@ -455,7 +455,7 @@ usage: |
 
 ⚠️ **IMPORTANT**: Run @${agentPath} to load the complete agent before using this launcher!`;
 
-    // Use dash format: bmad-custom-agents-fred-commit-poet.md
+    // Use underscore format: bmad_custom_fred-commit-poet.md
     const fileName = customAgentDashName(agentName);
     const launcherPath = path.join(bmadWorkflowsDir, fileName);
 

tools/cli/installers/lib/ide/antigravity.js

@@ -92,12 +92,12 @@ class ClaudeCodeSetup extends BaseIdeSetup {
   async cleanup(projectDir) {
     const commandsDir = path.join(projectDir, this.configDir, this.commandsDir);
 
-    // Remove any bmad:* files from the commands directory
+    // Remove any bmad* files from the commands directory (cleans up old bmad: and bmad- formats)
     if (await fs.pathExists(commandsDir)) {
       const entries = await fs.readdir(commandsDir);
       let removedCount = 0;
       for (const entry of entries) {
-        if (entry.startsWith('bmad:')) {
+        if (entry.startsWith('bmad')) {
           await fs.remove(path.join(commandsDir, entry));
           removedCount++;
         }
@@ -151,16 +151,16 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     const commandsDir = path.join(claudeDir, this.commandsDir);
     await this.ensureDir(commandsDir);
 
-    // Use colon format: files written directly to commands dir (no bmad subfolder)
-    // Creates: .claude/commands/bmad:bmm:pm.md
+    // Use underscore format: files written directly to commands dir (no bmad subfolder)
+    // Creates: .claude/commands/bmad_bmm_pm.md
 
     // Generate agent launchers using AgentCommandGenerator
     // 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 || []);
 
-    // Write agent launcher files using flat colon naming
-    // Creates files like: bmad:bmm:pm.md
+    // Write agent launcher files using flat underscore naming
+    // Creates files like: bmad_bmm_pm.md
     const agentCount = await agentGen.writeColonArtifacts(commandsDir, agentArtifacts);
 
     // Process Claude Code specific injections for installed modules
@@ -182,8 +182,8 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
     const { artifacts: workflowArtifacts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
 
-    // Write workflow-command artifacts using flat colon naming
-    // Creates files like: bmad:bmm:correct-course.md
+    // Write workflow-command artifacts using flat underscore naming
+    // Creates files like: bmad_bmm_correct-course.md
     const workflowCommandCount = await workflowGen.writeColonArtifacts(commandsDir, workflowArtifacts);
 
     // Generate task and tool commands from manifests (if they exist)
@@ -490,7 +490,7 @@ You must fully embody this agent's persona and follow all activation instruction
 </agent-activation>
 `;
 
-    // Use colon format: bmad:custom:agents:fred-commit-poet.md
+    // Use underscore format: bmad_custom_fred-commit-poet.md
     // Written directly to commands dir (no bmad subfolder)
     const launcherName = customAgentColonName(agentName);
     const launcherPath = path.join(commandsDir, launcherName);