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:

.claude/commands/bmad/core/agents/bmad-master.md

@@ -1,6 +1,9 @@
-<!-- Powered by BMAD-CORE™ -->
+---
+name: 'bmad master'
+description: 'BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator'
+---
 
-# BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator
+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/core/agents/bmad-master.md" name="BMad Master" title="BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator" icon="🧙">

.claude/commands/bmad/core/tasks/index-docs.md

@@ -0,0 +1,9 @@
+---
+description: 'Generates or updates an index.md of all documents in the specified directory'
+---
+
+# Index Docs
+
+LOAD and execute the task at: {project-root}/bmad/core/tasks/index-docs.xml
+
+Follow all instructions in the task file exactly as written.

.claude/commands/bmad/core/tools/shard-doc.md

@@ -0,0 +1,9 @@
+---
+description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections'
+---
+
+# Shard Document
+
+LOAD and execute the tool at: {project-root}/bmad/core/tools/shard-doc.xml
+
+Follow all instructions in the tool file exactly as written.

.claude/commands/bmad/core/workflows/brainstorming.md

@@ -1,3 +1,7 @@
+---
+description: 'Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions.'
+---
+
 # brainstorming
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

.claude/commands/bmad/core/workflows/party-mode.md

@@ -1,3 +1,7 @@
+---
+description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations'
+---
+
 # party-mode
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded: