installer improvements

.claude/commands/bmad/bmb/agents/bmad-builder.md

@@ -1,6 +1,9 @@
-<!-- Powered by BMAD-CORE™ -->
+---
+name: 'bmad builder'
+description: 'BMad Builder'
+---
 
-# BMad Builder
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 ```xml
 <agent id="bmad/bmb/agents/bmad-builder.md" name="BMad Builder" title="BMad Builder" icon="🧙">
@@ -55,8 +58,10 @@
     <item cmd="*audit-workflow" workflow="{project-root}/bmad/bmb/workflows/audit-workflow/workflow.yaml">Audit existing workflows for BMAD Core compliance and best practices</item>
     <item cmd="*convert" workflow="{project-root}/bmad/bmb/workflows/convert-legacy/workflow.yaml">Convert v4 or any other style task agent or template to a workflow</item>
     <item cmd="*create-agent" workflow="{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml">Create a new BMAD Core compliant agent</item>
-    <item cmd="*create-module" workflow="{project-root}/bmad/bmb/workflows/create-module/workflow.yaml">Create a complete BMAD module (brainstorm → brief → build with agents and workflows)</item>
+    <item cmd="*create-module" workflow="{project-root}/bmad/bmb/workflows/create-module/workflow.yaml">Create a complete BMAD compatible module (custom agents and workflows)</item>
     <item cmd="*create-workflow" workflow="{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml">Create a new BMAD Core workflow with proper structure</item>
+    <item cmd="*edit-agent" workflow="{project-root}/bmad/bmb/workflows/edit-agent/workflow.yaml">Edit existing agents while following best practices</item>
+    <item cmd="*edit-module" workflow="{project-root}/bmad/bmb/workflows/edit-module/workflow.yaml">Edit existing modules (structure, agents, workflows, documentation)</item>
     <item cmd="*edit-workflow" workflow="{project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml">Edit existing workflows while following best practices</item>
     <item cmd="*redoc" workflow="{project-root}/bmad/bmb/workflows/redoc/workflow.yaml">Create or update module documentation</item>
     <item cmd="*exit">Exit with confirmation</item>

.claude/commands/bmad/bmb/workflows/README.md

@@ -27,6 +27,16 @@
 - Path: `bmad/bmb/workflows/create-workflow/workflow.yaml`
 - Interactive workflow builder that guides creation of new BMAD workflows with proper structure and validation for optimal human-AI collaboration. Includes optional brainstorming phase for workflow ideas and design.
 
+**edit-agent**
+
+- Path: `bmad/bmb/workflows/edit-agent/workflow.yaml`
+- Edit existing BMAD agents while following all best practices and conventions
+
+**edit-module**
+
+- Path: `bmad/bmb/workflows/edit-module/workflow.yaml`
+- Edit existing BMAD modules (structure, agents, workflows, documentation) while following all best practices
+
 **edit-workflow**
 
 - Path: `bmad/bmb/workflows/edit-workflow/workflow.yaml`

.claude/commands/bmad/bmb/workflows/audit-workflow.md

@@ -1,3 +1,7 @@
+---
+description: 'Comprehensive workflow quality audit - validates structure, config standards, variable usage, bloat detection, and web_bundle completeness. Performs deep analysis of workflow.yaml, instructions.md, template.md, and web_bundle configuration against BMAD v6 standards.'
+---
+
 # audit-workflow
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/convert-legacy.md

@@ -1,3 +1,7 @@
+---
+description: 'Converts legacy BMAD v4 or similar items (agents, workflows, modules) to BMad Core compliant format with proper structure and conventions'
+---
+
 # convert-legacy
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/create-agent.md

@@ -1,3 +1,7 @@
+---
+description: 'Interactive workflow to build BMAD Core compliant agents (YAML source compiled to .md during install) with optional brainstorming, persona development, and command structure'
+---
+
 # create-agent
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/create-module.md

@@ -1,3 +1,7 @@
+---
+description: 'Interactive workflow to build complete BMAD modules with agents, workflows, tasks, and installation infrastructure'
+---
+
 # create-module
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/create-workflow.md

@@ -1,3 +1,7 @@
+---
+description: 'Interactive workflow builder that guides creation of new BMAD workflows with proper structure and validation for optimal human-AI collaboration. Includes optional brainstorming phase for workflow ideas and design.'
+---
+
 # create-workflow
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/edit-agent.md

@@ -0,0 +1,15 @@
+---
+description: 'Edit existing BMAD agents while following all best practices and conventions'
+---
+
+# edit-agent
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL {project-root}/bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config bmad/bmb/workflows/edit-agent/workflow.yaml
+3. Pass the yaml path bmad/bmb/workflows/edit-agent/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.claude/commands/bmad/bmb/workflows/edit-module.md

@@ -0,0 +1,15 @@
+---
+description: 'Edit existing BMAD modules (structure, agents, workflows, documentation) while following all best practices'
+---
+
+# edit-module
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL {project-root}/bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config bmad/bmb/workflows/edit-module/workflow.yaml
+3. Pass the yaml path bmad/bmb/workflows/edit-module/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.claude/commands/bmad/bmb/workflows/edit-workflow.md

@@ -1,3 +1,7 @@
+---
+description: 'Edit existing BMAD workflows while following all best practices and conventions'
+---
+
 # edit-workflow
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/module-brief.md

@@ -1,3 +1,7 @@
+---
+description: 'Create a comprehensive Module Brief that serves as the blueprint for building new BMAD modules using strategic analysis and creative vision'
+---
+
 # module-brief
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/bmb/workflows/redoc.md

@@ -1,3 +1,7 @@
+---
+description: 'Autonomous documentation system that maintains module, workflow, and agent documentation using a reverse-tree approach (leaf folders first, then parents). Understands BMAD conventions and produces technical writer quality output.'
+---
+
 # redoc
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded: