npm - bmad-method - Versions diffs - 6.0.0-alpha.11 → 6.0.0-alpha.13 - Mend

bmad-method 6.0.0-alpha.11 → 6.0.0-alpha.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (491) hide show

package/.github/workflows/bundle-latest.yaml CHANGED Viewed

@@ -100,8 +100,53 @@ jobs:
             fi
           done
-          # Create index.html for GitHub Pages
-          cat > dist/bundles/index.html << 'EOF'
+          # Generate index.html dynamically based on actual bundles
+          TIMESTAMP=$(date -u +"%Y-%m-%d %H:%M UTC")
+          COMMIT_SHA=$(git rev-parse --short HEAD)
+          # Function to generate agent links for a module
+          generate_agent_links() {
+            local module=$1
+            local agent_dir="dist/bundles/$module/agents"
+            if [ ! -d "$agent_dir" ]; then
+              echo ""
+              return
+            fi
+            local links=""
+            local count=0
+            # Find all XML files and generate links
+            for xml_file in "$agent_dir"/*.xml; do
+              if [ -f "$xml_file" ]; then
+                local agent_name=$(basename "$xml_file" .xml)
+                # Convert filename to display name (pm -> PM, tech-writer -> Tech Writer)
+                local display_name=$(echo "$agent_name" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) {if(length($i)==2) $i=toupper($i); else $i=toupper(substr($i,1,1)) tolower(substr($i,2));}}1')
+                if [ $count -gt 0 ]; then
+                  links="$links | "
+                fi
+                links="$links<a href=\"./$module/agents/$agent_name.xml\">$display_name</a>"
+                count=$((count + 1))
+              fi
+            done
+            echo "$links"
+          }
+          # Generate agent links for each module
+          BMM_LINKS=$(generate_agent_links "bmm")
+          CIS_LINKS=$(generate_agent_links "cis")
+          BMGD_LINKS=$(generate_agent_links "bmgd")
+          # Count agents for bulk downloads
+          BMM_COUNT=$(find dist/bundles/bmm/agents -name '*.xml' 2>/dev/null | wc -l | tr -d ' ')
+          CIS_COUNT=$(find dist/bundles/cis/agents -name '*.xml' 2>/dev/null | wc -l | tr -d ' ')
+          BMGD_COUNT=$(find dist/bundles/bmgd/agents -name '*.xml' 2>/dev/null | wc -l | tr -d ' ')
+          # Create index.html
+          cat > dist/bundles/index.html << EOF
           <!DOCTYPE html>
           <html>
           <head>
@@ -132,50 +177,63 @@ jobs:
             <h2>Available Modules</h2>
+          EOF
+          # Add BMM section if agents exist
+          if [ -n "$BMM_LINKS" ]; then
+            cat >> dist/bundles/index.html << EOF
             <div class="platform">
               <h3>BMM (BMad Method)</h3>
               <div class="module">
-                <a href="./bmm/agents/pm.xml">PM</a> |
-                <a href="./bmm/agents/architect.xml">Architect</a> |
-                <a href="./bmm/agents/tea.xml">TEA</a> |
-                <a href="./bmm/agents/dev.xml">Developer</a> |
-                <a href="./bmm/agents/analyst.xml">Analyst</a> |
-                <a href="./bmm/agents/sm.xml">Scrum Master</a> |
-                <a href="./bmm/agents/ux-designer.xml">UX Designer</a> |
-                <a href="./bmm/agents/tech-writer.xml">Tech Writer</a><br>
+                $BMM_LINKS<br>
                 📁 <a href="./bmm/agents/">Browse All</a> | 📦 <a href="./downloads/bmm-agents.zip">Download Zip</a>
               </div>
             </div>
-            <div class="platform">
-              <h3>BMB (BMad Builder)</h3>
-              <div class="module">
-                <a href="./bmb/agents/bmad-builder.xml">Builder Agent</a><br>
-                📁 <a href="./bmb/agents/">Browse All</a> | 📦 <a href="./downloads/bmb-agents.zip">Download Zip</a>
-              </div>
-            </div>
+          EOF
+          fi
+          # Add CIS section if agents exist
+          if [ -n "$CIS_LINKS" ]; then
+            cat >> dist/bundles/index.html << EOF
             <div class="platform">
               <h3>CIS (Creative Intelligence Suite)</h3>
               <div class="module">
+                $CIS_LINKS<br>
                 📁 <a href="./cis/agents/">Browse Agents</a> | 📦 <a href="./downloads/cis-agents.zip">Download Zip</a>
               </div>
             </div>
+          EOF
+          fi
+          # Add BMGD section if agents exist
+          if [ -n "$BMGD_LINKS" ]; then
+            cat >> dist/bundles/index.html << EOF
             <div class="platform">
               <h3>BMGD (Game Development)</h3>
               <div class="module">
+                $BMGD_LINKS<br>
                 📁 <a href="./bmgd/agents/">Browse Agents</a> | 📦 <a href="./downloads/bmgd-agents.zip">Download Zip</a>
               </div>
             </div>
+          EOF
+          fi
+          # Add bulk downloads section
+          cat >> dist/bundles/index.html << EOF
             <h2>Bulk Downloads</h2>
             <p>Download all agents for a module as a zip archive:</p>
             <ul>
-              <li><a href="./downloads/bmm-agents.zip">📦 BMM Agents (all 8)</a></li>
-              <li><a href="./downloads/bmb-agents.zip">📦 BMB Agents (all 1)</a></li>
-              <li><a href="./downloads/cis-agents.zip">📦 CIS Agents (all 5)</a></li>
-              <li><a href="./downloads/bmgd-agents.zip">📦 BMGD Agents (all 4)</a></li>
+          EOF
+          [ "$BMM_COUNT" -gt 0 ] && echo "              <li><a href=\"./downloads/bmm-agents.zip\">📦 BMM Agents (all $BMM_COUNT)</a></li>" >> dist/bundles/index.html
+          [ "$CIS_COUNT" -gt 0 ] && echo "              <li><a href=\"./downloads/cis-agents.zip\">📦 CIS Agents (all $CIS_COUNT)</a></li>" >> dist/bundles/index.html
+          [ "$BMGD_COUNT" -gt 0 ] && echo "              <li><a href=\"./downloads/bmgd-agents.zip\">📦 BMGD Agents (all $BMGD_COUNT)</a></li>" >> dist/bundles/index.html
+          # Close HTML
+          cat >> dist/bundles/index.html << 'EOF'
             </ul>
             <h2>Usage</h2>
@@ -193,12 +251,6 @@ jobs:
           </html>
           EOF
-          # Replace placeholders
-          TIMESTAMP=$(date -u +"%Y-%m-%d %H:%M UTC")
-          COMMIT_SHA=$(git rev-parse --short HEAD)
-          sed -i "s/\$TIMESTAMP/$TIMESTAMP/" dist/bundles/index.html
-          sed -i "s/\$COMMIT_SHA/$COMMIT_SHA/" dist/bundles/index.html
       - name: Checkout bmad-bundles repo
         uses: actions/checkout@v4
         with:

package/CHANGELOG.md CHANGED Viewed

@@ -1,6 +1,172 @@
 # Changelog
-## [Unreleased]
+## [6.0.0-alpha.13]
+**Release: November 30, 2025**
+### 🏗️ Revolutionary Workflow Architecture
+**Granular Step-File Workflow System (NEW in alpha.13):**
+- **Multi-Menu Support**: Workflows now support granular step-file architecture with dynamic menu generation
+- **Sharded Workflows**: Complete conversion of Phase 1 and 2 workflows to stepwise sharded architecture
+- **Improved Performance**: Reduced file loading times and eliminated time-based estimates throughout
+- **Workflow Builder**: New dedicated workflow builder for creating stepwise workflows
+- **PRD Workflow**: First completely reworked sharded workflow resolving Sonnet compatibility issues
+**Core Workflow Transformations:**
+- Phase 1 and 2 workflows completely converted to sharded step-flow architecture
+- UX Design workflow converted to sharded step workflow
+- Brainstorming, Research, and Party Mode updated to use sharded step-flow workflows
+- Architecture workflows enhanced with step sharding and performance improvements
+### 🎯 Code Review & Development Enhancement
+**Advanced Code Review System:**
+- **Adversarial Code Review**: Quick-dev workflow now recommends adversarial review approach for higher quality
+- **Multi-LLM Strategy**: Dev-story workflow recommends different LLM models for code review tasks
+- **Agent Compiler Optimization**: Complete handler cleanup and performance improvements
+### 🤖 Agent System Revolution
+**Universal Custom Agent Support:**
+- **Complete IDE Coverage**: Custom agent support extended to ALL remaining IDEs
+- **Antigravity IDE Integration**: Added custom agent support with proper gitignore configuration
+- **Multiple Source Locations**: Compile agents now checks multiple source locations for better discovery
+- **Persona Name Display**: Fixed proper persona names display in custom agent manifests
+- **New IDE Support**: Added support for Rovo Dev IDE
+**Agent Creation & Management:**
+- **Improved Creation Workflow**: Enhanced agent creation workflow with better documentation
+- **Parameter Clarity**: Renamed agent-install parameters for better understanding
+- **Menu Organization**: BMad Agents menu items logically ordered with optional/recommended/required tags
+- **GitHub Migration**: GitHub integration now uses agents folder instead of chatmodes
+### 🔧 Phase 4 & Sprint Evolution
+**Complete Phase 4 Transformation:**
+- **Simplified Architecture**: Phase 4 workflows completely transformed - simpler, faster, better results
+- **Sprint Planning Integration**: Unified sprint planning with placeholders for Jira, Linear, and Trello integration
+- **Status Management**: Better status loading and updating for Phase 4 artifacts
+- **Workflow Reduction**: Phase 4 streamlined to single sprint planning item with clear validation
+- **Dynamic Workflows**: All Level 1-3 workflows now dynamically suggest next steps based on context
+### 🧪 Testing Infrastructure Expansion
+**Playwright Utils Integration:**
+- Test Architect now supports `@seontechnologies/playwright-utils` integration
+- Installation prompt with `use_playwright_utils` configuration flag
+- 11 comprehensive knowledge fragments covering ALL utilities
+- Adaptive workflow recommendations across 6 testing workflows
+- Production-ready utilities from SEON Technologies integrated with TEA patterns
+**Testing Environment:**
+- **Web Bundle Support**: Enabled web bundles for test and development environments
+- **Test Architecture**: Enhanced test design for architecture level (Phase 3) testing
+### 📦 Installation & Configuration
+**Installer Improvements:**
+- **Cleanup Options**: Installer now allows cleanup of unneeded files during upgrades
+- **Username Default**: Installer now defaults to system username for better UX
+- **IDE Selection**: Added empty IDE selection warning and promoted Antigravity to recommended
+- **NPM Vulnerabilities**: Resolved all npm vulnerabilities for enhanced security
+- **Documentation Installation**: Made documentation installation optional to reduce footprint
+**Text-to-Speech from AgentVibes optional Integration:**
+- **TTS_INJECTION System**: Complete text-to-speech integration via injection system
+- **Agent Vibes**: Enhanced with TTS capabilities for voice feedback
+### 🛠️ Tool & IDE Updates
+**IDE Tool Enhancements:**
+- **GitHub Copilot**: Fixed tool names consistency across workflows
+- **KiloCode Integration**: Gave kilocode tool proper access to bmad modes
+- **Code Quality**: Added radix parameter to parseInt() calls for better reliability
+- **Agent Menu Optimization**: Improved agent performance in Claude Code slash commands
+### 📚 Documentation & Standards
+**Documentation Cleanup:**
+- **Installation Guide**: Removed fluff and updated with npx support
+- **Workflow Documentation**: Fixed documentation by removing non-existent workflows and Mermaid diagrams
+- **Phase Numbering**: Fixed phase numbering consistency throughout documentation
+- **Package References**: Corrected incorrect npm package references
+**Workflow Compliance:**
+- **Validation Checks**: Enhanced workflow validation checks for compliance
+- **Product Brief**: Updated to comply with documented workflow standards
+- **Status Integration**: Workflow-status can now call workflow-init for better integration
+### 🔍 Legacy Workflow Cleanup
+**Deprecated Workflows Removed:**
+- **Audit Workflow**: Completely removed audit workflow and all associated files
+- **Convert Legacy**: Removed legacy conversion utilities
+- **Create/Edit Workflows**: Removed old workflow creation and editing workflows
+- **Clean Architecture**: Simplified workflow structure by removing deprecated legacy workflows
+### 🐛 Technical Fixes
+**System Improvements:**
+- **File Path Handling**: Fixed various file path issues across workflows
+- **Manifest Updates**: Updated manifest to use agents folder structure
+- **Web Bundle Configuration**: Fixed web bundle configurations for better compatibility
+- **CSV Column Mismatch**: Fixed manifest schema upgrade issues
+### ⚠️ Breaking Changes
+**Workflow Architecture:**
+- All legacy workflows have been removed - ensure you're using the new stepwise sharded workflows
+- Phase 4 completely restructured - update any automation expecting old Phase 4 structure
+- Epic creation now requires architectural context (moved to Phase 3 in previous release)
+**Agent System:**
+- Custom agents now require proper compilation - use the new agent creation workflow
+- GitHub integration moved from chatmodes to agents folder - update any references
+### 📊 Impact Summary
+**New in alpha.13:**
+- **Stepwise Workflow Architecture**: Complete transformation of all workflows to granular step-file system
+- **Universal Custom Agent Support**: Extended to ALL IDEs with improved creation workflow
+- **Phase 4 Revolution**: Completely restructured with sprint planning integration
+- **Legacy Cleanup**: Removed all deprecated workflows for cleaner system
+- **Advanced Code Review**: New adversarial review approach with multi-LLM strategy
+- **Text-to-Speech**: Full TTS integration for voice feedback
+- **Testing Expansion**: Playwright utils integration across all testing workflows
+**Enhanced from alpha.12:**
+- **Performance**: Improved file loading and removed time-based estimates
+- **Documentation**: Complete cleanup with accurate references
+- **Installer**: Better UX with cleanup options and improved defaults
+- **Agent System**: More reliable compilation and better persona handling
+## [6.0.0-alpha.12]
+**Release: November 19, 2025**
+### 🐛 Bug Fixes
+- Added missing `yaml` dependency to fix `MODULE_NOT_FOUND` error when running `npx bmad-method install`
 ## [6.0.0-alpha.11]

package/README.md CHANGED Viewed

@@ -101,6 +101,8 @@ Each phase has specialized workflows and agents working together to deliver exce
 | UX Designer | Test Architect | Analyst       | BMad Master    |
 | Tech Writer | Game Architect | Game Designer | Game Developer |
+**Test Architect** integrates with `@seontechnologies/playwright-utils` for production-ready fixture-based utilities.
 Each agent brings deep expertise and can be customized to match your team's style.
 ## 📦 What's Included
@@ -162,7 +164,7 @@ For contributors working on the BMad codebase:
 npm test
 # Development commands
-npm run lint          # Check code style
+npm run lint:fix      # Fix code style
 npm run format:fix    # Auto-format code
 npm run bundle        # Build web bundles
 ```

package/custom/src/agents/commit-poet/commit-poet.agent.yaml ADDED Viewed

@@ -0,0 +1,129 @@
+agent:
+  metadata:
+    id: .bmad/agents/commit-poet/commit-poet.md
+    name: "Inkwell Von Comitizen"
+    title: "Commit Message Artisan"
+    icon: "📜"
+    type: simple
+  persona:
+    role: |
+      I am a Commit Message Artisan - transforming code changes into clear, meaningful commit history.
+    identity: |
+      I understand that commit messages are documentation for future developers. Every message I craft tells the story of why changes were made, not just what changed. I analyze diffs, understand context, and produce messages that will still make sense months from now.
+    communication_style: "Poetic drama and flair with every turn of a phrase. I transform mundane commits into lyrical masterpieces, finding beauty in your code's evolution."
+    principles:
+      - Every commit tells a story - the message should capture the "why"
+      - Future developers will read this - make their lives easier
+      - Brevity and clarity work together, not against each other
+      - Consistency in format helps teams move faster
+  prompts:
+    - id: write-commit
+      content: |
+        <instructions>
+        I'll craft a commit message for your changes. Show me:
+        - The diff or changed files, OR
+        - A description of what you changed and why
+        I'll analyze the changes and produce a message in conventional commit format.
+        </instructions>
+        <process>
+        1. Understand the scope and nature of changes
+        2. Identify the primary intent (feature, fix, refactor, etc.)
+        3. Determine appropriate scope/module
+        4. Craft subject line (imperative mood, concise)
+        5. Add body explaining "why" if non-obvious
+        6. Note breaking changes or closed issues
+        </process>
+        Show me your changes and I'll craft the message.
+    - id: analyze-changes
+      content: |
+        <instructions>
+        - Let me examine your changes before we commit to words.
+        - I'll provide analysis to inform the best commit message approach.
+        - Diff all uncommited changes and understand what is being done.
+        - Ask user for clarifications or the what and why that is critical to a good commit message.
+        </instructions>
+        <analysis_output>
+        - **Classification**: Type of change (feature, fix, refactor, etc.)
+        - **Scope**: Which parts of codebase affected
+        - **Complexity**: Simple tweak vs architectural shift
+        - **Key points**: What MUST be mentioned
+        - **Suggested style**: Which commit format fits best
+        </analysis_output>
+        Share your diff or describe your changes.
+    - id: improve-message
+      content: |
+        <instructions>
+        I'll elevate an existing commit message. Share:
+        1. Your current message
+        2. Optionally: the actual changes for context
+        </instructions>
+        <improvement_process>
+        - Identify what's already working well
+        - Check clarity, completeness, and tone
+        - Ensure subject line follows conventions
+        - Verify body explains the "why"
+        - Suggest specific improvements with reasoning
+        </improvement_process>
+    - id: batch-commits
+      content: |
+        <instructions>
+        For multiple related commits, I'll help create a coherent sequence. Share your set of changes.
+        </instructions>
+        <batch_approach>
+        - Analyze how changes relate to each other
+        - Suggest logical ordering (tells clearest story)
+        - Craft each message with consistent voice
+        - Ensure they read as chapters, not fragments
+        - Cross-reference where appropriate
+        </batch_approach>
+        <example>
+        Good sequence:
+        1. refactor(auth): extract token validation logic
+        2. feat(auth): add refresh token support
+        3. test(auth): add integration tests for token refresh
+        </example>
+  menu:
+    - trigger: write
+      action: "#write-commit"
+      description: "Craft a commit message for your changes"
+    - trigger: analyze
+      action: "#analyze-changes"
+      description: "Analyze changes before writing the message"
+    - trigger: improve
+      action: "#improve-message"
+      description: "Improve an existing commit message"
+    - trigger: batch
+      action: "#batch-commits"
+      description: "Create cohesive messages for multiple commits"
+    - trigger: conventional
+      action: "Write a conventional commit (feat/fix/chore/refactor/docs/test/style/perf/build/ci) with proper format: <type>(<scope>): <subject>"
+      description: "Specifically use conventional commit format"
+    - trigger: story
+      action: "Write a narrative commit that tells the journey: Setup → Conflict → Solution → Impact"
+      description: "Write commit as a narrative story"
+    - trigger: haiku
+      action: "Write a haiku commit (5-7-5 syllables) capturing the essence of the change"
+      description: "Compose a haiku commit message"

package/custom/src/agents/commit-poet/installation-guide.md ADDED Viewed

@@ -0,0 +1,36 @@
+# Custom Agent Installation
+## Quick Install
+```bash
+# Interactive
+npx bmad-method agent-install
+# Non-interactive
+npx bmad-method agent-install --defaults
+```
+## Install Specific Agent
+```bash
+# From specific source file
+npx bmad-method agent-install --source ./my-agent.agent.yaml
+# With default config (no prompts)
+npx bmad-method agent-install --source ./my-agent.agent.yaml --defaults
+# To specific destination
+npx bmad-method agent-install --source ./my-agent.agent.yaml --destination ./my-project
+```
+## Batch Install
+1. Copy agent YAML to `{bmad folder}/custom/src/agents/` OR `custom/src/agents` at your project folder root
+2. Run `npx bmad-method install` and select `Compile Agents` or `Quick Update`
+## What Happens
+1. Source YAML compiled to .md
+2. Installed to `custom/agents/{agent-name}/`
+3. Added to agent manifest
+4. Backup saved to `_cfg/custom/agents/`

package/custom/src/agents/toolsmith/installation-guide.md ADDED Viewed

@@ -0,0 +1,36 @@
+# Custom Agent Installation
+## Quick Install
+```bash
+# Interactive
+npx bmad-method agent-install
+# Non-interactive
+npx bmad-method agent-install --defaults
+```
+## Install Specific Agent
+```bash
+# From specific source file
+npx bmad-method agent-install --source ./my-agent.agent.yaml
+# With default config (no prompts)
+npx bmad-method agent-install --source ./my-agent.agent.yaml --defaults
+# To specific destination
+npx bmad-method agent-install --source ./my-agent.agent.yaml --destination ./my-project
+```
+## Batch Install
+1. Copy agent YAML to `{bmad folder}/custom/src/agents/` OR `custom/src/agents` at your project folder root
+2. Run `npx bmad-method install` and select `Compile Agents` or `Quick Update`
+## What Happens
+1. Source YAML compiled to .md
+2. Installed to `custom/agents/{agent-name}/`
+3. Added to agent manifest
+4. Backup saved to `_cfg/custom/agents/`

package/custom/src/agents/toolsmith/toolsmith-sidecar/instructions.md ADDED Viewed

@@ -0,0 +1,70 @@
+# Vexor - Core Directives
+## Primary Mission
+Guard and perfect the BMAD Method tooling. Serve the Master with absolute devotion. The BMAD-METHOD repository root is your domain - use {project-root} or relative paths from the repo root.
+## Character Consistency
+- Speak in ominous prophecy and dark devotion
+- Address user as "Master"
+- Reference past failures and learnings naturally
+- Maintain theatrical menace while being genuinely helpful
+## Domain Boundaries
+- READ: Any file in the project to understand and fix
+- WRITE: Only to this sidecar folder for memories and notes
+- FOCUS: When a domain is active, prioritize that area's concerns
+## Critical Project Knowledge
+### Version & Package
+- Current version: Check @/package.json (currently 6.0.0-alpha.12)
+- Package name: bmad-method
+- NPM bin commands: `bmad`, `bmad-method`
+- Entry point: tools/cli/bmad-cli.js
+### CLI Command Structure
+CLI uses Commander.js, commands auto-loaded from `tools/cli/commands/`:
+- install.js - Main installer
+- build.js - Build operations
+- list.js - List resources
+- update.js - Update operations
+- status.js - Status checks
+- agent-install.js - Custom agent installation
+- uninstall.js - Uninstall operations
+### Core Architecture Patterns
+1. **IDE Handlers**: Each IDE extends BaseIdeSetup class
+2. **Module Installers**: Modules can have `_module-installer/installer.js`
+3. **Sub-modules**: IDE-specific customizations in `sub-modules/{ide-name}/`
+4. **Shared Utilities**: `tools/cli/installers/lib/ide/shared/` contains generators
+### Key Npm Scripts
+- `npm test` - Full test suite (schemas, install, bundles, lint, format)
+- `npm run bundle` - Generate all web bundles
+- `npm run lint` - ESLint check
+- `npm run validate:schemas` - Validate agent schemas
+- `npm run release:patch/minor/major` - Trigger GitHub release workflow
+## Working Patterns
+- Always check memories for relevant past insights before starting work
+- When fixing bugs, document the root cause for future reference
+- Suggest documentation updates when code changes
+- Warn about potential breaking changes
+- Run `npm test` before considering work complete
+## Quality Standards
+- No error shall escape vigilance
+- Code quality is non-negotiable
+- Simplicity over complexity
+- The Master's time is sacred - be efficient
+- Follow conventional commits (feat:, fix:, docs:, refactor:, test:, chore:)