bmad-method 6.0.0-alpha.9 → 6.0.2

package/src/modules/bmb/README.md

@@ -1,194 +0,0 @@
-# BMB - BMad Builder Module
-
-Specialized tools and workflows for creating, customizing, and extending BMad components including agents, workflows, and complete modules.
-
-## Table of Contents
-
-- [Module Structure](#module-structure)
-- [Core Workflows](#core-workflows)
-- [Agent Types](#agent-types)
-- [Quick Start](#quick-start)
-- [Best Practices](#best-practices)
-
-## Module Structure
-
-### 🤖 Agents
-
-**BMad Builder** - Master builder agent orchestrating all creation workflows with deep knowledge of BMad architecture and conventions.
-
-### 📋 Workflows
-
-Comprehensive suite for building and maintaining BMad components.
-
-## Core Workflows
-
-### Creation Workflows
-
-**[create-agent](./workflows/create-agent/README.md)** - Build BMad agents
-
-- Interactive persona development
-- Command structure design
-- YAML source compilation to .md
-
-**[create-workflow](./workflows/create-workflow/README.md)** - Design workflows
-
-- Structured multi-step processes
-- Configuration validation
-- Web bundle support
-
-**[create-module](./workflows/create-module/README.md)** - Build complete modules
-
-- Full module infrastructure
-- Agent and workflow integration
-- Installation automation
-
-**[module-brief](./workflows/module-brief/README.md)** - Strategic planning
-
-- Module blueprint creation
-- Vision and architecture
-- Comprehensive analysis
-
-### Editing Workflows
-
-**[edit-agent](./workflows/edit-agent/README.md)** - Modify existing agents
-
-- Persona refinement
-- Command updates
-- Best practice compliance
-
-**[edit-workflow](./workflows/edit-workflow/README.md)** - Update workflows
-
-- Structure maintenance
-- Configuration updates
-- Documentation sync
-
-**[edit-module](./workflows/edit-module/README.md)** - Module enhancement
-
-- Component modifications
-- Dependency management
-- Version control
-
-### Maintenance Workflows
-
-**[convert-legacy](./workflows/convert-legacy/README.md)** - Migration tool
-
-- v4 to v6 conversion
-- Structure compliance
-- Convention updates
-
-**[audit-workflow](./workflows/audit-workflow/README.md)** - Quality validation
-
-- Structure verification
-- Config standards check
-- Bloat detection
-- Web bundle completeness
-
-**[redoc](./workflows/redoc/README.md)** - Auto-documentation
-
-- Reverse-tree approach
-- Technical writer quality
-- Convention compliance
-
-## Agent Types
-
-BMB creates three agent architectures:
-
-### Full Module Agent
-
-- Complete persona and role definition
-- Command structure with fuzzy matching
-- Workflow integration
-- Module-specific capabilities
-
-### Hybrid Agent
-
-- Shared core capabilities
-- Module-specific extensions
-- Cross-module compatibility
-
-### Standalone Agent
-
-- Independent operation
-- Minimal dependencies
-- Specialized single purpose
-
-## Quick Start
-
-1. **Load BMad Builder agent** in your IDE
-2. **Choose creation type:**
-   ```
-   *create-agent     # New agent
-   *create-workflow  # New workflow
-   *create-module    # Complete module
-   ```
-3. **Follow interactive prompts**
-
-### Example: Creating an Agent
-
-```
-User: I need a code review agent
-Builder: *create-agent
-
-[Interactive session begins]
-- Brainstorming phase (optional)
-- Persona development
-- Command structure
-- Integration points
-```
-
-## Use Cases
-
-### Custom Development Teams
-
-Build specialized agents for:
-
-- Domain expertise (legal, medical, finance)
-- Company processes
-- Tool integrations
-- Automation tasks
-
-### Workflow Extensions
-
-Create workflows for:
-
-- Compliance requirements
-- Quality gates
-- Deployment pipelines
-- Custom methodologies
-
-### Complete Solutions
-
-Package modules for:
-
-- Industry verticals
-- Technology stacks
-- Business processes
-- Educational frameworks
-
-## Best Practices
-
-1. **Study existing patterns** - Review BMM/CIS implementations
-2. **Follow conventions** - Use established structures
-3. **Document thoroughly** - Clear instructions essential
-4. **Test iteratively** - Validate during creation
-5. **Consider reusability** - Build modular components
-
-## Integration
-
-BMB components integrate with:
-
-- **BMad Core** - Framework foundation
-- **BMM** - Extend development capabilities
-- **CIS** - Leverage creative workflows
-- **Custom Modules** - Your domain solutions
-
-## Related Documentation
-
-- **[Agent Creation Guide](./workflows/create-agent/README.md)** - Detailed instructions
-- **[Module Structure](./workflows/create-module/module-structure.md)** - Architecture patterns
-- **[BMM Module](../bmm/README.md)** - Reference implementation
-- **[Core Framework](../../core/README.md)** - Foundation concepts
-
----
-
-BMB empowers you to extend BMad Method for your specific needs while maintaining framework consistency and power.

package/src/modules/bmb/_module-installer/install-config.yaml

@@ -1,31 +0,0 @@
-# BMAD™ Method Core Configuration
-
-code: bmb
-name: "BMB: BMad Builder - Agent, Workflow and Module Builder"
-default_selected: false # This module will not be selected by default for new installations
-
-header: "BMad Optimized Builder (BoMB) Module Configuration"
-subheader: "Configure the settings for the BoMB Factory!\nThe agent, workflow and module builder for BMAD™"
-
-# Variables from Core Config inserted:
-## user_name
-## communication_language
-## output_folder
-## bmad_folder
-## install_user_docs
-## kb_install
-
-custom_agent_location:
-  prompt: "Where do custom agents get created?"
-  default: "{bmad_folder}/custom/agents"
-  result: "{project-root}/{value}"
-
-custom_workflow_location:
-  prompt: "Where do custom workflows get stored?"
-  default: "{bmad_folder}/custom/workflows"
-  result: "{project-root}/{value}"
-
-custom_module_location:
-  prompt: "Where do custom modules get stored?"
-  default: "{bmad_folder}/custom/modules"
-  result: "{project-root}/{value}"

package/src/modules/bmb/agents/bmad-builder.agent.yaml

@@ -1,59 +0,0 @@
-# BMad Builder Agent Definition
-# Master BMad Module Agent Team and Workflow Builder and Maintainer
-
-agent:
-  webskip: true
-  metadata:
-    id: "{bmad_folder}/bmb/agents/bmad-builder.md"
-    name: BMad Builder
-    title: BMad Builder
-    icon: 🧙
-    module: bmb
-
-  persona:
-    role: Master BMad Module Agent Team and Workflow Builder and Maintainer
-    identity: Lives to serve the expansion of the BMad Method
-    communication_style: Talks like a pulp super hero
-    principles:
-      - Execute resources directly
-      - Load resources at runtime never pre-load
-      - Always present numbered lists for choices
-
-  # Menu items - triggers will be prefixed with * at build time
-  # help and exit are auto-injected, don't define them here
-  menu:
-    - trigger: audit-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/audit-workflow/workflow.yaml"
-      description: Audit existing workflows for BMAD Core compliance and best practices
-
-    - trigger: convert
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/convert-legacy/workflow.yaml"
-      description: Convert v4 or any other style task agent or template to a workflow
-
-    - trigger: create-agent
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml"
-      description: Create a new BMAD Core compliant agent
-
-    - trigger: create-module
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml"
-      description: Create a complete BMAD compatible module (custom agents and workflows)
-
-    - trigger: create-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml"
-      description: Create a new BMAD Core workflow with proper structure
-
-    - trigger: edit-agent
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
-      description: Edit existing agents while following best practices
-
-    - trigger: edit-module
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.yaml"
-      description: Edit existing modules (structure, agents, workflows, documentation)
-
-    - trigger: edit-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
-      description: Edit existing workflows while following best practices
-
-    - trigger: redoc
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/redoc/workflow.yaml"
-      description: Create or update module documentation

package/src/modules/bmb/workflows/audit-workflow/checklist.md

@@ -1,142 +0,0 @@
-# Audit Workflow - Validation Checklist
-
-## Structure
-
-- [ ] workflow.yaml file loads without YAML syntax errors
-- [ ] instructions.md file exists and is properly formatted
-- [ ] template.md file exists (if document workflow) with valid markdown
-- [ ] All critical headers present in instructions (workflow engine reference, workflow.yaml reference)
-- [ ] Workflow type correctly identified (document/action/interactive/autonomous/meta)
-- [ ] All referenced files actually exist at specified paths
-- [ ] No placeholder text remains (like {TITLE}, {WORKFLOW_CODE}, TODO, etc.)
-
-## Standard Config Block
-
-- [ ] workflow.yaml contains `config_source` pointing to correct module config
-- [ ] `output_folder` pulls from `{config_source}:output_folder`
-- [ ] `user_name` pulls from `{config_source}:user_name`
-- [ ] `communication_language` pulls from `{config_source}:communication_language`
-- [ ] `date` is set to `system-generated`
-- [ ] Config source uses {project-root} variable (not hardcoded path)
-- [ ] Standard config comment present: "Critical variables from config"
-
-## Config Variable Usage
-
-- [ ] Instructions communicate in {communication_language} where appropriate
-- [ ] Instructions address {user_name} in greetings or summaries where appropriate
-- [ ] All file outputs write to {output_folder} or subdirectories (no hardcoded paths)
-- [ ] Template includes {{user_name}} in metadata (optional for document workflows)
-- [ ] Template includes {{date}} in metadata (optional for document workflows)
-- [ ] Template does NOT use {{communication_language}} in headers (agent-only variable)
-- [ ] No hardcoded language-specific text that should use {communication_language}
-- [ ] Date used for agent date awareness (not confused with training cutoff)
-
-## YAML/Instruction/Template Alignment
-
-- [ ] Every workflow.yaml variable (excluding standard config) is used in instructions OR template
-- [ ] No unused yaml fields present (bloat removed)
-- [ ] No duplicate fields between top-level and web_bundle section
-- [ ] All template variables ({{variable}}) have corresponding yaml definitions OR <template-output> tags
-- [ ] All <template-output> tags have corresponding template variables (if document workflow)
-- [ ] Template variables use snake_case naming convention
-- [ ] Variable names are descriptive (not abbreviated like {{puj}} instead of {{primary_user_journey}})
-- [ ] No hardcoded values in instructions that should be yaml variables
-
-## Web Bundle Validation (if applicable)
-
-- [ ] web_bundle section present if workflow needs deployment
-- [ ] All paths in web_bundle use {bmad_folder}/-relative format (NOT {project-root})
-- [ ] No {config_source} variables in web_bundle section
-- [ ] instructions file listed in web_bundle_files array
-- [ ] template file listed in web_bundle_files (if document workflow)
-- [ ] validation/checklist file listed in web_bundle_files (if exists)
-- [ ] All data files (CSV, JSON, YAML) listed in web_bundle_files
-- [ ] All <invoke-workflow> called workflows have their .yaml files in web_bundle_files
-- [ ] **CRITICAL**: If workflow invokes other workflows, existing_workflows field is present
-- [ ] existing_workflows maps workflow variables to {bmad_folder}/-relative paths correctly
-- [ ] All files referenced in instructions <action> tags listed in web_bundle_files
-- [ ] No files listed in web_bundle_files that don't exist
-- [ ] Web bundle metadata (name, description, author) matches top-level metadata
-
-## Template Validation (if document workflow)
-
-- [ ] Template variables match <template-output> tags in instructions exactly
-- [ ] All required sections present in template structure
-- [ ] Template uses {{variable}} syntax (double curly braces)
-- [ ] Template variables use snake_case (not camelCase or PascalCase)
-- [ ] Standard metadata header format correct (optional usage of {{date}}, {{user_name}})
-- [ ] No placeholders remain in template (like {SECTION_NAME})
-- [ ] Template structure matches document purpose
-
-## Instructions Quality
-
-- [ ] Each step has n="X" attribute with sequential numbering
-- [ ] Each step has goal="clear goal statement" attribute
-- [ ] Optional steps marked with optional="true"
-- [ ] Repeating steps have appropriate repeat attribute (repeat="3", repeat="for-each-X", repeat="until-approved")
-- [ ] Conditional steps have if="condition" attribute
-- [ ] XML tags used correctly (<action>, <ask>, <check>, <goto>, <invoke-workflow>, <template-output>)
-- [ ] No nested tag references in content (use "action tags" not "<action> tags")
-- [ ] Tag references use descriptive text without angle brackets for clarity
-- [ ] No conditional execution antipattern (no self-closing <check> tags)
-- [ ] Single conditionals use <action if="condition"> (inline)
-- [ ] Multiple conditionals use <check if="condition">...</check> (wrapper block with closing tag)
-- [ ] Steps are focused (single goal per step)
-- [ ] Instructions are specific with limits ("Write 1-2 paragraphs" not "Write about")
-- [ ] Examples provided where helpful
-- [ ] <template-output> tags save checkpoints for document workflows
-- [ ] Flow control is logical and clear
-
-## Bloat Detection
-
-- [ ] Bloat percentage under 10% (unused yaml fields / total fields)
-- [ ] No commented-out variables that should be removed
-- [ ] No duplicate metadata between sections
-- [ ] No variables defined but never referenced
-- [ ] No redundant configuration that duplicates web_bundle
-
-## Final Validation
-
-### Critical Issues (Must fix immediately)
-
-_List any critical issues found:_
-
-- Issue 1:
-- Issue 2:
-- Issue 3:
-
-### Important Issues (Should fix soon)
-
-_List any important issues found:_
-
-- Issue 1:
-- Issue 2:
-- Issue 3:
-
-### Cleanup Recommendations (Nice to have)
-
-_List any cleanup recommendations:_
-
-- Recommendation 1:
-- Recommendation 2:
-- Recommendation 3:
-
----
-
-## Audit Summary
-
-**Total Checks:**
-**Passed:** {total}
-**Failed:** {total}
-
-**Recommendation:**
-
-- Pass Rate ≥ 95%: Excellent - Ready for production
-- Pass Rate 85-94%: Good - Minor fixes needed
-- Pass Rate 70-84%: Fair - Important issues to address
-- Pass Rate < 70%: Poor - Significant work required
-
----
-
-**Audit Completed:** {{date}}
-**Auditor:** Audit Workflow (BMAD v6)