bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.21

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

@@ -1,24 +0,0 @@
-# {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

@@ -1,13 +0,0 @@
-# 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

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

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

@@ -1,39 +0,0 @@
-# {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

@@ -1,39 +0,0 @@
-# {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

@@ -1,40 +0,0 @@
-# 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

@@ -1,38 +0,0 @@
-# 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

@@ -1,112 +0,0 @@
-# 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

@@ -1,112 +0,0 @@
-# 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)