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

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

@@ -1,143 +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/-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/-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:** 72
-**Passed:** **\_** / 72
-**Failed:** **\_** / 72
-**Pass Rate:** **\_**%
-
-**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)

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

@@ -1,341 +0,0 @@
-# Audit Workflow - Workflow Quality Audit 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-root}/bmad/bmb/workflows/audit-workflow/workflow.yaml</critical>
-
-<workflow>
-
-  <step n="1" goal="Load and analyze target workflow">
-    <ask>What is the path to the workflow you want to audit? (provide path to workflow.yaml or workflow folder)</ask>
-
-    <action>Load the workflow.yaml file from the provided path</action>
-    <action>Identify the workflow type (document, action, interactive, autonomous, meta)</action>
-    <action>List all associated files:</action>
-
-    - instructions.md (required for most workflows)
-    - template.md (if document workflow)
-    - checklist.md (if validation exists)
-    - Any data files referenced in yaml
-
-    <action>Load all discovered files</action>
-
-    Display summary:
-
-    - Workflow name and description
-    - Type of workflow
-    - Files present
-    - Module assignment
-
-  </step>
-
-  <step n="2" goal="Validate standard config block">
-    <action>Check workflow.yaml for the standard config block:</action>
-
-    **Required variables:**
-
-    - `config_source: "{project-root}/bmad/[module]/config.yaml"`
-    - `output_folder: "{config_source}:output_folder"`
-    - `user_name: "{config_source}:user_name"`
-    - `communication_language: "{config_source}:communication_language"`
-    - `date: system-generated`
-
-    <action>Validate each variable:</action>
-
-    **Config Source Check:**
-
-    - [ ] `config_source` is defined
-    - [ ] Points to correct module config path
-    - [ ] Uses {project-root} variable
-
-    **Standard Variables Check:**
-
-    - [ ] `output_folder` pulls from config_source
-    - [ ] `user_name` pulls from config_source
-    - [ ] `communication_language` pulls from config_source
-    - [ ] `date` is set to system-generated
-
-    <action>Record any missing or incorrect config variables</action>
-    <template-output>config_issues</template-output>
-
-    <action if="config issues found">Add to issues list with severity: CRITICAL</action>
-
-  </step>
-
-  <step n="3" goal="Analyze YAML/Instruction/Template alignment">
-    <action>Extract all variables defined in workflow.yaml (excluding standard config block)</action>
-    <action>Scan instructions.md for variable usage: {variable_name} pattern</action>
-    <action>Scan template.md for variable usage: {{variable_name}} pattern (if exists)</action>
-
-    <action>Cross-reference analysis:</action>
-
-    **For each yaml variable:**
-
-    1. Is it used in instructions.md? (mark as INSTRUCTION_USED)
-    2. Is it used in template.md? (mark as TEMPLATE_USED)
-    3. Is it neither? (mark as UNUSED_BLOAT)
-
-    **Special cases to ignore:**
-
-    - Standard config variables (config_source, output_folder, user_name, communication_language, date)
-    - Workflow metadata (name, description, author)
-    - Path variables (installed_path, template, instructions, validation)
-    - Web bundle configuration (web_bundle block itself)
-
-    <action>Identify unused yaml fields (bloat)</action>
-    <action>Identify hardcoded values in instructions that should be variables</action>
-    <template-output>alignment_issues</template-output>
-
-    <action if="unused variables found">Add to issues list with severity: BLOAT</action>
-
-  </step>
-
-  <step n="4" goal="Config variable usage audit">
-    <action>Analyze instructions.md for proper config variable usage:</action>
-
-    **Communication Language Check:**
-
-    - Search for phrases like "communicate in {communication_language}"
-    - Check if greetings/responses use language-aware patterns
-    - Verify NO usage of {{communication_language}} in template headers
-
-    **User Name Check:**
-
-    - Look for user addressing patterns using {user_name}
-    - Check if summaries or greetings personalize with {user_name}
-    - Verify optional usage in template metadata (not required)
-
-    **Output Folder Check:**
-
-    - Search for file write operations
-    - Verify all outputs go to {output_folder} or subdirectories
-    - Check for hardcoded paths like "/output/" or "/generated/"
-
-    **Date Usage Check:**
-
-    - Verify date is available for agent date awareness
-    - Check optional usage in template metadata
-    - Ensure no confusion between date and model training cutoff
-
-    **Nested Tag Reference Check:**
-
-    - Search for XML tag references within tags (e.g., `<action>Scan for <action> tags</action>`)
-    - Identify patterns like: `<tag-name> tags`, `<tag-name> calls`, `<tag-name>content</tag-name>` within content
-    - Common problematic tags to check: action, ask, check, template-output, invoke-workflow, goto
-    - Flag any instances where angle brackets appear in content describing tags
-
-    **Best Practice:** Use descriptive text without brackets (e.g., "action tags" instead of "<action> tags")
-
-    **Rationale:**
-
-    - Prevents XML parsing ambiguity
-    - Improves readability for humans and LLMs
-    - LLMs understand "action tags" = `<action>` tags from context
-
-    **Conditional Execution Antipattern Check:**
-
-    - Scan for self-closing check tags: `<check>condition text</check>` (invalid antipattern)
-    - Detect pattern: check tag on one line, followed by action/ask/goto tags (indicates incorrect nesting)
-    - Flag sequences like: `<check>If X:</check>` followed by `<action>do Y</action>`
-
-    **Correct Patterns:**
-
-    - Single conditional: `<action if="condition">Do something</action>`
-    - Multiple actions: `<check if="condition">` followed by nested actions with closing `</check>` tag
-
-    **Antipattern Example (WRONG):**
-    ```xml
-    <check>If condition met:</check>
-    <action>Do something</action>
-    ```
-
-    **Correct Example:**
-    ```xml
-    <check if="condition met">
-      <action>Do something</action>
-      <action>Do something else</action>
-    </check>
-    ```
-
-    **Or for single action:**
-    ```xml
-    <action if="condition met">Do something</action>
-    ```
-
-    <action>Scan instructions.md for nested tag references using pattern: &lt;(action|ask|check|template-output|invoke-workflow|goto|step|elicit-required)&gt; within text content</action>
-    <action>Record any instances of nested tag references with line numbers</action>
-    <action>Scan instructions.md for conditional execution antipattern: self-closing check tags</action>
-    <action>Detect pattern: `&lt;check&gt;.*&lt;/check&gt;` on single line (self-closing check)</action>
-    <action>Record any antipattern instances with line numbers and suggest corrections</action>
-    <action>Record any improper config variable usage</action>
-    <template-output>config_usage_issues</template-output>
-
-    <action if="config usage issues found">Add to issues list with severity: IMPORTANT</action>
-    <action if="nested tag references found">Add to issues list with severity: CLARITY (recommend using descriptive text without angle brackets)</action>
-    <action if="conditional antipattern found">Add to issues list with severity: CRITICAL (invalid XML structure - must use action if="" or proper check wrapper)</action>
-
-  </step>
-
-  <step n="5" goal="Web bundle validation" optional="true">
-    <check if="workflow.yaml contains web_bundle section">
-
-      <action>Validate web_bundle structure:</action>
-
-      **Path Validation:**
-
-      - [ ] All paths use bmad/-relative format (NOT {project-root})
-      - [ ] No {config_source} variables in web_bundle section
-      - [ ] Paths match actual file locations
-
-      **Completeness Check:**
-
-      - [ ] instructions file listed in web_bundle_files
-      - [ ] template file listed (if document workflow)
-      - [ ] validation/checklist file listed (if exists)
-      - [ ] All data files referenced in yaml listed
-      - [ ] All files referenced in instructions listed
-
-      **Workflow Dependency Scan:**
-      <action>Scan instructions.md for invoke-workflow tags</action>
-      <action>Extract workflow paths from invocations</action>
-      <action>Verify each called workflow.yaml is in web_bundle_files</action>
-      <action>**CRITICAL**: Check if existing_workflows field is present when workflows are invoked</action>
-      <action>If invoke-workflow calls exist, existing_workflows MUST map workflow variables to paths</action>
-      <action>Example: If instructions use {core_brainstorming}, web_bundle needs: existing_workflows: - core_brainstorming: "bmad/core/workflows/brainstorming/workflow.yaml"</action>
-
-      **File Reference Scan:**
-      <action>Scan instructions.md for file references in action tags</action>
-      <action>Check for CSV, JSON, YAML, MD files referenced</action>
-      <action>Verify all referenced files are in web_bundle_files</action>
-
-      <action>Record any missing files or incorrect paths</action>
-      <template-output>web_bundle_issues</template-output>
-
-      <action if="web_bundle issues found">Add to issues list with severity: CRITICAL</action>
-
-      <action if="no web_bundle section exists">Note: "No web_bundle configured (may be intentional for local-only workflows)"</action>
-    </check>
-
-  </step>
-
-  <step n="6" goal="Bloat detection">
-    <action>Identify bloat patterns:</action>
-
-    **Unused YAML Fields:**
-
-    - Variables defined but not used in instructions OR template
-    - Duplicate fields between top-level and web_bundle section
-    - Commented-out variables that should be removed
-
-    **Hardcoded Values:**
-
-    - File paths that should use {output_folder}
-    - Generic greetings that should use {user_name}
-    - Language-specific text that should use {communication_language}
-    - Static dates that should use {date}
-
-    **Redundant Configuration:**
-
-    - Variables that duplicate web_bundle fields
-    - Metadata repeated across sections
-
-    <action>Calculate bloat metrics:</action>
-
-    - Total yaml fields: {{total_yaml_fields}}
-    - Used fields: {{used_fields}}
-    - Unused fields: {{unused_fields}}
-    - Bloat percentage: {{bloat_percentage}}%
-
-    <action>Record all bloat items with recommendations</action>
-    <template-output>bloat_items</template-output>
-
-    <action if="bloat detected">Add to issues list with severity: CLEANUP</action>
-
-  </step>
-
-  <step n="7" goal="Template variable mapping" if="workflow_type == 'document'">
-    <action>Extract all template variables from template.md: {{variable_name}} pattern</action>
-    <action>Scan instructions.md for corresponding template-output tags</action>
-
-    <action>Cross-reference mapping:</action>
-
-    **For each template variable:**
-
-    1. Is there a matching template-output tag? (mark as MAPPED)
-    2. Is it a standard config variable? (mark as CONFIG_VAR - optional)
-    3. Is it unmapped? (mark as MISSING_OUTPUT)
-
-    **For each template-output tag:**
-
-    1. Is there a matching template variable? (mark as USED)
-    2. Is it orphaned? (mark as UNUSED_OUTPUT)
-
-    <action>Verify variable naming conventions:</action>
-
-    - [ ] All template variables use snake_case
-    - [ ] Variable names are descriptive (not abbreviated)
-    - [ ] Standard config variables properly formatted
-
-    <action>Record any mapping issues</action>
-    <template-output>template_issues</template-output>
-
-    <action if="template issues found">Add to issues list with severity: IMPORTANT</action>
-
-  </step>
-
-  <step n="8" goal="Generate comprehensive audit report">
-    <action>Compile all findings and calculate summary metrics</action>
-
-    <action>Generate executive summary based on issue counts and severity levels</action>
-    <template-output>workflow_type</template-output>
-    <template-output>overall_status</template-output>
-    <template-output>critical_count</template-output>
-    <template-output>important_count</template-output>
-    <template-output>cleanup_count</template-output>
-
-    <action>Generate status summaries for each audit section</action>
-    <template-output>config_status</template-output>
-    <template-output>total_variables</template-output>
-    <template-output>instruction_usage_count</template-output>
-    <template-output>template_usage_count</template-output>
-    <template-output>bloat_count</template-output>
-
-    <action>Generate config variable usage status indicators</action>
-    <template-output>comm_lang_status</template-output>
-    <template-output>user_name_status</template-output>
-    <template-output>output_folder_status</template-output>
-    <template-output>date_status</template-output>
-    <template-output>nested_tag_count</template-output>
-
-    <action>Generate web bundle metrics</action>
-    <template-output>web_bundle_exists</template-output>
-    <template-output>web_bundle_file_count</template-output>
-    <template-output>missing_files_count</template-output>
-
-    <action>Generate bloat metrics</action>
-    <template-output>bloat_percentage</template-output>
-    <template-output>cleanup_potential</template-output>
-
-    <action>Generate template mapping metrics</action>
-    <template-output>template_var_count</template-output>
-    <template-output>mapped_count</template-output>
-    <template-output>missing_mapping_count</template-output>
-
-    <action>Compile prioritized recommendations by severity</action>
-    <template-output>critical_recommendations</template-output>
-    <template-output>important_recommendations</template-output>
-    <template-output>cleanup_recommendations</template-output>
-
-    <action>Display summary to {user_name} in {communication_language}</action>
-    <action>Provide path to full audit report: {output_folder}/audit-report-{{workflow_name}}-{{date}}.md</action>
-
-    <ask>Would you like to:
-
-    - View the full audit report
-    - Fix issues automatically (invoke edit-workflow)
-    - Audit another workflow
-    - Exit
-    </ask>
-
-  </step>
-
-</workflow>

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

@@ -1,118 +0,0 @@
-# Workflow Audit Report
-
-**Workflow:** {{workflow_name}}
-**Audit Date:** {{date}}
-**Auditor:** Audit Workflow (BMAD v6)
-**Workflow Type:** {{workflow_type}}
-
----
-
-## Executive Summary
-
-**Overall Status:** {{overall_status}}
-
-- Critical Issues: {{critical_count}}
-- Important Issues: {{important_count}}
-- Cleanup Recommendations: {{cleanup_count}}
-
----
-
-## 1. Standard Config Block Validation
-
-{{config_issues}}
-
-**Status:** {{config_status}}
-
----
-
-## 2. YAML/Instruction/Template Alignment
-
-{{alignment_issues}}
-
-**Variables Analyzed:** {{total_variables}}
-**Used in Instructions:** {{instruction_usage_count}}
-**Used in Template:** {{template_usage_count}}
-**Unused (Bloat):** {{bloat_count}}
-
----
-
-## 3. Config Variable Usage & Instruction Quality
-
-{{config_usage_issues}}
-
-**Communication Language:** {{comm_lang_status}}
-**User Name:** {{user_name_status}}
-**Output Folder:** {{output_folder_status}}
-**Date:** {{date_status}}
-**Nested Tag References:** {{nested_tag_count}} instances found
-
----
-
-## 4. Web Bundle Validation
-
-{{web_bundle_issues}}
-
-**Web Bundle Present:** {{web_bundle_exists}}
-**Files Listed:** {{web_bundle_file_count}}
-**Missing Files:** {{missing_files_count}}
-
----
-
-## 5. Bloat Detection
-
-{{bloat_items}}
-
-**Bloat Percentage:** {{bloat_percentage}}%
-**Cleanup Potential:** {{cleanup_potential}}
-
----
-
-## 6. Template Variable Mapping
-
-{{template_issues}}
-
-**Template Variables:** {{template_var_count}}
-**Mapped Correctly:** {{mapped_count}}
-**Missing Mappings:** {{missing_mapping_count}}
-
----
-
-## Recommendations
-
-### Critical (Fix Immediately)
-
-{{critical_recommendations}}
-
-### Important (Address Soon)
-
-{{important_recommendations}}
-
-### Cleanup (Nice to Have)
-
-{{cleanup_recommendations}}
-
----
-
-## Validation Checklist
-
-Use this checklist to verify fixes:
-
-- [ ] All standard config variables present and correct
-- [ ] No unused yaml fields (bloat removed)
-- [ ] Config variables used appropriately in instructions
-- [ ] Web bundle includes all dependencies
-- [ ] Template variables properly mapped
-- [ ] File structure follows v6 conventions
-
----
-
-## Next Steps
-
-1. Review critical issues and fix immediately
-2. Address important issues in next iteration
-3. Consider cleanup recommendations for optimization
-4. Re-run audit after fixes to verify improvements
-
----
-
-**Audit Complete** - Generated by audit-workflow v1.0

package/src/modules/bmb/workflows/audit-workflow/workflow.yaml

@@ -1,25 +0,0 @@
-# Audit Workflow Configuration
-name: "audit-workflow"
-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."
-author: "BMad"
-
-# Critical variables from config
-config_source: "{project-root}/bmad/bmb/config.yaml"
-output_folder: "{config_source}:output_folder"
-user_name: "{config_source}:user_name"
-communication_language: "{config_source}:communication_language"
-date: system-generated
-
-# Module path and component files
-installed_path: "{project-root}/bmad/bmb/workflows/audit-workflow"
-template: "{installed_path}/template.md"
-instructions: "{installed_path}/instructions.md"
-validation: "{installed_path}/checklist.md"
-
-# Output configuration
-default_output_file: "{output_folder}/audit-report-{{workflow_name}}-{{date}}.md"
-
-standalone: true
-
-# Web bundle configuration
-web_bundle: false # BMB workflows run locally in BMAD-METHOD project