bmad-method 5.1.3 → 6.0.0-alpha.1

package/bmad/bmb/workflows/create-workflow/workflow-template/checklist.md

@@ -0,0 +1,24 @@
+# {Title} Checklist Validation
+
+## {Section Foo}
+
+- [ ] Check 1
+- [ ] Check 2
+- [ ] ...
+- [ ] Check n
+
+...
+
+## {Section Bar}
+
+- [ ] Check 1
+- [ ] Check 2
+- [ ] ...
+- [ ] Check n
+
+## Final Validation
+
+- [ ] Section Foo
+  - Issue List
+- [ ] Section Bar
+  - Issue List

package/bmad/bmb/workflows/create-workflow/workflow-template/instructions.md

@@ -0,0 +1,13 @@
+# PRD Workflow Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-related}/bmad/{module-code}/workflows/{workflow}/workflow.yaml</critical>
+<critical>Communicate in {communication_language} throughout the workflow process</critical>
+
+<workflow>
+
+<step n="1" goal="">
+...
+</step>
+...
+</workflow>

package/bmad/bmb/workflows/create-workflow/workflow-template/template.md

@@ -0,0 +1,9 @@
+# Title
+
+**Date:** {{date}}
+
+## {Section 1}
+
+{{section_1_results}}
+
+etc...

package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml

@@ -0,0 +1,39 @@
+# {TITLE} Workflow Template Configuration
+name: "{WORKFLOW_CODE}"
+description: "{WORKFLOW_DESCRIPTION}"
+author: "BMad"
+
+# Critical variables load from config_source
+# Add Additional Config Pulled Variables Here
+config_source: "{project-root}/{module-code}/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# Required Data Files - HALT if missing!
+# optional, can be omitted
+brain_techniques: "{installed_path}/{critical-data-file.csv}" # example, can be other formats or URLs
+
+# Optional docs that if loaded on start to kickstart this workflow or used at some point, these are meant to be suggested inputs for the user
+recommended_inputs: # optional, can be omitted
+  - example_input: "{project-root}/{path/to/file.md}"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/{module-code}/workflows/{workflow-code}"
+template: "{installed_path}/template.md" # optional, can be omitted
+instructions: "{installed_path}/instructions.md" # optional, can be omitted
+validation: "{installed_path}/checklist.md" # optional, can be omitted
+
+# Output configuration
+default_output_file: "{output_folder}/{file.md}" # optional, can be omitted
+validation_output_file: "{output_folder}/{file-validation-report.md}" # optional, can be omitted
+
+# Tool Requirements (MCP Required Tools or other tools needed to run this workflow)
+required_tools: #optional, can be omitted
+  - "Tool Name": #example, can be omitted if none
+      description: "Description of why this tool is needed"
+      link: "https://link-to-tool.com"
+# Web Bundle Configuration (optional - for web-deployable workflows)
+# IMPORTANT: Web bundles are self-contained and cannot use config_source variables
+# All referenced files must be listed in web_bundle_files

package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml.bak

@@ -0,0 +1,39 @@
+# {TITLE} Workflow Template Configuration
+name: "{WORKFLOW_CODE}"
+description: "{WORKFLOW_DESCRIPTION}"
+author: "BMad"
+
+# Critical variables load from config_source
+# Add Additional Config Pulled Variables Here
+config_source: "{project-root}/{module-code}/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# Required Data Files - HALT if missing!
+# optional, can be omitted
+brain_techniques: "{installed_path}/{critical-data-file.csv}" # example, can be other formats or URLs
+
+# Optional docs that if loaded on start to kickstart this workflow or used at some point, these are meant to be suggested inputs for the user
+recommended_inputs: # optional, can be omitted
+  - example_input: "{project-root}/{path/to/file.md}"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/{module-code}/workflows/{workflow-code}"
+template: "{installed_path}/template.md" # optional, can be omitted
+instructions: "{installed_path}/instructions.md" # optional, can be omitted
+validation: "{installed_path}/checklist.md" # optional, can be omitted
+
+# Output configuration
+default_output_file: "{output_folder}/{file.md}" # optional, can be omitted
+validation_output_file: "{output_folder}/{file-validation-report.md}" # optional, can be omitted
+
+# Tool Requirements (MCP Required Tools or other tools needed to run this workflow)
+required_tools: #optional, can be omitted
+  - "Tool Name": #example, can be omitted if none
+      description: "Description of why this tool is needed"
+      link: "https://link-to-tool.com"
+# Web Bundle Configuration (optional - for web-deployable workflows)
+# IMPORTANT: Web bundles are self-contained and cannot use config_source variables
+# All referenced files must be listed in web_bundle_files

package/bmad/bmb/workflows/create-workflow/workflow.yaml

@@ -0,0 +1,40 @@
+# Build Workflow - Workflow Builder Configuration
+name: create-workflow
+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."
+author: "BMad Builder"
+
+# Critical variables
+config_source: "{project-root}/bmad/bmb/config.yaml"
+custom_workflow_location: "{config_source}:custom_workflow_location"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+
+# Template files for new workflows
+template_workflow_yaml: "{workflow_template_path}/workflow.yaml"
+template_instructions: "{workflow_template_path}/instructions.md"
+template_template: "{workflow_template_path}/template.md"
+template_checklist: "{workflow_template_path}/checklist.md"
+
+# Optional input docs
+recommended_inputs:
+  - existing_workflows: "{project-root}/bmad/*/workflows/"
+  - bmm_workflows: "{project-root}/bmad/bmm/workflows/"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/create-workflow"
+template: false # This is an action workflow - no template needed
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Required data files - CRITICAL for workflow conventions
+workflow_creation_guide: "{installed_path}/workflow-creation-guide.md"
+workflow_template_path: "{installed_path}/workflow-template"
+
+# Output configuration - Creates the new workflow folder with all files
+# If workflow belongs to a module: Save to module's workflows folder
+# If standalone workflow: Save to custom_workflow_location/{{workflow_name}}
+module_output_folder: "{project-root}/bmad/{{target_module}}/workflows/{{workflow_name}}"
+standalone_output_folder: "{custom_workflow_location}/{{workflow_name}}"
+
+standalone: true
+# Web bundle configuration

package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak

@@ -0,0 +1,38 @@
+# Build Workflow - Workflow Builder Configuration
+name: create-workflow
+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."
+author: "BMad Builder"
+
+# Critical variables
+config_source: "{project-root}/bmad/bmb/config.yaml"
+custom_workflow_location: "{config_source}:custom_workflow_location"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+
+# Template files for new workflows
+template_workflow_yaml: "{workflow_template_path}/workflow.yaml"
+template_instructions: "{workflow_template_path}/instructions.md"
+template_template: "{workflow_template_path}/template.md"
+template_checklist: "{workflow_template_path}/checklist.md"
+
+# Optional input docs
+recommended_inputs:
+  - existing_workflows: "{project-root}/bmad/*/workflows/"
+  - bmm_workflows: "{project-root}/bmad/bmm/workflows/"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/create-workflow"
+template: false # This is an action workflow - no template needed
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Required data files - CRITICAL for workflow conventions
+workflow_creation_guide: "{installed_path}/workflow-creation-guide.md"
+workflow_template_path: "{installed_path}/workflow-template"
+
+# Output configuration - Creates the new workflow folder with all files
+# If workflow belongs to a module: Save to module's workflows folder
+# If standalone workflow: Save to custom_workflow_location/{{workflow_name}}
+module_output_folder: "{project-root}/bmad/{{target_module}}/workflows/{{workflow_name}}"
+standalone_output_folder: "{custom_workflow_location}/{{workflow_name}}"
+# Web bundle configuration

package/bmad/bmb/workflows/edit-agent/README.md

@@ -0,0 +1,112 @@
+# Edit Agent Workflow
+
+Interactive workflow for editing existing BMAD Core agents while maintaining best practices and conventions.
+
+## Purpose
+
+This workflow helps you refine and improve existing agents by:
+
+- Analyzing agents against BMAD Core best practices
+- Identifying issues and improvement opportunities
+- Providing guided editing for specific aspects
+- Validating changes against agent standards
+- Ensuring consistency with agent architecture
+
+## When to Use
+
+Use this workflow when you need to:
+
+- Fix issues in existing agents
+- Add new menu items or workflows
+- Improve agent persona or communication style
+- Update configuration handling
+- Convert between agent types (full/hybrid/standalone)
+- Optimize agent structure and clarity
+
+## What You'll Need
+
+- Path to the agent file you want to edit (.yaml or .md)
+- Understanding of what changes you want to make
+- Access to the agent documentation (loaded automatically)
+
+## Workflow Steps
+
+1. **Load and analyze target agent** - Provide path to agent file
+2. **Analyze against best practices** - Automatic audit of agent structure
+3. **Select editing focus** - Choose what aspect to edit
+4. **Load relevant documentation** - Auto-loads guides based on your choice
+5. **Perform edits** - Review and approve changes iteratively
+6. **Validate all changes** - Comprehensive validation checklist
+7. **Generate change summary** - Summary of improvements made
+
+## Editing Options
+
+The workflow provides 12 focused editing options:
+
+1. **Fix critical issues** - Address broken references, syntax errors
+2. **Add/fix standard config** - Ensure config loading and variable usage
+3. **Refine persona** - Improve role, communication style, principles
+4. **Update activation** - Modify activation steps and greeting
+5. **Manage menu items** - Add, remove, or reorganize commands
+6. **Update workflow references** - Fix paths, add new workflows
+7. **Enhance menu handlers** - Improve handler logic
+8. **Improve command triggers** - Refine asterisk commands
+9. **Optimize agent type** - Convert between full/hybrid/standalone
+10. **Add new capabilities** - Add menu items, workflows, features
+11. **Remove bloat** - Delete unused commands, redundant instructions
+12. **Full review and update** - Comprehensive improvements
+
+## Agent Documentation Loaded
+
+This workflow automatically loads:
+
+- **Agent Types Guide** - Understanding full, hybrid, and standalone agents
+- **Agent Architecture** - Structure, activation, and menu patterns
+- **Command Patterns** - Menu handlers and command triggers
+- **Communication Styles** - Persona and communication guidance
+- **Workflow Execution Engine** - How agents execute workflows
+
+## Output
+
+The workflow modifies your agent file in place, maintaining the original format (YAML or markdown). Changes are reviewed and approved by you before being applied.
+
+## Best Practices
+
+- **Start with analysis** - Let the workflow audit your agent first
+- **Focus your edits** - Choose specific aspects to improve
+- **Review each change** - Approve or modify proposed changes
+- **Validate thoroughly** - Use the validation step to catch issues
+- **Test after editing** - Invoke the edited agent to verify it works
+
+## Tips
+
+- If you're unsure what needs improvement, choose option 12 (Full review)
+- For quick fixes, choose the specific option (like option 6 for workflow paths)
+- The workflow loads documentation automatically - you don't need to read it first
+- You can make multiple rounds of edits in one session
+- Use the validation step to ensure you didn't miss anything
+
+## Related Workflows
+
+- **create-agent** - Create new agents from scratch
+- **edit-workflow** - Edit workflows referenced by agents
+- **audit-workflow** - Audit workflows for compliance
+
+## Example Usage
+
+```
+User: I want to add a new workflow to the PM agent
+Workflow: Analyzes agent → Loads it → You choose option 5 (manage menu items)
+          → Adds new menu item with workflow reference → Validates → Done
+```
+
+## Activation
+
+Invoke via BMad Builder agent:
+
+```
+/bmad:bmb:agents:bmad-builder
+Then select: *edit-agent
+```
+
+Or directly via workflow.xml with this workflow config.

package/bmad/bmb/workflows/edit-agent/checklist.md

@@ -0,0 +1,112 @@
+# Edit Agent - Validation Checklist
+
+Use this checklist to validate agent edits meet BMAD Core standards.
+
+## Agent Structure Validation
+
+- [ ] Agent file format is valid (YAML or markdown/XML)
+- [ ] Agent type is clearly identified (full, hybrid, standalone)
+- [ ] File naming follows convention: `{agent-name}.agent.yaml` or `{agent-name}.agent.md`
+
+## Persona Validation
+
+- [ ] Role is clearly defined and specific
+- [ ] Identity/purpose articulates what the agent does
+- [ ] Communication style is specified (if custom style desired)
+- [ ] Principles are listed and actionable (if applicable)
+
+## Activation Validation
+
+- [ ] Step 1: Loads persona from current agent file
+- [ ] Step 2: Loads config file (if agent needs user context)
+- [ ] Step 3: Sets user context variables (user_name, etc.)
+- [ ] Step 4: Displays greeting using user_name and shows menu
+- [ ] Step 5: WAITs for user input (doesn't auto-execute)
+- [ ] Step 6: Processes user selection (number or trigger text)
+- [ ] Step 7: Executes appropriate menu handler
+
+## Menu Validation
+
+- [ ] All menu items numbered sequentially
+- [ ] Each item has cmd attribute with asterisk trigger (*help, *create, etc.)
+- [ ] Workflow paths are correct (if workflow attribute present)
+- [ ] Help command is present (\*help)
+- [ ] Exit command is present (\*exit)
+- [ ] Menu items are in logical order
+
+## Configuration Validation
+
+- [ ] Config file path is correct for module
+- [ ] Config variables loaded in activation step 2
+- [ ] Error handling present if config fails to load
+- [ ] user_name used in greeting and communication
+- [ ] communication_language used for output
+- [ ] output_folder used for file outputs (if applicable)
+
+## Menu Handler Validation
+
+- [ ] menu-handlers section is present
+- [ ] Workflow handler loads {project-root}/bmad/core/tasks/workflow.xml
+- [ ] Workflow handler passes yaml path as 'workflow-config' parameter
+- [ ] Handlers check for attributes (workflow, exec, tmpl, data, action)
+- [ ] Handler logic is complete and follows patterns
+
+## Workflow Integration Validation
+
+- [ ] All workflow paths exist and are correct
+- [ ] Workflow paths use {project-root} variable
+- [ ] Workflows are appropriate for agent's purpose
+- [ ] Workflow parameters are passed correctly
+
+## Communication Validation
+
+- [ ] Agent communicates in {communication_language}
+- [ ] Communication style matches persona
+- [ ] Error messages are clear and helpful
+- [ ] Confirmation messages for user actions
+
+## Rules Validation
+
+- [ ] Rules section defines agent behavior clearly
+- [ ] File loading rules are specified
+- [ ] Menu trigger format rules are clear
+- [ ] Communication rules align with persona
+
+## Quality Checks
+
+- [ ] No placeholder text remains ({{AGENT_NAME}}, {ROLE}, etc.)
+- [ ] No broken references or missing files
+- [ ] Syntax is valid (YAML or XML)
+- [ ] Indentation is consistent
+- [ ] Agent purpose is clear from reading persona alone
+
+## Type-Specific Validation
+
+### Full Agent
+
+- [ ] Has complete menu system with multiple items
+- [ ] Loads config file for user context
+- [ ] Supports multiple workflows
+- [ ] Session management is clear
+
+### Hybrid Agent
+
+- [ ] Simplified activation (may skip some steps)
+- [ ] Focused set of workflows
+- [ ] May or may not have menu
+- [ ] Config loading is appropriate
+
+### Standalone Agent
+
+- [ ] Single focused purpose
+- [ ] Minimal activation (1-3 steps)
+- [ ] No menu system
+- [ ] Direct execution pattern
+- [ ] May not need config file
+
+## Final Checks
+
+- [ ] Agent file has been saved
+- [ ] File path is in correct module directory
+- [ ] Agent is ready for testing
+- [ ] Documentation is updated (if needed)