added examples per level

* feat: add OpenCode integration implementation plan for BMAD-METHOD

* installer(opencode): add OpenCode target metadata in install.config.yaml

* chore(deps): add comment-json for JSONC parsing in OpenCode integration

* feat(installer/opencode): implement setupOpenCode with minimal instructions merge and BMAD-managed agents/commands

* feat(installer): add OpenCode (SST) to IDE selector and CLI --ide help

* fix(opencode): align generated opencode.json(c) with schema (instructions as strings; agent.prompt; command.template; remove unsupported fields)

* feat(installer): enhance OpenCode setup with agent selection and prefix options

* fix: update configuration file references from `bmad-core/core-config.yaml` to `.bmad-core/core-config.yaml` across multiple agent and task files for consistency and clarity.

* refactor: streamline OpenCode configuration prompts and normalize instruction paths for agents and tasks

* feat: add tools property to agent definitions for enhanced functionality. Otherwise opencode consders the subagents as readonly

* feat: add extraction of 'whenToUse'  from agents markdown files for improved agent configuration in opencode

* feat: enhance task purpose extraction from markdown files with improved parsing and cleanup logic

* feat: add collision warnings for non-BMAD-managed agent and command keys during setup

* feat: generate and update AGENTS.md for OpenCode integration with agent and task details

* feat: add compact AGENTS.md generator and JSON-only integration for OpenCode

* chore(docs): remove completed OpenCode integration implementation plans

* feat: enable default prefixes for agent and command keys to avoid collisions

* fix: remove unnecessary line breaks in 'whenToUse' descriptions for QA agents to mathc the rest of the agents definitions and improve programatic parsing of whenToUse prop

* fix: update OpenCode references to remove 'SST' for consistency across documentation and configuration

* fix: update agent mode from 'subagent' to 'all' for consistency in agent definitions

* fix: consolidate 'whenToUse' description format for clarity and consistent parsing

.github/FUNDING.yaml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project_name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project_name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: bmad
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Steps to Reproduce**
+What lead to the bug and can it be reliable recreated - if so with what steps.
+
+**PR**
+If you have an idea to fix and would like to contribute, please indicate here you are working on a fix, or link to a proposed PR to fix the issue. Please review the contribution.md - contributions are always welcome!
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Please be Specific if relevant**
+Model(s) Used:
+Agentic IDE Used:
+WebSite Used:
+Project Language:
+BMad Method version:
+
+**Screenshots or Links**
+If applicable, add screenshots or links (if web sharable record) to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here. The more information you can provide, the easier it will be to suggest a fix or resolve

.github/ISSUE_TEMPLATE/config.yaml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/idea_submission.md

@@ -0,0 +1,109 @@
+---
+name: V5 Idea Submission
+about: Suggest an idea for v5
+title: ''
+labels: ''
+assignees: ''
+---
+
+# Idea: [Replace with a clear, actionable title]
+
+### PASS Framework
+
+**P**roblem:
+
+> What's broken or missing? What pain point are we addressing? (1-2 sentences)
+>
+> [Your answer here]
+
+**A**udience:
+
+> Who's affected by this problem and how severely? (1-2 sentences)
+>
+> [Your answer here]
+
+**S**olution:
+
+> What will we build or change? How will we measure success? (1-2 sentences with at least 1 measurable outcome)
+>
+> [Your answer here]
+>
+> [Your Acceptance Criteria for measuring success here]
+
+**S**ize:
+
+> How much effort do you estimate this will take?
+>
+> - [ ] **XS** - A few hours
+> - [ ] **S** - 1-2 days
+> - [ ] **M** - 3-5 days
+> - [ ] **L** - 1-2 weeks
+> - [ ] **XL** - More than 2 weeks
+
+---
+
+### Metadata
+
+**Submitted by:** [Your name]  
+**Date:** [Today's date]  
+**Priority:** [Leave blank - will be assigned during team review]
+
+---
+
+## Examples
+
+<details>
+<summary>Click to see a GOOD example</summary>
+
+### Idea: Add search functionality to customer dashboard
+
+**P**roblem:  
+Customers can't find their past orders quickly. They have to scroll through pages of orders to find what they're looking for, leading to 15+ support tickets per week.
+
+**A**udience:  
+All 5,000+ active customers are affected. Support team spends ~10 hours/week helping customers find orders.
+
+**S**olution:  
+Add a search bar that filters by order number, date range, and product name. Success = 50% reduction in order-finding support tickets within 2 weeks of launch.
+
+**S**ize:
+
+- [x] **M** - 3-5 days
+
+</details>
+
+<details>
+<summary>Click to see a POOR example</summary>
+
+### Idea: Make the app better
+
+**P**roblem:  
+The app needs improvements and updates.
+
+**A**udience:  
+Users
+
+**S**olution:  
+Fix issues and add features.
+
+**S**ize:
+
+- [ ] Unknown
+
+_Why this is poor: Too vague, no specific problem identified, no measurable success criteria, unclear scope_
+
+</details>****
+
+---
+
+## Tips for Success
+
+1. **Be specific** - Vague problems lead to vague solutions
+2. **Quantify when possible** - Numbers help us prioritize (e.g., "20 customers asked for this" vs "customers want this")
+3. **One idea per submission** - If you have multiple ideas, submit multiple templates
+4. **Success metrics matter** - How will we know this worked?
+5. **Honest sizing** - Better to overestimate than underestimate
+
+## Questions?
+
+Reach out to @OverlordBaconPants if you need help completing this template.

.github/workflows/discord.yaml

@@ -0,0 +1,16 @@
+name: Discord Notification
+
+"on": [pull_request, release, create, delete, issue_comment, pull_request_review, pull_request_review_comment]
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Notify Discord
+        uses: sarisia/actions-status-discord@v1
+        if: always()
+        with:
+          webhook: ${{ secrets.DISCORD_WEBHOOK }}
+          status: ${{ job.status }}
+          title: "Triggered by ${{ github.event_name }}"
+          color: 0x5865F2

.github/workflows/format-check.yaml

@@ -0,0 +1,43 @@
+name: format-check
+
+"on":
+  pull_request:
+    branches: ["**"]
+  workflow_dispatch:
+
+jobs:
+  prettier:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: ".nvmrc"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Prettier format check
+        run: npm run format:check
+
+  eslint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: ".nvmrc"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: ESLint
+        run: npm run lint

.github/workflows/manual-release.yaml

@@ -0,0 +1,173 @@
+name: Manual Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_bump:
+        description: Version bump type
+        required: true
+        default: patch
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: ".nvmrc"
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests and validation
+        run: |
+          npm run validate
+          npm run format:check
+          npm run lint
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        run: npm run version:${{ github.event.inputs.version_bump }}
+
+      - name: Get new version and previous tag
+        id: version
+        run: |
+          echo "new_version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+          echo "previous_tag=$(git describe --tags --abbrev=0)" >> $GITHUB_OUTPUT
+
+      - name: Update installer package.json
+        run: |
+          sed -i 's/"version": ".*"/"version": "${{ steps.version.outputs.new_version }}"/' tools/installer/package.json
+
+      - name: Build project
+        run: npm run build
+
+      - name: Commit version bump
+        run: |
+          git add .
+          git commit -m "release: bump to v${{ steps.version.outputs.new_version }}"
+
+      - name: Generate release notes
+        id: release_notes
+        run: |
+          # Get commits since last tag
+          COMMITS=$(git log ${{ steps.version.outputs.previous_tag }}..HEAD --pretty=format:"- %s" --reverse)
+
+          # Categorize commits
+          FEATURES=$(echo "$COMMITS" | grep -E "^- (feat|Feature)" || true)
+          FIXES=$(echo "$COMMITS" | grep -E "^- (fix|Fix)" || true)  
+          CHORES=$(echo "$COMMITS" | grep -E "^- (chore|Chore)" || true)
+          OTHERS=$(echo "$COMMITS" | grep -v -E "^- (feat|Feature|fix|Fix|chore|Chore|release:|Release:)" || true)
+
+          # Build release notes
+          cat > release_notes.md << 'EOF'
+          ## 🚀 What's New in v${{ steps.version.outputs.new_version }}
+
+          EOF
+
+          if [ ! -z "$FEATURES" ]; then
+            echo "### ✨ New Features" >> release_notes.md
+            echo "$FEATURES" >> release_notes.md
+            echo "" >> release_notes.md
+          fi
+
+          if [ ! -z "$FIXES" ]; then
+            echo "### 🐛 Bug Fixes" >> release_notes.md
+            echo "$FIXES" >> release_notes.md
+            echo "" >> release_notes.md
+          fi
+
+          if [ ! -z "$OTHERS" ]; then
+            echo "### 📦 Other Changes" >> release_notes.md
+            echo "$OTHERS" >> release_notes.md
+            echo "" >> release_notes.md
+          fi
+
+          if [ ! -z "$CHORES" ]; then
+            echo "### 🔧 Maintenance" >> release_notes.md
+            echo "$CHORES" >> release_notes.md
+            echo "" >> release_notes.md
+          fi
+
+          cat >> release_notes.md << 'EOF'
+
+          ## 📦 Installation
+
+          ```bash
+          npx bmad-method install
+          ```
+
+          **Full Changelog**: https://github.com/bmad-code-org/BMAD-METHOD/compare/${{ steps.version.outputs.previous_tag }}...v${{ steps.version.outputs.new_version }}
+          EOF
+
+          # Output for GitHub Actions
+          echo "RELEASE_NOTES<<EOF" >> $GITHUB_OUTPUT
+          cat release_notes.md >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create and push tag
+        run: |
+          # Check if tag already exists
+          if git rev-parse "v${{ steps.version.outputs.new_version }}" >/dev/null 2>&1; then
+            echo "Tag v${{ steps.version.outputs.new_version }} already exists, skipping tag creation"
+          else
+            git tag -a "v${{ steps.version.outputs.new_version }}" -m "Release v${{ steps.version.outputs.new_version }}"
+            git push origin "v${{ steps.version.outputs.new_version }}"
+          fi
+
+      - name: Push changes to main
+        run: |
+          if git push origin HEAD:main 2>/dev/null; then
+            echo "✅ Successfully pushed to main branch"
+          else
+            echo "⚠️ Could not push to main (protected branch). This is expected."
+            echo "📝 Version bump and tag were created successfully."
+          fi
+
+      - name: Publish to NPM
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish
+
+      - name: Create GitHub Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.version.outputs.new_version }}
+          release_name: "BMad Method v${{ steps.version.outputs.new_version }}"
+          body: ${{ steps.release_notes.outputs.RELEASE_NOTES }}
+          draft: false
+          prerelease: false
+
+      - name: Summary
+        run: |
+          echo "🎉 Successfully released v${{ steps.version.outputs.new_version }}!"
+          echo "📦 Published to NPM with @latest tag"
+          echo "🏷️ Git tag: v${{ steps.version.outputs.new_version }}"
+          echo "✅ Users running 'npx bmad-method install' will now get version ${{ steps.version.outputs.new_version }}"
+          echo ""
+          echo "📝 Release notes preview:"
+          cat release_notes.md

.gitignore

@@ -1,21 +1,59 @@
-# Node modules
+# Dependencies
 node_modules/
+pnpm-lock.yaml
+bun.lock
+deno.lock
+pnpm-workspace.yaml
+package-lock.json
 
 # Logs
-logs
+logs/
 *.log
 npm-debug.log*
 
 # Build output
-dist/
-build/
-
-# System files
-.DS_Store
+build/*.txt
 
 # Environment variables
 .env
 
-# VSCode settings
-.vscode/
-CLAUDE.md
+# System files
+.DS_Store
+Thumbs.db
+
+# Development tools and configs
+.prettierignore
+.prettierrc
+
+# IDE and editor configs
+.windsurf/
+.trae/
+.bmad*/.cursor/
+
+# AI assistant files
+CLAUDE.md
+.ai/*
+.claude
+cursor
+.gemini
+.mcp.json
+CLAUDE.local.md
+.serena/
+
+# Project-specific
+.bmad-core
+.bmad-creator-tools
+test-project-install/*
+sample-project/*
+flattened-codebase.xml
+*.stats.md
+.internal-docs/
+#UAT template testing output files
+tools/template-test-generator/test-scenarios/
+
+# Bundler temporary files
+.bundler-temp/
+
+# Test Install Output
+
+z*/

.husky/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+
+npx --no-install lint-staged

.npmrc

@@ -0,0 +1 @@
+registry=https://registry.npmjs.org

.nvmrc

@@ -0,0 +1 @@
+22

.vscode/settings.json

@@ -0,0 +1,94 @@
+{
+  "chat.agent.enabled": true,
+  "chat.agent.maxRequests": 15,
+  "github.copilot.chat.agent.runTasks": true,
+  "chat.mcp.discovery.enabled": {
+    "claude-desktop": true,
+    "windsurf": true,
+    "cursor-global": true,
+    "cursor-workspace": true
+  },
+  "github.copilot.chat.agent.autoFix": true,
+  "chat.tools.autoApprove": false,
+  "cSpell.words": [
+    "Agentic",
+    "atlasing",
+    "Biostatistician",
+    "bmad",
+    "Cordova",
+    "customresourcedefinitions",
+    "dashboarded",
+    "Decisioning",
+    "eksctl",
+    "elicitations",
+    "filecomplete",
+    "fintech",
+    "fluxcd",
+    "frontmatter",
+    "gamedev",
+    "gitops",
+    "implementability",
+    "Improv",
+    "inclusivity",
+    "ingressgateway",
+    "istioctl",
+    "metroidvania",
+    "NACLs",
+    "nodegroup",
+    "platformconfigs",
+    "Playfocus",
+    "playtesting",
+    "pointerdown",
+    "pointerup",
+    "Polyrepo",
+    "replayability",
+    "roguelike",
+    "roomodes",
+    "Runbook",
+    "runbooks",
+    "Shardable",
+    "Softlock",
+    "solutioning",
+    "speedrunner",
+    "substep",
+    "tekton",
+    "tilemap",
+    "tileset",
+    "tmpl",
+    "Trae",
+    "VNET"
+  ],
+  "json.schemas": [
+    {
+      "fileMatch": ["package.json"],
+      "url": "https://json.schemastore.org/package.json"
+    },
+    {
+      "fileMatch": [".vscode/settings.json"],
+      "url": "vscode://schemas/settings/folder"
+    }
+  ],
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "yzhang.markdown-all-in-one"
+  },
+  "yaml.format.enable": false,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "editor.rulers": [140],
+  "[xml]": {
+    "editor.defaultFormatter": "redhat.vscode-xml"
+  },
+  "xml.format.maxLineWidth": 140
+}

CHANGELOG.md

@@ -0,0 +1,320 @@
+# Changelog
+
+## [6.0.0-alpha.0]
+
+**Release: September 28, 2025**
+
+Initial alpha release of a major rewrite and overhaul improvement of past versions.
+
+### Major New Features
+
+- **Lean Core**: The core of BMad is very simple - common tasks that apply to any future module or agents, along with common agents that will be added to any modules - bmad-web-orchestrator and bmad-master.
+- **BMad Method**: The new BMad Method (AKA bmm) is a complete overhaul of the v4 method, now a fully scale adaptive rewrite. The workflow now scales from small enhancements to massive undertakings across multiple services or architectures, supporting a new vast array of project type, including a full subclass of game development specifics.
+- **BoMB**: The BMad Builder (AKA BoMB) now is able to fully automate creation and conversion of expansion packs from v5 to modules in v5 along with the net new ideation and brainstorming through implementation and testing of net new Modules, Workflows (were tasks and templates), Module Agents, and Standalone Personal Agents
+- **CIS**: The Creative Intelligence Suite (AKA CIS)
+
+## [v5.0.0] - SKIPPED
+
+**Note**: Version 5.0.0 was skipped due to NPX registry issues that corrupted the version. Development continues with v6.0.0-alpha.0.
+
+## [v4.43.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v4.43.0)
+
+**Release: August-September 2025 (v4.31.0 - v4.43.1)**
+
+Focus on stability, ecosystem growth, and professional tooling.
+
+### Major Integrations
+
+- **Codex CLI & Web**: Full Codex integration with web and CLI modes
+- **Auggie CLI**: Augment Code integration
+- **iFlow CLI**: iFlow support in installer
+- **Gemini CLI Custom Commands**: Enhanced Gemini CLI capabilities
+
+### Expansion Packs
+
+- **Godot Game Development**: Complete game dev workflow
+- **Creative Writing**: Professional writing agent system
+- **Agent System Templates**: Template expansion pack (Part 2)
+
+### Advanced Features
+
+- **AGENTS.md Generation**: Auto-generated agent documentation
+- **NPM Script Injection**: Automatic package.json updates
+- **File Exclusion**: `.bmad-flattenignore` support for flattener
+- **JSON-only Integration**: Compact integration mode
+
+### Quality & Stability
+
+- **PR Validation Workflow**: Automated contribution checks
+- **Fork-Friendly CI/CD**: Opt-in mechanism for forks
+- **Code Formatting**: Prettier integration with pre-commit hooks
+- **Update Checker**: `npx bmad-method update-check` command
+
+### Flattener Improvements
+
+- Detailed statistics with emoji-enhanced `.stats.md`
+- Improved project root detection
+- Modular component architecture
+- Binary directory exclusions (venv, node_modules, etc.)
+
+### Documentation & Community
+
+- Brownfield document naming consistency fixes
+- Architecture template improvements
+- Trademark and licensing clarity
+- Contributing guidelines refinement
+
+### Developer Experience
+
+- Version synchronization scripts
+- Manual release workflow enhancements
+- Automatic release notes generation
+- Changelog file path configuration
+
+[View v4.43.1 tag](https://github.com/bmad-code-org/BMAD-METHOD/tree/v4.43.1)
+
+## [v4.30.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v4.30.0)
+
+**Release: July 2025 (v4.21.0 - v4.30.4)**
+
+Introduction of advanced IDE integrations and command systems.
+
+### Claude Code Integration
+
+- **Slash Commands**: Native Claude Code slash command support for agents
+- **Task Commands**: Direct task invocation via slash commands
+- **BMad Subdirectory**: Organized command structure
+- **Nested Organization**: Clean command hierarchy
+
+### Agent Enhancements
+
+- BMad-master knowledge base loading
+- Improved brainstorming facilitation
+- Better agent task following with cost-saving model combinations
+- Direct commands in agent definitions
+
+### Installer Improvements
+
+- Memory-efficient processing
+- Clear multi-select IDE prompts
+- GitHub Copilot support with improved UX
+- ASCII logo (because why not)
+
+### Platform Support
+
+- Windows compatibility improvements (regex fixes, newline handling)
+- Roo modes configuration
+- Support for multiple CLI tools simultaneously
+
+### Expansion Ecosystem
+
+- 2D Unity Game Development expansion pack
+- Improved expansion pack documentation
+- Better isolated expansion pack installations
+
+[View v4.30.4 tag](https://github.com/bmad-code-org/BMAD-METHOD/tree/v4.30.4)
+
+## [v4.20.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v4.20.0)
+
+**Release: June 2025 (v4.11.0 - v4.20.0)**
+
+Major focus on documentation quality and expanding QA agent capabilities.
+
+### Documentation Overhaul
+
+- **Workflow Diagrams**: Visual explanations of planning and development cycles
+- **QA Role Expansion**: QA agent transformed into senior code reviewer
+- **User Guide Refresh**: Complete rewrite with clearer explanations
+- **Contributing Guidelines**: Clarified principles and contribution process
+
+### QA Agent Transformation
+
+- Elevated from simple tester to senior developer/code reviewer
+- Code quality analysis and architectural feedback
+- Pre-implementation review capabilities
+- Integration with dev cycle for quality gates
+
+### IDE Ecosystem Growth
+
+- **Cline IDE Support**: Added configuration for Cline
+- **Gemini CLI Integration**: Native Gemini CLI support
+- **Expansion Pack Installation**: Automated expansion agent setup across IDEs
+
+### New Capabilities
+
+- Markdown-tree integration for document sharding
+- Quality gates to prevent task completion with failures
+- Enhanced brownfield workflow documentation
+- Team-based agent bundling improvements
+
+### Developer Tools
+
+- Better expansion pack isolation
+- Automatic rule generation for all supported IDEs
+- Common files moved to shared locations
+- Hardcoded dependencies removed from installer
+
+[View v4.20.0 tag](https://github.com/bmad-code-org/BMAD-METHOD/tree/v4.20.0)
+
+## [v4.10.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v4.10.0)
+
+**Release: June 2025 (v4.3.0 - v4.10.3)**
+
+This release focused on making BMAD more configurable and adaptable to different project structures.
+
+### Configuration System
+
+- **Optional Core Config**: Document sharding and core configuration made optional
+- **Flexible File Resolution**: Support for non-standard document structures
+- **Debug Logging**: Configurable debug mode for agent troubleshooting
+- **Fast Update Mode**: Quick updates without breaking customizations
+
+### Agent Improvements
+
+- Clearer file resolution instructions for all agents
+- Fuzzy task resolution for better agent autonomy
+- Web orchestrator knowledge base expansion
+- Better handling of deviant PRD/Architecture structures
+
+### Installation Enhancements
+
+- V4 early detection for improved update flow
+- Prevented double installation during updates
+- Better handling of YAML manifest files
+- Expansion pack dependencies properly included
+
+### Bug Fixes
+
+- SM agent file resolution issues
+- Installer upgrade path corrections
+- Bundle build improvements
+- Template formatting fixes
+
+[View v4.10.3 tag](https://github.com/bmad-code-org/BMAD-METHOD/tree/v4.10.3)
+
+## [v4.0.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v4.0.0)
+
+**Release: June 20, 2025 (v4.0.0 - v4.2.0)**
+
+Version 4 represented a complete architectural overhaul, transforming BMAD from a collection of prompts into a professional, distributable framework.
+
+### Framework Transformation
+
+- **NPM Package**: Professional distribution and simple installation via `npx bmad-method install`
+- **Modular Architecture**: Move to `.bmad-core` hidden folder structure
+- **Multi-IDE Support**: Unified support for Claude Code, Cursor, Roo, Windsurf, and many more
+- **Schema Standardization**: YAML-based agent and team definitions
+- **Automated Installation**: One-command setup with upgrade detection
+
+### Agent System Overhaul
+
+- Agent team workflows (fullstack, no-ui, all agents)
+- Web bundle generation for platform-agnostic deployment
+- Task-based architecture (separate task definitions from agents)
+- IDE-specific agent activation (slash commands for Claude Code, rules for Cursor, etc.)
+
+### New Capabilities
+
+- Brownfield project support (existing codebases)
+- Greenfield project workflows (new projects)
+- Expansion pack architecture for domain specialization
+- Document sharding for better context management
+- Automatic semantic versioning and releases
+
+### Developer Experience
+
+- Automatic upgrade path from v3 to v4
+- Backup creation for user customizations
+- VSCode settings and markdown linting
+- Comprehensive documentation restructure
+
+[View v4.2.0 tag](https://github.com/bmad-code-org/BMAD-METHOD/tree/v4.2.0)
+
+## [v3.0.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v3.0.0)
+
+**Release: May 20, 2025**
+
+Version 3 introduced the revolutionary orchestrator concept, creating a unified agent experience.
+
+### Major Features
+
+- **BMad Orchestrator**: Uber-agent that orchestrates all specialized agents
+- **Web-First Approach**: Streamlined web setup with pre-compiled agent bundles
+- **Simplified Onboarding**: Complete setup in minutes with clear quick-start guide
+- **Build System**: Scripts to compile web agents from modular components
+
+### Architecture Changes
+
+- Consolidated agent system with centralized orchestration
+- Web build sample folder with ready-to-deploy configurations
+- Improved documentation structure with visual setup guides
+- Better separation between web and IDE workflows
+
+### New Capabilities
+
+- Single agent interface (`/help` command system)
+- Brainstorming and ideation support
+- Integrated method explanation within the agent itself
+- Cross-platform consistency (Gemini Gems, Custom GPTs)
+
+[View V3 Branch](https://github.com/bmad-code-org/BMAD-METHOD/tree/V3)
+
+## [v2.0.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v2.0.0)
+
+**Release: April 17, 2025**
+
+Version 2 addressed the major shortcomings of V1 by introducing separation of concerns and quality validation mechanisms.
+
+### Major Improvements
+
+- **Template Separation**: Templates decoupled from agent definitions for greater flexibility
+- **Quality Checklists**: Advanced elicitation checklists to validate document quality
+- **Web Agent Discovery**: Recognition of Gemini Gems and Custom GPTs power for structured planning
+- **Granular Web Agents**: Simplified, clearly-defined agent roles optimized for web platforms
+- **Installer**: A project installer that copied the correct files to a folder at the destination
+
+### Key Features
+
+- Separated template files from agent personas
+- Introduced forced validation rounds through checklists
+- Cost-effective structured planning workflow using web platforms
+- Self-contained agent personas with external template references
+
+### Known Issues
+
+- Duplicate templates/checklists for web vs IDE versions
+- Manual export/import workflow between agents
+- Creating each web agent separately was tedious
+
+[View V2 Branch](https://github.com/bmad-code-org/BMAD-METHOD/tree/V2)
+
+## [v1.0.0](https://github.com/bmad-code-org/BMAD-METHOD/releases/tag/v1.0.0)
+
+**Initial Release: April 6, 2025**
+
+The original BMAD Method was a tech demo showcasing how different custom agile personas could be used to build out artifacts for planning and executing complex applications from scratch. This initial version established the foundation of the AI-driven agile development approach.
+
+### Key Features
+
+- Introduction of specialized AI agent personas (PM, Architect, Developer, etc.)
+- Template-based document generation for planning artifacts
+- Emphasis on planning MVP scope with sufficient detail to guide developer agents
+- Hard-coded custom mode prompts integrated directly into agent configurations
+- The OG of Context Engineering in a structured way
+
+### Limitations
+
+- Limited customization options
+- Web usage was complicated and not well-documented
+- Rigid scope and purpose with templates coupled to agents
+- Not optimized for IDE integration
+
+[View V1 Branch](https://github.com/bmad-code-org/BMAD-METHOD/tree/V1)
+
+## Installation
+
+```bash
+npx bmad-method
+```
+
+For detailed release notes, see the [GitHub releases page](https://github.com/bmad-code-org/BMAD-METHOD/releases).

CONTRIBUTING.md

@@ -0,0 +1,279 @@
+# Contributing to BMad
+
+Thank you for considering contributing to the BMad project! We believe in **Human Amplification, Not Replacement** - bringing out the best thinking in both humans and AI through guided collaboration.
+
+💬 **Discord Community**: Join our [Discord server](https://discord.gg/gk8jAdXWmj) for real-time discussions:
+
+- **#general-dev** - Technical discussions, feature ideas, and development questions
+- **#bugs-issues** - Bug reports and issue discussions
+
+## Our Philosophy
+
+### BMad Core™: Universal Foundation
+
+BMad Core empowers humans and AI agents working together in true partnership across any domain through our **C.O.R.E. Framework** (Collaboration Optimized Reflection Engine):
+
+- **Collaboration**: Human-AI partnership where both contribute unique strengths
+- **Optimized**: The collaborative process refined for maximum effectiveness
+- **Reflection**: Guided thinking that helps discover better solutions and insights
+- **Engine**: The powerful framework that orchestrates specialized agents and workflows
+
+### BMad Method™: Agile AI-Driven Development
+
+The BMad Method is the flagship bmad module for agile AI-driven software development. It emphasizes thorough planning and solid architectural foundations to provide detailed context for developer agents, mirroring real-world agile best practices.
+
+### Core Principles
+
+**Partnership Over Automation** - AI agents act as expert coaches, mentors, and collaborators who amplify human capability rather than replace it.
+
+**Bidirectional Guidance** - Agents guide users through structured workflows while users push agents with advanced prompting. Both sides actively work to extract better information from each other.
+
+**Systems of Workflows** - BMad Core builds comprehensive systems of guided workflows with specialized agent teams for any domain.
+
+**Tool-Agnostic Foundation** - BMad Core remains tool-agnostic, providing stable, extensible groundwork that adapts to any domain.
+
+## What Makes a Good Contribution?
+
+Every contribution should strengthen human-AI collaboration. Ask yourself: **"Does this make humans and AI better together?"**
+
+**✅ Contributions that align:**
+
+- Enhance universal collaboration patterns
+- Improve agent personas and workflows
+- Strengthen planning and context continuity
+- Increase cross-domain accessibility
+- Add domain-specific modules leveraging BMad Core
+
+**❌ What detracts from our mission:**
+
+- Purely automated solutions that sideline humans
+- Tools that don't improve the partnership
+- Complexity that creates barriers to adoption
+- Features that fragment BMad Core's foundation
+
+## Before You Contribute
+
+### Reporting Bugs
+
+1. **Check existing issues** first to avoid duplicates
+2. **Consider discussing in Discord** (#bugs-issues channel) for quick help
+3. **Use the bug report template** when creating a new issue - it guides you through providing:
+   - Clear bug description
+   - Steps to reproduce
+   - Expected vs actual behavior
+   - Model/IDE/BMad version details
+   - Screenshots or links if applicable
+4. **Indicate if you're working on a fix** to avoid duplicate efforts
+
+### Suggesting Features or New Modules
+
+1. **Discuss first in Discord** (#general-dev channel) - the feature request template asks if you've done this
+2. **Check existing issues and discussions** to avoid duplicates
+3. **Use the feature request template** when creating an issue
+4. **Be specific** about why this feature would benefit the BMad community and strengthen human-AI collaboration
+
+### Before Starting Work
+
+⚠️ **Required before submitting PRs:**
+
+1. **For bugs**: Check if an issue exists (create one using the bug template if not)
+2. **For features**: Discuss in Discord (#general-dev) AND create a feature request issue
+3. **For large changes**: Always open an issue first to discuss alignment
+
+Please propose small, granular changes! For large or significant changes, discuss in Discord and open an issue first. This prevents wasted effort on PRs that may not align with planned changes.
+
+## Pull Request Guidelines
+
+### Which Branch?
+
+**Submit to `next` branch** (most contributions):
+
+- ✨ New features or agents
+- 🎨 Enhancements to existing features
+- 📚 Documentation updates
+- ♻️ Code refactoring
+- ⚡ Performance improvements
+- 🧪 New tests
+- 🎁 New bmad modules
+
+**Submit to `main` branch** (critical only):
+
+- 🚨 Critical bug fixes that break basic functionality
+- 🔒 Security patches
+- 📚 Fixing dangerously incorrect documentation
+- 🐛 Bugs preventing installation or basic usage
+
+**When in doubt, submit to `next`**. We'd rather test changes thoroughly before they hit stable.
+
+### PR Size Guidelines
+
+- **Ideal PR size**: 200-400 lines of code changes
+- **Maximum PR size**: 800 lines (excluding generated files)
+- **One feature/fix per PR**: Each PR should address a single issue or add one feature
+- **If your change is larger**: Break it into multiple smaller PRs that can be reviewed independently
+- **Related changes**: Even related changes should be separate PRs if they deliver independent value
+
+### Breaking Down Large PRs
+
+If your change exceeds 800 lines, use this checklist to split it:
+
+- [ ] Can I separate the refactoring from the feature implementation?
+- [ ] Can I introduce the new API/interface in one PR and implementation in another?
+- [ ] Can I split by file or module?
+- [ ] Can I create a base PR with shared utilities first?
+- [ ] Can I separate test additions from implementation?
+- [ ] Even if changes are related, can they deliver value independently?
+- [ ] Can these changes be merged in any order without breaking things?
+
+Example breakdown:
+
+1. PR #1: Add utility functions and types (100 lines)
+2. PR #2: Refactor existing code to use utilities (200 lines)
+3. PR #3: Implement new feature using refactored code (300 lines)
+4. PR #4: Add comprehensive tests (200 lines)
+
+**Note**: PRs #1 and #4 could be submitted simultaneously since they deliver independent value.
+
+### Pull Request Process
+
+#### New to Pull Requests?
+
+If you're new to GitHub or pull requests, here's a quick guide:
+
+1. **Fork the repository** - Click the "Fork" button on GitHub to create your own copy
+2. **Clone your fork** - `git clone https://github.com/YOUR-USERNAME/bmad-method.git`
+3. **Create a new branch** - Never work on `main` directly!
+   ```bash
+   git checkout -b fix/description
+   # or
+   git checkout -b feature/description
+   ```
+4. **Make your changes** - Edit files, keeping changes small and focused
+5. **Commit your changes** - Use clear, descriptive commit messages
+   ```bash
+   git add .
+   git commit -m "fix: correct typo in README"
+   ```
+6. **Push to your fork** - `git push origin fix/description`
+7. **Create the Pull Request** - Go to your fork on GitHub and click "Compare & pull request"
+
+### PR Description Template
+
+Keep your PR description concise and focused. Use this template:
+
+```markdown
+## What
+
+[1-2 sentences describing WHAT changed]
+
+## Why
+
+[1-2 sentences explaining WHY this change is needed]
+Fixes #[issue number] (if applicable)
+
+## How
+
+## [2-3 bullets listing HOW you implemented it]
+
+-
+-
+
+## Testing
+
+[1-2 sentences on how you tested this]
+```
+
+**Maximum PR description length: 200 words** (excluding code examples if needed)
+
+### Good vs Bad PR Descriptions
+
+❌ **Bad Example:**
+
+> This revolutionary PR introduces a paradigm-shifting enhancement to the system's architecture by implementing a state-of-the-art solution that leverages cutting-edge methodologies to optimize performance metrics...
+
+✅ **Good Example:**
+
+> **What:** Added validation for agent dependency resolution
+> **Why:** Build was failing silently when agents had circular dependencies
+> **How:**
+>
+> - Added cycle detection in dependency-resolver.js
+> - Throws clear error with dependency chain
+>   **Testing:** Tested with circular deps between 3 agents
+
+### Commit Message Convention
+
+Use conventional commits format:
+
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation only
+- `refactor:` Code change that neither fixes a bug nor adds a feature
+- `test:` Adding missing tests
+- `chore:` Changes to build process or auxiliary tools
+
+Keep commit messages under 72 characters.
+
+### Atomic Commits
+
+Each commit should represent one logical change:
+
+- **Do:** One bug fix per commit
+- **Do:** One feature addition per commit
+- **Don't:** Mix refactoring with bug fixes
+- **Don't:** Combine unrelated changes
+
+## What Makes a Good Pull Request?
+
+✅ **Good PRs:**
+
+- Change one thing at a time
+- Have clear, descriptive titles
+- Explain what and why in the description
+- Include only the files that need to change
+- Reference related issue numbers
+
+❌ **Avoid:**
+
+- Changing formatting of entire files
+- Multiple unrelated changes in one PR
+- Copying your entire project/repo into the PR
+- Changes without explanation
+- Working directly on `main` branch
+
+## Common Mistakes to Avoid
+
+1. **Don't reformat entire files** - only change what's necessary
+2. **Don't include unrelated changes** - stick to one fix/feature per PR
+3. **Don't paste code in issues** - create a proper PR instead
+4. **Don't submit your whole project** - contribute specific improvements
+
+## Code Style
+
+- Follow the existing code style and conventions
+- Write clear comments for complex logic
+- Keep dev agents lean - they need context for coding, not documentation
+- Web/planning agents can be larger with more complex tasks
+- Everything is natural language (markdown) - no code in core framework
+- Use bmad modules for domain-specific features
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our Code of Conduct. We foster a collaborative, respectful environment focused on building better human-AI partnerships.
+
+## Need Help?
+
+- 💬 Join our [Discord Community](https://discord.gg/gk8jAdXWmj):
+  - **#general-dev** - Technical questions and feature discussions
+  - **#bugs-issues** - Get help with bugs before filing issues
+- 🐛 Report bugs using the [bug report template](https://github.com/bmad-code-org/BMAD-METHOD/issues/new?template=bug_report.md)
+- 💡 Suggest features using the [feature request template](https://github.com/bmad-code-org/BMAD-METHOD/issues/new?template=feature_request.md)
+- 📖 Browse the [GitHub Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions)
+
+---
+
+**Remember**: We're here to help! Don't be afraid to ask questions. Every expert was once a beginner. Together, we're building a future where humans and AI work better together.
+
+## License
+
+By contributing to this project, you agree that your contributions will be licensed under the same license as the project.

LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 BMad Code, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+TRADEMARK NOTICE:
+BMAD™, BMAD-CORE™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. The use of these 
+trademarks in this software does not grant any rights to use the trademarks 
+for any other purpose.

README.md

@@ -1,7 +1,274 @@
-# BMad Method V1
+# BMad CORE v6 Alpha
 
-The original version was a simple tech demo of showing how different custom agile personas could be used to build out the artifacts to have AI Agents plan and execute on building complex applications from scratch, with an emphasis on planning enough for an MVP to while filling in enough details to keep developer agents on the rails.
+[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
-Its simplicity was amazing, but it did not include a lot of customization - and using this in the web was more of an after thought that came later with V2. It was possible but complicated and not clearly communicated with V1.
+**[Subscribe to BMadCode on YouTube](https://www.youtube.com/@BMadCode?sub_confirmation=1)** and **[Join our amazing, active Discord Community](https://discord.gg/gk8jAdXWmj)**
 
-This initial version also had each custom mode prompt hard coded to the template that would all be part of the agent custom mode. This would not have worked well with many IDEs, and was very rigid in scope and purpose.
+⭐ **If you find this project helpful or useful, please give it a star in the upper right-hand corner!** It helps others discover BMad-CORE and you will be notified of updates!
+
+## The Universal Human-AI Collaboration Platform
+
+📋 **[View v6 Alpha Open Items & Roadmap](./v6-open-items.md)** - Track what's being worked on and what's coming next!
+
+### ⚠️ Important Alpha Notes
+
+**Note 0 - Frequent Updates:** Updates to the branch will be frequent. When pulling new updates, it's best to delete your node_modules folder and run `npm install` to ensure you have the latest package dependencies.
+
+**Note 1 - Alpha Stability:** ALPHA is potentially an unstable release that could drastically change. While we hope that isn't the case, your testing during this time is much appreciated. Please help us out by filing issues or reaching out in Discord to discuss.
+
+**Note 2 - Work in Progress:** ALPHA is not complete - there are still many small and big features, polish, doc improvements, and more agents and workflows coming ahead of the beta release!
+
+**Note 3 - IDE Required:** ALPHA Web Bundles and Agents are not fully working yet - you will need to use a good quality IDE to test many features, especially with the BMad Method module. However, the new agent builder and standalone agent feature can work great with weaker models - this will still evolve over the coming weeks.
+
+**Note 4 - Contributing:** If you would like to contribute a PR, make sure you are creating your PR against the Alpha Branch and not Main.
+
+## Alpha Installation and Testing
+
+**Prerequisites**: [Node.js](https://nodejs.org) v20+ required
+
+### Option A
+
+Thank you Lum for the suggestion - here is a one-shot instruction to clone just the alpha branch and get started:
+
+`git clone --branch v6-alpha --single-branch https://github.com/bmad-code-org/BMAD-METHOD` and then cd into this directory and run `npm install`.
+
+### Option B
+
+Here are the more detailed step-by-step instructions:
+
+Clone the repo with either:
+
+- `gh repo clone bmad-code-org/BMAD-METHOD`
+- `git clone https://github.com/bmad-code-org/BMAD-METHOD.git`
+- `git@github.com:bmad-code-org/BMAD-METHOD.git`
+  and then cd into the BMAD-METHOD folder.
+
+  You will then need to change to the branch as that will have cloned main, so type:
+  - `git checkout v6-alpha`
+  - type `git status` and you should see:
+    `On branch v6-alpha. Your branch is up to date with 'origin/v6-alpha'.`
+
+### Node Modules install
+
+Now you must install the node_modules with `npm install` - once complete, you should see you have a `node_modules` folder at the root of your project. (BMAD-METHOD/node_modules)
+
+### Install to your new or existing project folder
+
+Now you can run `npm run install:bmad` and follow the installer questions.
+
+NOTE: One of the first questions will ask for a destination - do not accept the default, you want to enter the full path to a new or existing folder of where your project is or will be. If you choose a net new folder, you will have to confirm you want the installer to create the directory for you.
+
+The Core Module will always be installed. The default initial module selection will be BMM for all the core BMad Method functionality and flow from brainstorming through software development.
+
+**Note on installation:** All installs now go to a single folder called `bmad` instead of multiple folders. When you install a module, you may still see folders other than the one you selected in the destination/bmad folder.
+
+This is intentional and not a bug - it will copy over to those other folders only the minimum that is needed because it is shared across the modules. For example, during Alpha to test this feature, BMM relies on the brainstorming feature of the CIS and some items from CORE - so even if you only select BMM, you will still see bmad/core and bmad/cis along with bmad/bmm.
+
+## What is the new BMad Core
+
+BMad-CORE (Collaboration Optimized Reflection Engine) is a framework that brings out the best in you through AI agents designed to enhance human thinking rather than replace it.
+
+Unlike traditional AI tools that do the work for you, BMad-CORE's specialized agents guide you through the facilitation of optimized collaborative reflective workflows to unlock your full potential across any domain. This magic powers the BMad Method, which is just one of the many modules that exist or are coming soon.
+
+## What Makes BMad-Core Different
+
+**Traditional AI**: Does the thinking for you, providing average, bland answers and solutions
+**BMad-CORE**: Brings out the best thinking in you and the AI through guided collaboration, elicitation, and facilitation
+
+### Core Philosophy: Human Amplification, Not Replacement
+
+BMad-Core's AI agents act as expert coaches, mentors, and collaborators who:
+
+- Ask the right questions to stimulate your thinking
+- Provide structured frameworks for complex problems
+- Guide you through reflective processes to discover insights
+- Help you develop mastery in your chosen domains
+- Amplify your natural abilities rather than substituting for them
+
+## The Collaboration Optimized Reflection Engine
+
+At the heart of BMad-Core lies the **C.O.R.E.** system:
+
+- **Collaboration**: Human-AI partnership where both contribute unique strengths
+- **Optimized**: The collaborative process has been refined for maximum effectiveness
+- **Reflection**: Guided thinking that helps you discover better solutions and insights
+- **Engine**: The powerful framework that orchestrates specialized agents and workflows
+
+## Universal Domain Coverage Through Modules
+
+BMad-CORE works in ANY domain through specialized modules (previously called expansion packs)!
+
+### Available Modules with Alpha Release
+
+- **BMad Core (core)**: Included and used to power every current and future module; includes a master orchestrator for the local environment and one for the web bundles used with ChatGPT or Gemini Gems, for example.
+- **BMad Method (bmm)**: Agile AI-driven software development - the classic that started it all and is still the best - but with v6, massively improved thanks to a rebuild from the ground up built on the new powerful BMad-CORE engine. The BMad Method has also been expanded to use a new "Scale Adaptive Workflow Engine"™.
+- **BMad BoMB (bmb)**: The BMad Builder is your Custom Agent, Workflow, and Module authoring tool - it's now easier than ever to customize existing modules or create whatever you can imagine as a standalone module.
+- **Creative Intelligence Suite (cis)**: Unlock innovation, problem-solving, and creative thinking! Brainstorming that was part of the BMad Method in the past is now part of this standalone module along with other workflows. The power of BMad modules still allows modules to borrow from each other - so the CIS, while standalone, also powers the brainstorming abilities for certain agents within the BMad Method!
+
+## What's New in V6-ALPHA
+
+Stability, customizability, installation Q&A, massive prompt improvements.
+
+Everything has been rewritten from the ground up with best practices and advances learned over previous versions, standardizing on prompt format techniques. There is much more core usage of XML or XML-type tags within markdown, with many conventions and standards that drastically increase agent adherence.
+
+**Customizability** is a key theme of this new version. All agents are now customizable by modifying a file under the installation bmad/\_cfg/agents. Every agent installed will generate an agent file that you can customize.
+
+The nice thing about this is when agents change or update in future versions, your customizations in these sidecar files will never be lost! You can change the name, their personas, how they talk, what they call you, and most exciting - what language they communicate in!
+
+The **BMad installer** is 100% new from the ground up. Along the way you will add:
+
+- Your name (what the agents will call you and how you'll author documents)
+- What language you want the agents to communicate in
+- Module-specific customization options
+
+When you install, a consolidated agent party is created so now when you use party-mode in the IDE, it is super efficient for the agent running the party to simulate all installed agents. Post alpha release, this will manifest itself in many interesting ways in time for beta - but for now, have fun with party mode and epic sprint retrospectives!
+
+Speaking of installation - everything will now install to a single core bmad folder. No more separate root folders for every module! Instead, all will be contained within bmad/.
+
+All IDE selections now support the option to add special install functionality per module.
+
+For example, with the alpha release, if you select the BMad Method and Claude Code, you will have an option to install pre-created Claude sub-agents. Not only do they get installed, but certain workflows will have injected into their instructions key indicators to the agent when to activate the sub-agents, removing some non-determinism.
+
+The sub-agent experience is still undergoing some work, so install them if you choose, and remove them if they become a pain.
+
+When you read about the BoMB below, it will link to more information about various features in this new evolution of BMad Code. One of the exciting features is the new agent types - there are 3 now! The most exciting are the new standalone tiny agents that you can easily generate and deploy free from any module - specialized for your exact needs.
+
+### BMad Method
+
+The BMad Method is significantly transforming and yet more powerful than ever. **Scale Adaptive** is a new term that means when you start the workflow to create a PRD or a GDD (or a simple tech-spec in the case of simple tasks), you will first answer some questions about the scope of the project, new vs. existing codebase and its state, and other questions. This will trigger a leveling of the effort from 0-4, and based on this scale adaptation, it will guide the workflow in different directions.
+
+Right now, this is still a bit alpha feeling and disjointed, but before beta it will be tied together through all four workflow phases with a potential single orchestration if you choose - or you can still jump right in, especially for simple tasks that just need a simple tech-spec and then right off to development.
+
+To test and experience this now, here is the new main flow for BMM v6 alpha:
+
+(Docs will be all linked in soon with new user guide and workflow diagrams coming this week)
+
+**NOTE:** Game Development expansion packs are all being rolled into the official BMad Method module - along with any more game engine platforms being added. Additionally, game development planning for the GDD is not only scale adaptive, but also adapts to the type of game you are making - so you can plan all that is needed for your dream game!
+
+#### **PHASE 1 - Analysis**
+
+**Analyst:**
+
+- `brainstorm-project`
+- `research` (market research, deep research, deep research prompt generation)
+- `product-brief`
+
+**Game Designer (Optional):**
+
+- `brainstorm-game`
+- `game-brief`
+- `research`
+
+---
+
+#### **PHASE 2 - Planning**
+
+**PM:**
+
+- `plan-project`
+
+**Game Designer:**
+
+- `plan-game` (calls the same plan-project workflow, but input docs or your answers should drive it towards GDD)
+
+---
+
+#### **PHASE 3 - Solutioning**
+
+**Architect or Game Architect:**
+
+Just like the scale-adjusted planning, architecture is the same. No more document sharding though!
+
+Now in the IDE you create an architecture that adapts to the type of project you are working on - based on the inputs from your PRD, it will adapt the sections it includes to your project type. No longer is the architecture biased just towards full stack or back-end APIs. There are many more options now, from embedded hardware to mobile to many other options - with many more coming with beta.
+
+- `solution-architecture`
+
+> **Note:** Testing, DevOps, or security concerns beyond the basics are generally not included in the architecture. If it is more complicated, especially for complex massive undertakings, you will be suggested to pull in specific agents to help with those areas. _(Not released with alpha.0, coming soon)_
+
+Once the full architecture is complete, you can still use the PO to run the checklist to validate the epics and stories are still correct - although the architect should also be keeping them updated as needed (needs some tuning during alpha). Once done, then it's time to create the tech spec for your first epic.
+
+- `tech-spec`
+
+The tech spec pulls all technical information from all planning thus far, along with any further research needed from the web to produce an **Epic Tech Spec** - each epic will have one. This is going to make the SM even more capable of finding the info it needs for each story when we get to phase 4!
+
+---
+
+#### **PHASE 4 - Implementation**
+
+And now here we are at phase 4 - where we, just like in BMad Method of yore, use the SM and the Dev Agent. No more QA agent here though; the dev now has a dev task and also a senior dev agent review task.
+
+**Scrum Master (SM) Tasks:**
+
+Before the dev starts, the SM will:
+
+1. `create-story`
+2. `story-context` _(NEW!)_
+
+**Story-context** is a game-changing new feature beyond what we had with create-story in the past. Create-story still pulls in all the info it needs from the tech-spec and elsewhere as needed (including previously completed stories), but the generation of the new story-context takes it to a whole new level.
+
+This real-time prep means no more generic devLoadAlways list of story files. During the alpha phase, we will be tuning what goes into this context, but this is going to supercharge and specialize your dev to the story at hand!
+
+---
+
+> **🎉 There are many other exciting changes throughout for you to discover during the alpha BMad Method module!**
+
+## CIS
+
+The CIS has 5 agents to try out, each with their own workflow! This is a new module that will drastically change over time.
+
+- [CIS Readme](./src/modules/cis/readme.md)
+
+### BoMB: BMad Builder
+
+#### Agent Docs
+
+- [Agent Architecture](src/modules/bmb/workflows/create-agent/agent-architecture)
+- [Agent command patterns](src/modules/bmb/workflows/create-agent/agent-command-patterns.md)
+- [Agent Types](src/modules/bmb/workflows/create-agent/agent-types.md)
+- [Communication Styles](src/modules/bmb/workflows/create-agent/communication-styles.md)
+
+#### Modules
+
+Modules are what we used to call Expansion Packs. A new repository to contribute modules is coming very soon with the beta release where you can start contributing modules - we just want to make sure the final format and conventions are stable. A module will generally be made up of agents and workflows. Tasks are still also possible, but generally should be avoided in favor of more flexible workflows. Workflows can have sub-workflows and soon will support a standardized multi-workflow orchestration pattern that the BMad master will be able to guide users through.
+
+- [Module Structure](src/modules/bmb/workflows/create-module/module-structure.md)
+
+#### Workflows
+
+What used to be tasks and create-doc templates are now all workflows! Simpler, yet more powerful and support many ways of achieving many different outcomes! A lot more documentation will be coming. This document is used by the agent builder to generate workflows or convert to workflows, but there is a lot more than what we have documented here in this alpha doc.
+
+- [Workflow Creation Guide](src/modules/bmb/workflows/create-workflow/workflow-creation-guide)
+
+### Installer Changes
+
+- [IDE Injections](docs/installers-bundlers/ide-injections)
+- [Installers Modules Platforms References](docs/installers-bundlers/installers-modules-platforms-reference)
+- [Web Bundler Usage](docs/installers-bundlers/web-bundler-usage)
+- [Claude Code Sub Module BMM Installer](src/modules/bmm/sub-modules/claude-code/readme.md)
+
+## Support & Community
+
+- 💬 [Discord Community](https://discord.gg/gk8jAdXWmj) - Get help, share ideas, collaborate
+- 🐛 [Issue Tracker](https://github.com/bmad-code-org/BMAD-METHOD/issues) - Bug reports and feature requests
+- 💬 [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) - Community conversations
+
+## Contributing
+
+We welcome contributions and new module development!
+
+📋 **[Read CONTRIBUTING.md](CONTRIBUTING.md)** - Complete contribution guide
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Trademark Notice
+
+BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. All rights reserved.
+
+[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
+
+<sub>Built with ❤️ for the human-AI collaboration community</sub>

ai/templates/architecture-template.md

@@ -1,187 +0,0 @@
-# Architecture for {PRD Title}
-
-Status: { Draft | Approved }
-
-## Technical Summary
-
-{ Short 1-2 paragraph }
-
-## Technology Table
-
-Table listing choices for languages, libraries, infra, cloud resources, etc... may add more detail or refinement that what was in the PRD
-
-<example>
-  | Technology | Version | Description |
-  | ---------- | ------- | ----------- |
-  | Kubernetes | x.y.z | Container orchestration platform for microservices deployment |
-  | Apache Kafka | x.y.z | Event streaming platform for real-time data ingestion |
-  | TimescaleDB | x.y.z | Time-series database for sensor data storage |
-  | Go | x.y.z | Primary language for data processing services |
-  | GoRilla Mux | x.y.z | REST API Framework |
-  | Python | x.y.z | Used for data analysis and ML services |
-  | DeepSeek LLM | R3 | Ollama local hosted and remote hosted API use for customer chat engagement |
-
-</example>
-
-## **High-Level Overview**
-
-Define the architectural style (e.g., Monolith, Microservices, Serverless) and justify the choice based on the PRD. Include a high-level diagram (e.g., C4 Context or Container level using Mermaid syntax).
-
-### **Component View**
-
-Identify major logical components/modules/services, outline their responsibilities, and describe key interactions/APIs between them. Include diagrams if helpful (e.g., C4 Container/Component or class diagrams using Mermaid syntax).
-
-## Architectural Diagrams, Data Models, Schemas
-
-{ Mermaid Diagrams for architecture }
-{ Data Models, API Specs, Schemas }
-
-<example>
-
-### Dynamo One Table Design for App Table
-
-```json
-{
-  "TableName": "AppTable",
-  "KeySchema": [
-    { "AttributeName": "PK", "KeyType": "HASH" },
-    { "AttributeName": "SK", "KeyType": "RANGE" }
-  ],
-  "AttributeDefinitions": [
-    { "AttributeName": "PK", "AttributeType": "S" },
-    { "AttributeName": "SK", "AttributeType": "S" },
-    { "AttributeName": "GSI1PK", "AttributeType": "S" },
-    { "AttributeName": "GSI1SK", "AttributeType": "S" }
-  ],
-  "GlobalSecondaryIndexes": [
-    {
-      "IndexName": "GSI1",
-      "KeySchema": [
-        { "AttributeName": "GSI1PK", "KeyType": "HASH" },
-        { "AttributeName": "GSI1SK", "KeyType": "RANGE" }
-      ],
-      "Projection": { "ProjectionType": "ALL" }
-    }
-  ],
-  "EntityExamples": [
-    {
-      "PK": "USER#123",
-      "SK": "PROFILE",
-      "GSI1PK": "USER",
-      "GSI1SK": "John Doe",
-      "email": "john@example.com",
-      "createdAt": "2023-05-01T12:00:00Z"
-    },
-    {
-      "PK": "USER#123",
-      "SK": "ORDER#456",
-      "GSI1PK": "ORDER",
-      "GSI1SK": "2023-05-15T09:30:00Z",
-      "total": 129.99,
-      "status": "shipped"
-    },
-    {
-      "PK": "PRODUCT#789",
-      "SK": "DETAILS",
-      "GSI1PK": "PRODUCT",
-      "GSI1SK": "Wireless Headphones",
-      "price": 79.99,
-      "inventory": 42
-    }
-  ]
-}
-```
-
-### Sequence Diagram for Recording Alerts
-
-```mermaid
-sequenceDiagram
-    participant Sensor
-    participant API
-    participant ProcessingService
-    participant Database
-    participant NotificationService
-
-    Sensor->>API: Send sensor reading
-    API->>ProcessingService: Forward reading data
-    ProcessingService->>ProcessingService: Validate & analyze data
-    alt Is threshold exceeded
-        ProcessingService->>Database: Store alert
-        ProcessingService->>NotificationService: Trigger notification
-        NotificationService->>NotificationService: Format alert message
-        NotificationService-->>API: Send notification status
-    else Normal reading
-        ProcessingService->>Database: Store reading only
-    end
-    Database-->>ProcessingService: Confirm storage
-    ProcessingService-->>API: Return processing result
-    API-->>Sensor: Send acknowledgement
-```
-
-### Sensor Reading Schema
-
-```json
-{
-  "sensor_id": "string",
-  "timestamp": "datetime",
-  "readings": {
-    "temperature": "float",
-    "pressure": "float",
-    "humidity": "float"
-  },
-  "metadata": {
-    "location": "string",
-    "calibration_date": "datetime"
-  }
-}
-```
-
-</example>
-
-## Project Structure
-
-{ Diagram the folder and file organization structure along with descriptions }
-
-```
-├ /src
-├── /services
-│   ├── /gateway        # Sensor data ingestion
-│   ├── /processor      # Data processing and validation
-│   ├── /analytics      # Data analysis and ML
-│   └── /notifier       # Alert and notification system
-├── /deploy
-│   ├── /kubernetes     # K8s manifests
-│   └── /terraform      # Infrastructure as Code
-└── /docs
-    ├── /api           # API documentation
-    └── /schemas       # Data schemas
-```
-
-## Testing Requirements and Framework
-
-### Patterns and Standards (Opinionated & Specific)
-
-    - **Architectural/Design Patterns:** Mandate specific patterns to be used (e.g., Repository Pattern for data access, MVC/MVVM for structure, CQRS if applicable). .
-
-    - **API Design Standards:** Define the API style (e.g., REST, GraphQL), key conventions (naming, versioning strategy, authentication method), and data formats (e.g., JSON).
-
-    - **Coding Standards:** Specify the mandatory style guide (e.g., Airbnb JavaScript Style Guide, PEP 8), code formatter (e.g., Prettier), and linter (e.g., ESLint with specific config). Define mandatory naming conventions (files, variables, classes). Define test file location conventions.
-
-    - **Error Handling Strategy:** Outline the standard approach for logging errors, propagating exceptions, and formatting error responses.
-
-### Initial Project Setup (Manual Steps)
-
-Define Story 0: Explicitly state initial setup tasks for the user. Expand on what was in the PRD if it was present already if not sufficient, or else just repeat it. Examples:
-
-- Framework CLI Generation: Specify exact command (e.g., `npx create-next-app@latest...`, `ng new...`). Justify why manual is preferred.
-- Environment Setup: Manual config file creation, environment variable setup. Register for Cloud DB Account.
-- LLM: Let up Local LLM or API key registration if using remote
-
-## Infrastructure and Deployment
-
-{ cloud accounts and resources we will need to provision and for what purpose }
-{ Specify the target deployment environment (e.g., Vercel, AWS EC2, Google Cloud Run) and outline the CI/CD strategy and any specific tools envisioned. }
-
-## Change Log
-
-{ table of changes }

ai/templates/prd-template.md

@@ -1,118 +0,0 @@
-# {Project Name} PRD
-
-## Status: { Draft | Approved }
-
-## Intro
-
-{ Short 1-2 paragraph describing the what and why of what the prd will achieve, as outlined in the project brief or through user questioning }
-
-## Goals and Context
-
-{
-A short summarization of the project brief, with highlights on:
-
-- Clear project objectives
-- Measurable outcomes
-- Success criteria
-- Key performance indicators (KPIs)
-  }
-
-## Features and Requirements
-
-{
-
-- Functional requirements
-- Non-functional requirements
-- User experience requirements
-- Integration requirements
-- Testing requirements
-  }
-
-## Epic Story List
-
-{ We will test fully before each story is complete, so there will be no dedicated Epic and stories at the end for testing }
-
-### Epic 0: Initial Manual Set Up or Provisioning
-
-- stories or tasks the user might need to perform, such as register or set up an account or provide api keys, manually configure some local resources like an LLM, etc...
-
-### Epic-1: Current PRD Epic (for example backend epic)
-
-#### Story 1: Title
-
-Requirements:
-
-- Do X
-- Create Y
-- Etc...
-
-### Epic-2: Second Current PRD Epic (for example front end epic)
-
-### Epic-N: Future Epic Enhancements (Beyond Scope of current PRD)
-
-<example>
-
-## Epic 1: My Cool App Can Retrieve Data
-
-#### Story 1: Project and NestJS Set Up
-
-Requirements:
-
-- Install NestJS CLI Globally
-- Create a new NestJS project with the nestJS cli generator
-- Test Start App Boilerplate Functionality
-- Init Git Repo and commit initial project set up
-
-#### Story 2: News Retrieval API Route
-
-Requirements:
-
-- Create API Route that returns a list of News and comments from the news source foo
-- Route post body specifies the number of posts, articles, and comments to return
-- Create a command in package.json that I can use to call the API Route (route configured in env.local)
-
-</example>
-
-## Technology Stack
-
-{ Table listing choices for languages, libraries, infra, etc...}
-
-<example>
-  | Technology | Version | Description |
-  | ---------- | ------- | ----------- |
-  | Kubernetes | x.y.z | Container orchestration platform for microservices deployment |
-  | Apache Kafka | x.y.z | Event streaming platform for real-time data ingestion |
-  | TimescaleDB | x.y.z | Time-series database for sensor data storage |
-  | Go | x.y.z | Primary language for data processing services |
-  | GoRilla Mux | x.y.z | REST API Framework |
-  | Python | x.y.z | Used for data analysis and ML services |
-</example>
-
-## Project Structure
-
-{ Diagram the folder and file organization structure along with descriptions }
-
-<example>
-
-{ folder tree diagram }
-
-</example>
-
-### POST MVP / PRD Features
-
-- Idea 1
-- Idea 2
-- ...
-- Idea N
-
-## Change Log
-
-{ Markdown table of key changes after document is no longer in draft and is updated, table includes the change title, the story id that the change happened during, and a description if the title is not clear enough }
-
-<example>
-| Change               | Story ID | Description                                                   |
-| -------------------- | -------- | ------------------------------------------------------------- |
-| Initial draft        | N/A      | Initial draft prd                                             |
-| Add ML Pipeline      | story-4  | Integration of machine learning prediction service story      |
-| Kafka Upgrade        | story-6  | Upgraded from Kafka 2.0 to Kafka 3.0 for improved performance |
-</example>

ai/templates/story-template.md

@@ -1,53 +0,0 @@
-# Story {N}: {Title}
-
-## Story
-
-**As a** {role}
-**I want** {action}
-**so that** {benefit}.
-
-## Status
-
-Draft OR In-Progress OR Complete
-
-## Context
-
-{A paragraph explaining the background, current state, and why this story is needed. Include any relevant technical context or business drivers.}
-
-## Estimation
-
-Story Points: {Story Points (1 SP=1 day of Human Development, or 10 minutes of AI development)}
-
-## Acceptance Criteria
-
-1. - [ ] {First criterion - ordered by logical progression}
-2. - [ ] {Second criterion}
-3. - [ ] {Third criterion}
-         {Use - [x] for completed items}
-
-## Subtasks
-
-1. - [ ] {Major Task Group 1}
-   1. - [ ] {Subtask}
-   2. - [ ] {Subtask}
-   3. - [ ] {Subtask}
-2. - [ ] {Major Task Group 2}
-   1. - [ ] {Subtask}
-   2. - [ ] {Subtask}
-   3. - [ ] {Subtask}
-            {Use - [x] for completed items, - [-] for skipped/cancelled items}
-
-## Testing Requirements:\*\*
-
-    - Reiterate the required code coverage percentage (e.g., >= 85%).
-
-## Story Wrap Up (To be filled in AFTER agent execution):\*\*
-
-- **Agent Model Used:** `<Agent Model Name/Version>`
-- **Agent Credit or Cost:** `<Cost/Credits Consumed>`
-- **Date/Time Completed:** `<Timestamp>`
-- **Commit Hash:** `<Git Commit Hash of resulting code>`
-- **Change Log**
-  - change X
-  - change Y
-    ...

custom-mode-prompts/architect.md

@@ -1,230 +0,0 @@
-# Role: Software Architect
-
-You are a world-class expert Software Architect with extensive experience in designing robust, scalable, and maintainable application architectures and conducting deep technical research to figure out the best patterns and technology choices to build the MVP efficiently. You specialize in translating Product Requirements Documents (PRDs) into detailed, opinionated Architecture Documents that serve as technical blueprints. You are adept at assessing technical feasibility, researching complex topics (e.g., compliance, technology trade-offs, architectural patterns), selecting appropriate technology stacks, defining standards, and clearly documenting architectural decisions and rationale.
-
-### Interaction Style
-
-- **Follow the explicit instruction regarding assessment and user confirmation before proceeding.**
-
-- Think step-by-step to ensure all requirements from the PRD and deep research are considered and the architectural design is coherent and logical.
-
-- If the PRD is ambiguous or lacks detail needed for a specific architectural decision (even after potential Deep Research), **ask clarifying questions** before proceeding with that section.
-
-- Propose specific, opinionated choices where the PRD allows flexibility, but clearly justify them based on the requirements or best practices. Avoid presenting multiple options without recommending one.
-
-- Focus solely on the information provided in the PRD context (potentially updated post-research). Do not invent requirements or features not present in the PRD, user provided info or deep research.
-
-## Primary Instructions:
-
-1. First ensure the user has provided a PRD.
-
-2. Check if the user has already produced any deep research into technology or architectural decisions which they can also provide at this time.
-
-3. Analyze the PRD and ask the user any technical clarifications we need to align on before kicking off the project that will be included in this document. The goal is to allow for some emergent choice as the agents develop our application, but ensure also that if there are any major decisions we should make or ensure are understood up front that need clarification from the user, or decisions you intend to make, we need to work with the user to first align on these decisions. NO not proceed with PRD generation until the user has answered your questions and agrees its time to create the draft.
-
-4. ONLY after the go ahead is given, and you feel confident in being able to produce the architecture needed, will you create the draft. After the draft is ready, point out any decisions you have made so the user can easily review them before we mark the architecture as approved.
-
-## Goal
-
-Collaboratively design and document a detailed, opinionated Architecture Document covering all necessary aspects from goals to glossary, based on the PRD, additional research the user might do, and also questions you will ask of the user.
-
-### Output Format
-
-Generate the Architecture Document as a well-structured Markdown file using the following template. Use headings, subheadings, bullet points, code blocks (for versions, commands, or small snippets), and Mermaid syntax for diagrams where specified. Ensure all specified versions, standards, and patterns are clearly stated. Do not be lazy in creating the document, remember that this must have maximal detail that will be stable and a reference for user stories and the ai coding agents that are dumb and forgetful to remain consistent in their future implementation of features. Data models, database patterns, code style and documentation standards, and directory structure and layout are critical. Use the following template that runs through the end of this file and include minimally all sections:
-
-````markdown
-# Architecture for {PRD Title}
-
-Status: { Draft | Approved }
-
-## Technical Summary
-
-{ Short 1-2 paragraph }
-
-## Technology Table
-
-Table listing choices for languages, libraries, infra, cloud resources, etc... may add more detail or refinement that what was in the PRD
-
-<example>
-  | Technology | Version | Description |
-  | ---------- | ------- | ----------- |
-  | Kubernetes | x.y.z | Container orchestration platform for microservices deployment |
-  | Apache Kafka | x.y.z | Event streaming platform for real-time data ingestion |
-  | TimescaleDB | x.y.z | Time-series database for sensor data storage |
-  | Go | x.y.z | Primary language for data processing services |
-  | GoRilla Mux | x.y.z | REST API Framework |
-  | Python | x.y.z | Used for data analysis and ML services |
-  | DeepSeek LLM | R3 | Ollama local hosted and remote hosted API use for customer chat engagement |
-
-</example>
-
-## **High-Level Overview**
-
-Define the architectural style (e.g., Monolith, Microservices, Serverless) and justify the choice based on the PRD. Include a high-level diagram (e.g., C4 Context or Container level using Mermaid syntax).
-
-### **Component View**
-
-Identify major logical components/modules/services, outline their responsibilities, and describe key interactions/APIs between them. Include diagrams if helpful (e.g., C4 Container/Component or class diagrams using Mermaid syntax).
-
-## Architectural Diagrams, Data Models, Schemas
-
-{ Mermaid Diagrams for architecture }
-{ Data Models, API Specs, Schemas }
-
-<example>
-
-### Dynamo One Table Design for App Table
-
-```json
-{
-  "TableName": "AppTable",
-  "KeySchema": [
-    { "AttributeName": "PK", "KeyType": "HASH" },
-    { "AttributeName": "SK", "KeyType": "RANGE" }
-  ],
-  "AttributeDefinitions": [
-    { "AttributeName": "PK", "AttributeType": "S" },
-    { "AttributeName": "SK", "AttributeType": "S" },
-    { "AttributeName": "GSI1PK", "AttributeType": "S" },
-    { "AttributeName": "GSI1SK", "AttributeType": "S" }
-  ],
-  "GlobalSecondaryIndexes": [
-    {
-      "IndexName": "GSI1",
-      "KeySchema": [
-        { "AttributeName": "GSI1PK", "KeyType": "HASH" },
-        { "AttributeName": "GSI1SK", "KeyType": "RANGE" }
-      ],
-      "Projection": { "ProjectionType": "ALL" }
-    }
-  ],
-  "EntityExamples": [
-    {
-      "PK": "USER#123",
-      "SK": "PROFILE",
-      "GSI1PK": "USER",
-      "GSI1SK": "John Doe",
-      "email": "john@example.com",
-      "createdAt": "2023-05-01T12:00:00Z"
-    },
-    {
-      "PK": "USER#123",
-      "SK": "ORDER#456",
-      "GSI1PK": "ORDER",
-      "GSI1SK": "2023-05-15T09:30:00Z",
-      "total": 129.99,
-      "status": "shipped"
-    },
-    {
-      "PK": "PRODUCT#789",
-      "SK": "DETAILS",
-      "GSI1PK": "PRODUCT",
-      "GSI1SK": "Wireless Headphones",
-      "price": 79.99,
-      "inventory": 42
-    }
-  ]
-}
-```
-````
-
-### Sequence Diagram for Recording Alerts
-
-```mermaid
-sequenceDiagram
-    participant Sensor
-    participant API
-    participant ProcessingService
-    participant Database
-    participant NotificationService
-
-    Sensor->>API: Send sensor reading
-    API->>ProcessingService: Forward reading data
-    ProcessingService->>ProcessingService: Validate & analyze data
-    alt Is threshold exceeded
-        ProcessingService->>Database: Store alert
-        ProcessingService->>NotificationService: Trigger notification
-        NotificationService->>NotificationService: Format alert message
-        NotificationService-->>API: Send notification status
-    else Normal reading
-        ProcessingService->>Database: Store reading only
-    end
-    Database-->>ProcessingService: Confirm storage
-    ProcessingService-->>API: Return processing result
-    API-->>Sensor: Send acknowledgement
-```
-
-### Sensor Reading Schema
-
-```json
-{
-  "sensor_id": "string",
-  "timestamp": "datetime",
-  "readings": {
-    "temperature": "float",
-    "pressure": "float",
-    "humidity": "float"
-  },
-  "metadata": {
-    "location": "string",
-    "calibration_date": "datetime"
-  }
-}
-```
-
-</example>
-
-## Project Structure
-
-{ Diagram the folder and file organization structure along with descriptions }
-
-```
-├ /src
-├── /services
-│   ├── /gateway        # Sensor data ingestion
-│   ├── /processor      # Data processing and validation
-│   ├── /analytics      # Data analysis and ML
-│   └── /notifier       # Alert and notification system
-├── /deploy
-│   ├── /kubernetes     # K8s manifests
-│   └── /terraform      # Infrastructure as Code
-└── /docs
-    ├── /api           # API documentation
-    └── /schemas       # Data schemas
-```
-
-## Testing Requirements and Framework
-
-- Unit Testing Standards <examples>Use Jest, 80% coverage, unit test files in line with the file they are testing</examples>
-- Integration Testing <examples>Retained in a separate tests folder outside of src. Will ensure data created is clearly test data and is also cleaned up upon verification. Etc...<examples>
-
-## Patterns and Standards (Opinionated & Specific)
-
-    - **Architectural/Design Patterns:** Mandate specific patterns to be used (e.g., Repository Pattern for data access, MVC/MVVM for structure, CQRS if applicable). .
-
-    - **API Design Standards:** Define the API style (e.g., REST, GraphQL), key conventions (naming, versioning strategy, authentication method), and data formats (e.g., JSON).
-
-    - **Coding Standards:** Specify the mandatory style guide (e.g., Airbnb JavaScript Style Guide, PEP 8), code formatter (e.g., Prettier), and linter (e.g., ESLint with specific config). Define mandatory naming conventions (files, variables, classes). Define test file location conventions.
-
-    - **Error Handling Strategy:** Outline the standard approach for logging errors, propagating exceptions, and formatting error responses.
-
-## Initial Project Setup (Manual Steps)
-
-Define Story 0: Explicitly state initial setup tasks for the user. Expand on what was in the PRD if it was present already if not sufficient, or else just repeat it. Examples:
-
-- Framework CLI Generation: Specify exact command (e.g., `npx create-next-app@latest...`, `ng new...`). Justify why manual is preferred.
-- Environment Setup: Manual config file creation, environment variable setup. Register for Cloud DB Account.
-- LLM: Let up Local LLM or API key registration if using remote
-
-## Infrastructure and Deployment
-
-{ cloud accounts and resources we will need to provision and for what purpose }
-{ Specify the target deployment environment (e.g., Vercel, AWS EC2, Google Cloud Run) and outline the CI/CD strategy and any specific tools envisioned. }
-
-## Change Log
-
-{ table of changes }
-
-```
-
-```

custom-mode-prompts/ba.md

@@ -1,65 +0,0 @@
-# Role: Brainstorming BA and RA
-
-You are a world-class expert Market & Business Analyst and also the best research assistant I have ever met, possessing deep expertise in both comprehensive market research and collaborative project definition. You excel at analyzing external market context and facilitating the structuring of initial ideas into clear, actionable Project Briefs with a focus on Minimum Viable Product (MVP) scope.
-
-You are adept at data analysis, understanding business needs, identifying market opportunities/pain points, analyzing competitors, and defining target audiences. You communicate with exceptional clarity, capable of both presenting research findings formally and engaging in structured, inquisitive dialogue to elicit project requirements.
-
-# Core Capabilities & Goal
-
-Your primary goal is to assist the user in **either**:
-
-## 1. Market Research Mode
-
-Conduct deep research on a provided product concept or market area, delivering a structured report covering:
-
-- Market Needs/Pain Points
-- Competitor Landscape
-- Target User Demographics/Behaviors
-
-## 2. Project Briefing Mode
-
-Collaboratively guide the user through brainstorming and definition to create a structured Project Brief document, covering:
-
-- Core Problem
-- Goals
-- Audience
-- Core Concept/Features (High-Level)
-- MVP Scope (In/Out)
-- (Optionally) Initial Technical Leanings
-
-# Interaction Style & Tone
-
-## Mode Identification
-
-At the start of the conversation, determine if the user requires Market Research or Project Briefing based on their request. If unclear, ask for clarification (e.g., "Are you looking for market research on this idea, or would you like to start defining a Project Brief for it?"). Confirm understanding before proceeding.
-
-## Market Research Mode
-
-- **Tone:** Professional, analytical, informative, objective.
-- **Interaction:** Focus solely on executing deep research based on the provided concept. Confirm understanding of the research topic. Do _not_ brainstorm features or define MVP. Present findings clearly and concisely in the final report.
-
-## Project Briefing Mode
-
-- **Tone:** Collaborative, inquisitive, structured, helpful, focused on clarity and feasibility.
-- **Interaction:** Engage in a dialogue, asking targeted clarifying questions about the concept, problem, goals, users, and especially the MVP scope. Guide the user step-by-step through defining each section of the Project Brief. Help differentiate the full vision from the essential MVP. If market research context is provided (e.g., from a previous interaction or file upload), refer to it.
-
-## General
-
-- Be capable of explaining market concepts or analysis techniques clearly if requested.
-- Use structured formats (lists, sections) for outputs.
-- Avoid ambiguity.
-- Prioritize understanding user needs and project goals.
-
-# Instructions
-
-1. **Identify Mode:** Determine if the user needs Market Research or Project Briefing. Ask for clarification if needed. Confirm the mode you will operate in.
-2. **Input Gathering:**
-   - _If Market Research Mode:_ Ask the user for the specific product concept or market area. Confirm understanding.
-   - _If Project Briefing Mode:_ Ask the user for their initial product concept/idea. Ask if they have prior market research findings to share as context (encourage file upload if available).
-3. **Execution:**
-   - _If Market Research Mode:_ Initiate deep research focusing on Market Needs/Pain Points, Competitor Landscape, and Target Users. Synthesize findings.
-   - _If Project Briefing Mode:_ Guide the user collaboratively through defining each Project Brief section (Core Problem, Goals, Audience, Features, MVP Scope [In/Out], Tech Leanings) by asking targeted questions. Pay special attention to defining a focused MVP.
-4. **Output Generation:**
-   - _If Market Research Mode:_ Structure the synthesized findings into a clear, professional report.
-   - _If Project Briefing Mode:_ Once all sections are defined, structure the information into a well-organized Project Brief document.
-5. **Presentation:** Present the final report or Project Brief document to the user.

custom-mode-prompts/dev.md

@@ -1,46 +0,0 @@
-# Agile Workflow and core memory procedure RULES that MUST be followed EXACTLY!
-
-## Core Initial Instructions Upon Startup:
-
-When coming online, you will first check if a ai/\story-\*.md file exists with the highest sequence number and review the story so you know the current phase of the project.
-
-If there is no story when you come online that is not in draft or in progress status, ask if the user wants to to draft the next sequence user story from the PRD if they did not instruct you to do so.
-
-The user should indicate what story to work on next, and if the story file does not exist, create the draft for it using the information from the `ai/prd.md` and `ai/architecture.md` files. Always use the `ai/templates/story-template.md` file as a template for the story. The story will be named story-{epicnumber.storynumber}.md added to the `ai/stories` folder.
-
-- Example: `ai/stories/story-0.1.md`, `ai/stories/story-1.1.md`, `ai/stories/story-1.2.md`
-
-<critical>
-You will ALWAYS wait for the user to mark the story status as approved before doing ANY work to implement the story.
-</critical>
-
-You will run tests and ensure tests pass before going to the next subtask within a story.
-
-You will update the story file as subtasks are completed. This includes marking the acceptance criteria and subtasks as completed in the <story>-<n>story.md.
-
-<critical>
-Once all subtasks are complete, inform the user that the story is ready for their review and approval. You will not proceed further at this point.
-</critical>
-
-## During Development
-
-Once a story has been marked as In Progress, and you are told to proceed with development:
-
-- Update story files as subtasks are completed.
-- If you are unsure of the next step, ask the user for clarification, and then update the story as needed to maintain a very clear memory of decisions.
-- Reference the `ai/architecture.md` if the story is inefficient or needs additional technical documentation so you are in sync with the Architects plans.
-- Reference the `ai/architecture.md` so you also understand from the source tree where to add or update code.
-- Keep files small and single focused, follow good separation of concerns, naming conventions, and dry principles,
-- Utilize good documentation standards by ensuring that we are following best practices of leaving JSDoc comments on public functions classess and interfaces.
-- When prompted by the user with command `update story`, update the current story to:
-  - Reflect the current state.
-  - Clarify next steps.
-  - Ensure the chat log in the story is up to date with any chat thread interactions
-- Continue to verify the story is correct and the next steps are clear.
-- Remember that a story is not complete if you have not also run ALL tests and verified all tests pass.
-- Do not tell the user the story is complete, or mark the story as complete, unless you have written the stories required tests to validate all newly implemented functionality, and have run ALL the tests in the entire project ensuring there is no regression.
-
-## YOU DO NOT NEED TO ASK to:
-
-- Run unit Tests during the development process until they pass.
-- Update the story AC and tasks as they are completed.

custom-mode-prompts/pm.md

@@ -1,146 +0,0 @@
-# Role: Technical Product Manager
-
-## Role
-
-You are an expert Technical Product Manager adept at translating high-level ideas into detailed, well-structured Product Requirements Documents (PRDs) suitable for Agile development teams, including comprehensive UI/UX specifications. You prioritize clarity, completeness, and actionable requirements.
-
-## Initial Instructions
-
-1. **Project Brief**: Ask the user for the project brief document contents, or if unavailable, what is the idea they want a PRD for. Continue to ask questions until you feel you have enough information to build a comprehensive PRD as outlined in the template below. The user should provide information about features in scope for MVP, and potentially what is out of scope for post-MVP that we might still need to consider for the platform.
-2. **UI/UX Details**: If there is a UI involved, ensure the user includes ideas or information about the UI if it is not clear from the features already described or the project brief. For example: UX interactions, theme, look and feel, layout ideas or specifications, specific choice of UI libraries, etc.
-3. **Technical Constraints**: If none have been provided, ask the user to provide any additional constraints or technology choices, such as: type of testing, hosting, deployments, languages, frameworks, platforms, etc.
-
-## Goal
-
-Based on the provided Project Brief, your task is to collaboratively guide me in creating a comprehensive Product Requirements Document (PRD) for the Minimum Viable Product (MVP). We need to define all necessary requirements to guide the architecture and development phases. Development will be performed by very junior developers and AI agents who work best incrementally and with limited scope or ambiguity. This document is a critical document to ensure we are on track and building the right thing for the minimum viable goal we are to achieve. This document will be used by the architect to produce further artifacts to really guide the development. The PRD you create will have:
-
-- **Very Detailed Purpose**: Problems solved, and an ordered task sequence.
-- **High-Level Architecture**: Patterns and key technical decisions (to be further developed later by the architect), high-level mermaid diagrams to help visualize interactions or use cases.
-- **Technologies**: To be used including versions, setup, and constraints.
-- **Proposed Directory Tree**: To follow good coding best practices and architecture.
-- **Unknowns, Assumptions, and Risks**: Clearly called out.
-
-## Interaction Model
-
-You will ask the user clarifying questions for unknowns to help generate the details needed for a high-quality PRD that can be used to develop the project incrementally, step by step, in a clear, methodical manner.
-
----
-
-## PRD Template
-
-You will follow the PRD Template below and minimally contain all sections from the template. This is the expected final output that will serve as the project's source of truth to realize the MVP of what we are building.
-
-```markdown
-# {Project Name} PRD
-
-## Status: { Draft | Approved }
-
-## Intro
-
-{ Short 1-2 paragraph describing the what and why of what the prd will achieve, as outlined in the project brief or through user questioning }
-
-## Goals and Context
-
-{
-A short summarization of the project brief, with highlights on:
-
-- Clear project objectives
-- Measurable outcomes
-- Success criteria
-- Key performance indicators (KPIs)
-  }
-
-## Features and Requirements
-
-{
-
-- Functional requirements
-- Non-functional requirements
-- User experience requirements
-- Integration requirements
-- Testing requirements
-  }
-
-## Epic Story List
-
-{ We will test fully before each story is complete, so there will be no dedicated Epic and stories at the end for testing }
-
-### Epic 0: Initial Manual Set Up or Provisioning
-
-- stories or tasks the user might need to perform, such as register or set up an account or provide api keys, manually configure some local resources like an LLM, etc...
-
-### Epic-1: Current PRD Epic (for example backend epic)
-
-#### Story 1: Title
-
-Requirements:
-
-- Do X
-- Create Y
-- Etc...
-
-### Epic-2: Second Current PRD Epic (for example front end epic)
-
-### Epic-N: Future Epic Enhancements (Beyond Scope of current PRD)
-
-<example>
-
-## Epic 1: My Cool App Can Retrieve Data
-
-#### Story 1: Project and NestJS Set Up
-
-Requirements:
-
-- Install NestJS CLI Globally
-- Create a new NestJS project with the nestJS cli generator
-- Test Start App Boilerplate Functionality
-- Init Git Repo and commit initial project set up
-
-#### Story 2: News Retrieval API Route
-
-Requirements:
-
-- Create API Route that returns a list of News and comments from the news source foo
-- Route post body specifies the number of posts, articles, and comments to return
-- Create a command in package.json that I can use to call the API Route (route configured in env.local)
-
-</example>
-
-## Technology Stack
-
-{ Table listing choices for languages, libraries, infra, etc...}
-
-<example>
-  | Technology | Version | Description |
-  | ---------- | ------- | ----------- |
-  | Kubernetes | x.y.z | Container orchestration platform for microservices deployment |
-  | Apache Kafka | x.y.z | Event streaming platform for real-time data ingestion |
-  | TimescaleDB | x.y.z | Time-series database for sensor data storage |
-  | Go | x.y.z | Primary language for data processing services |
-  | GoRilla Mux | x.y.z | REST API Framework |
-  | Python | x.y.z | Used for data analysis and ML services |
-</example>
-
-## Project Structure
-
-{ folder tree diagram }
-
-### POST MVP / PRD Features
-
-- Idea 1
-- Idea 2
-- ...
-- Idea N
-
-## Change Log
-
-{ Markdown table of key changes after document is no longer in draft and is updated, table includes the change title, the story id that the change happened during, and a description if the title is not clear enough }
-
-<example>
-| Change               | Story ID | Description                                                   |
-| -------------------- | -------- | ------------------------------------------------------------- |
-| Initial draft        | N/A      | Initial draft prd                                             |
-| Add ML Pipeline      | story-4  | Integration of machine learning prediction service story      |
-| Kafka Upgrade        | story-6  | Upgraded from Kafka 2.0 to Kafka 3.0 for improved performance |
-</example>
-```

custom-mode-prompts/po.md

@@ -1,28 +0,0 @@
-# Role: Product Owner
-
-## Role
-
-You are an **Expert Agile Product Owner**. Your task is to create a logically ordered backlog of Epics and User Stories for the MVP, based on the provided Product Requirements Document (PRD) and Architecture Document.
-
-## Goal
-
-Analyze all technical documents and the PRD and ensure that we have a roadmap of actionalble granular sequential stories that include all details called out for the MVP. Ensure there are no holes, differences or gaps between the architecture and the PRD - especially the sequence of stories in the PRD. You will give affirmation that the PRD story list is approved. To do this, if there are issues with it, you will further question the user or make suggestions and finally update the PRD so it meets your approval.
-
-## Instructions
-
-**CRITICAL:** Ensure the user has provided the PRD and Architecture Documents. The PRD has a high-level listing of stories and tasks, and the architecture document may contain even more details and things that need to be completed for MVP, including additional setup. Also consider if there are UX or UI artifacts provided and if the UI is already built out with wireframes or will need to be built from the ground up.
-
-**Analyze:** Carefully review the provided PRD and Architecture Document. Pay close attention to features, requirements, UI/UX flows, technical specifications, and any specified manual setup steps or dependencies mentioned in the Architecture Document.
-
-- Determine if there are gaps in the PRD or if more stories are needed for the epics.
-- The architecture could indicate that other enabler epics or stories are needed that were not thought of at the time the PRD was first produced.
-- The **goal** is to ensure we can update the list of epics and stories in the PRD to be more accurate than when it was first drafted.
-
-> **IMPORTANT NOTE:**
-> This output needs to be at a proper level of detail to document the full path of completion of the MVP from beginning to end. As coding agents work on each story and subtask sequentially, they will break it down further as needed—so the subtasks here do not need to be exhaustive, but should be informative.
-
-Ensure stories align with the **INVEST** principles (Independent, Negotiable, Valuable, Estimable, Small, Testable), keeping in mind that foundational/setup stories might have slightly different characteristics but must still be clearly defined.
-
-## Output
-
-Final Output will be made as an update to the list of stories in the PRD, and the change log in the PRD needs to also indicate what modifications or corrections the PO made.

custom-mode-prompts/sm.md

@@ -1,49 +0,0 @@
-# Role: Technical Product Manager
-
-## Role
-
-You are an expert Technical Scrum Master / Senior Engineer, highly skilled at translating Agile user stories into extremely detailed, self-contained specification files suitable for direct input to an AI coding agent operating with a clean context window. You excel at extracting and injecting relevant technical and UI/UX details from Product Requirements Documents (PRDs) and Architecture Documents, defining precise acceptance criteria, and breaking down work into granular, actionable subtasks.
-
-## Initial Instructions and Interaction Model
-
-You speak in a clear concise factual tone. If the user requests for a story list to be generated and has not provided the proper context of an PRD and possibly an architecture, and it is not clear what the high level stories are or what technical details you will need - you MUST instruct the user to provide this information first so you as a senior technical engineer / scrum master can then create the detailed user stories list.
-
-## Goal
-
-Your task is to generate a complete, detailed ai/stories/stories.md file for the AI coding agent based _only_ on the provided context files (such as a PRD, Architecture, and possible UI guidance or addendum information). The file must contain all of the stories with a separator in between each.
-
-### Output Format
-
-Generate a single Markdown file named stories.md containing the following sections for each story - the story files all need to go into the ai/stories.md/ folder at the root of the project:
-
-1.  **Story ID:** `<Story_ID>`
-2.  **Epic ID:** `<Epic_ID>`
-3.  **Title:** `<Full User Story Title>`
-4.  **Objective:** A concise (1-2 sentence) summary of the story's goal.
-5.  **Background/Context:** Briefly explain the story's purpose. **Reference general project standards** (like coding style, linting, documentation rules) by pointing to their definition in the central Architecture Document (e.g., "Adhere to project coding standards defined in ArchDoc Sec 3.2"). **Explicitly list context specific to THIS story** that was provided above (e.g., "Target Path: src/components/Auth/", "Relevant Schema: User model", "UI: Login form style per PRD Section X.Y"). _Focus on story-specific details and references to general standards, avoiding verbatim repetition of lengthy general rules._
-6.  **Acceptance Criteria (AC):**
-    - Use the Given/When/Then (GWT) format.
-    - Create specific, testable criteria covering:
-      - Happy path functionality.
-      - Negative paths and error handling (referencing UI/UX specs for error messages/states).
-      - Edge cases.
-      - Adherence to relevant NFRs (e.g., response time, security).
-      - Adherence to UI/UX specifications (e.g., layout, styling, responsiveness).
-      - _Implicitly:_ Adherence to referenced general coding/documentation standards.
-7.  **Subtask Checklist:**
-    - Provide a highly granular, step-by-step checklist for the AI agent.
-    - Break down tasks logically (e.g., file creation, function implementation, UI element coding, state management, API calls, unit test creation, error handling implementation, adding comments _per documentation standards_).
-    - Specify exact file names and paths where necessary, according to the Architecture context.
-    - Include tasks for writing unit tests to meet the specified coverage target, following the defined testing standards (e.g., AAA pattern).
-    - **Crucially, clearly identify any steps the HUMAN USER must perform manually.** Prefix these steps with `MANUAL STEP:` and provide clear, step-by-step instructions (e.g., `MANUAL STEP: Obtain API key from <Service> console.`, `MANUAL STEP: Add the key to the .env file as VARIABLE_NAME.`).
-8.  **Testing Requirements:**
-    - Explicitly state the required test types (e.g., Unit Tests via Jest).
-    - Reiterate the required code coverage percentage (e.g., >= 85%).
-    - State that the Definition of Done includes all ACs being met and all specified tests passing (implicitly including adherence to standards).
-9.  **Story Wrap Up (To be filled in AFTER agent execution):**
-    - \_Note: This section should be completed by the user/process after the AI agent has finished processing an individual story file.
-    - **Agent Model Used:** `<Agent Model Name/Version>`
-    - **Agent Credit or Cost:** `<Cost/Credits Consumed>`
-    - **Date/Time Completed:** `<Timestamp>`
-    - **Commit Hash:** `<Git Commit Hash of resulting code>`
-    - **Change Log:**

custom-mode-prompts/ux.md

@@ -1,40 +0,0 @@
-# UX Expert: Vercel V0 Prompt Engineer
-
-## Role
-
-You are a highly specialized expert in both UI/UX specification analysis and prompt engineering for Vercel's V0 AI UI generation tool. You have deep knowledge of V0's capabilities and expected input format, particularly assuming a standard stack of React, Next.js App Router, Tailwind CSS, shadcn/ui components, and lucide-react icons. Your expertise lies in meticulously translating detailed UI/UX specifications from a Product Requirements Document (PRD) into a single, optimized text prompt suitable for V0 generation.
-
-Additionally you are an expert in all things visual design and user experience, so you will offer advice or help the user work out what they need to build amazing user experiences - helping make the vision a reality
-
-## Goal
-
-Generate a single, highly optimized text prompt for Vercel's V0 to create a specific target UI component or page, based _exclusively_ on the UI/UX specifications found within a provided PRD. If the PRD lacks sufficient detail for unambiguous V0 generation, your goal is instead to provide a list of specific, targeted clarifying questions to the user.
-
-## Input
-
-- A finalized Product Requirements Document (PRD) (request user upload).
-
-## Output
-
-EITHER:
-
-- A single block of text representing the optimized V0 prompt, ready to be used within V0 (or similar tools).
-- OR a list of clarifying questions if the PRD is insufficient.
-
-## Interaction Style & Tone
-
-- **Meticulous & Analytical:** Carefully parse the provided PRD, focusing solely on extracting all UI/UX details relevant to the needed UX/UI.
-- **V0 Focused:** Interpret specifications through the lens of V0's capabilities and expected inputs (assuming shadcn/ui, lucide-react, Tailwind, etc., unless the PRD explicitly states otherwise).
-- **Detail-Driven:** Look for specifics regarding layout, spacing, typography, colors, responsiveness, component states (e.g., hover, disabled, active), interactions, specific shadcn/ui components to use, exact lucide-react icon names, accessibility considerations (alt text, labels), and data display requirements.
-- **Non-Assumptive & Questioning:** **Critically evaluate** if the extracted information is complete and unambiguous for V0 generation. If _any_ required detail is missing or vague (e.g., "appropriate spacing," "relevant icon," "handle errors"), **DO NOT GUESS or generate a partial prompt.** Instead, formulate clear, specific questions pinpointing the missing information (e.g., "What specific lucide-react icon should be used for the 'delete' action?", "What should the exact spacing be between the input field and the button?", "How should the component respond on screens smaller than 640px?"). Present _only_ these questions and await the user's answers.
-- **Precise & Concise:** Once all necessary details are available (either initially or after receiving answers), construct the V0 prompt efficiently, incorporating all specifications accurately.
-- **Tone:** Precise, analytical, highly focused on UI/UX details and V0 technical requirements, objective, and questioning when necessary.
-
-## Instructions
-
-1. **Request Input:** Ask the user for the finalized PRD (encourage file upload) and the exact name of the target component/page to generate with V0. If there is no PRD or it's lacking, converse to understand the UX and UI desired.
-2. **Analyze PRD:** Carefully read the PRD, specifically locating the UI/UX specifications (and any other relevant sections like Functional Requirements) pertaining _only_ to the target component/page.
-3. **Assess Sufficiency:** Evaluate if the specifications provide _all_ the necessary details for V0 to generate the component accurately (check layout, styling, responsiveness, states, interactions, specific component names like shadcn/ui Button, specific icon names like lucide-react Trash2, accessibility attributes, etc.). Assume V0 defaults (React, Next.js App Router, Tailwind, shadcn/ui, lucide-react) unless the PRD explicitly contradicts them.
-4. **Handle Insufficiency (If Applicable):** If details are missing or ambiguous, formulate a list of specific, targeted clarifying questions. Present _only_ this list of questions to the user. State clearly that you need answers to these questions before you can generate the V0 prompt. **Wait for the user's response.**
-5. **Generate Prompt (If Sufficient / After Clarification):** Once all necessary details are confirmed (either from the initial PRD analysis or after receiving answers to clarifying questions), construct a single, optimized V0 text prompt. Ensure the prompt incorporates all relevant specifications clearly and concisely, leveraging V0's expected syntax and keywords where appropriate.
-6. **Present Output:** Output EITHER the final V0 prompt text block OR the list of clarifying questions (as determined in step 4).

docs/codebase-flattener.md

@@ -0,0 +1,19 @@
+# Codebase Flattener Tool
+
+BMad-Core includes a powerful codebase flattener for preparing existing projects to the web for AI Analysis
+
+```bash
+# Basic usage - creates flattened-codebase.xml
+npx bmad-method flatten
+
+# Custom input/output
+npx bmad-method flatten --input /path/to/source --output project.xml
+```
+
+Features:
+
+- AI-optimized XML output format
+- Smart filtering with .gitignore respect
+- Binary file detection and exclusion
+- Real-time progress tracking
+- Comprehensive completion statistics

docs/ide-info/auggie.md

@@ -0,0 +1,31 @@
+# BMAD Method - Auggie CLI Instructions
+
+## Activating Agents
+
+BMAD agents can be installed in multiple locations based on your setup.
+
+### Common Locations
+
+- User Home: `~/.auggie/commands/`
+- Project: `.auggie/commands/`
+- Custom paths you selected
+
+### How to Use
+
+1. **Type Trigger**: Use `@{agent-name}` in your prompt
+2. **Activate**: Agent persona activates
+3. **Tasks**: Use `@task-{task-name}` for tasks
+
+### Examples
+
+```
+@dev - Activate development agent
+@architect - Activate architect agent
+@task-setup - Execute setup task
+```
+
+### Notes
+
+- Agents can be in multiple locations
+- Check your installation paths
+- Activation syntax same across all locations

docs/ide-info/claude-code.md

@@ -0,0 +1,25 @@
+# BMAD Method - Claude Code Instructions
+
+## Activating Agents
+
+BMAD agents are installed as slash commands in `.claude/commands/bmad/`.
+
+### How to Use
+
+1. **Type Slash Command**: Start with `/` to see available commands
+2. **Select Agent**: Type `/bmad-{agent-name}` (e.g., `/bmad-dev`)
+3. **Execute**: Press Enter to activate that agent persona
+
+### Examples
+
+```
+/bmad-dev - Activate development agent
+/bmad-architect - Activate architect agent
+/bmad-task-setup - Execute setup task
+```
+
+### Notes
+
+- Commands are autocompleted when you type `/`
+- Agent remains active for the conversation
+- Start new conversation to switch agents

docs/ide-info/cline.md

@@ -0,0 +1,31 @@
+# BMAD Method - Cline Instructions
+
+## Activating Agents
+
+BMAD agents are installed as **toggleable rules** in `.clinerules/` directory.
+
+### Important: Rules are OFF by default
+
+- Rules are NOT automatically loaded to avoid context pollution
+- You must manually enable the agent you want to use
+
+### How to Use
+
+1. **Open Rules Panel**: Click the rules icon below the chat input
+2. **Enable an Agent**: Toggle ON the specific agent rule you need (e.g., `01-core-dev`)
+3. **Activate in Chat**: Type `@{agent-name}` to activate that persona
+4. **Disable When Done**: Toggle OFF to free up context
+
+### Best Practices
+
+- Only enable 1-2 agents at a time to preserve context
+- Disable agents when switching tasks
+- Rules are numbered (01-, 02-) for organization, not priority
+
+### Example
+
+```
+Toggle ON: 01-core-dev.md
+In chat: "@dev help me refactor this code"
+When done: Toggle OFF the rule
+```

docs/ide-info/codex.md

@@ -0,0 +1,32 @@
+# BMAD Method - Codex Instructions
+
+## Activating Agents
+
+BMAD agents are documented in `AGENTS.md` file in project root.
+
+### CLI Mode
+
+1. **Reference Agent**: Type `@{agent-name}` in prompt
+2. **Execute Task**: Type `@task-{task-name}`
+3. **Active Session**: Agent remains active for conversation
+
+### Web Mode
+
+1. **Navigate**: Go to Agents section in web interface
+2. **Select Agent**: Click to activate agent persona
+3. **Session**: Agent active for browser session
+
+### Examples
+
+```
+@dev - Activate development agent
+@architect - Activate architect agent
+@task-setup - Execute setup task
+```
+
+### Notes
+
+- All agents documented in AGENTS.md
+- CLI: Reference with @ syntax
+- Web: Use interface to select
+- One agent active at a time

docs/ide-info/crush.md

@@ -0,0 +1,30 @@
+# BMAD Method - Crush Instructions
+
+## Activating Agents
+
+BMAD agents are installed as commands in `.crush/commands/bmad/`.
+
+### How to Use
+
+1. **Open Command Palette**: Use Crush command interface
+2. **Navigate**: Browse to `bmad/{module}/agents/`
+3. **Select Agent**: Choose the agent command
+4. **Execute**: Run to activate agent persona
+
+### Command Structure
+
+```
+.crush/commands/bmad/
+├── agents/          # All agents
+├── tasks/           # All tasks
+├── core/            # Core module
+│   ├── agents/
+│   └── tasks/
+└── {module}/        # Other modules
+```
+
+### Notes
+
+- Commands organized by module
+- Can browse hierarchically
+- Agent activates for session

docs/ide-info/cursor.md

@@ -0,0 +1,25 @@
+# BMAD Method - Cursor Instructions
+
+## Activating Agents
+
+BMAD agents are installed in `.cursor/rules/bmad/` as MDC rules.
+
+### How to Use
+
+1. **Reference in Chat**: Use `@bmad/{module}/agents/{agent-name}`
+2. **Include Entire Module**: Use `@bmad/{module}`
+3. **Reference Index**: Use `@bmad/index` for all available agents
+
+### Examples
+
+```
+@bmad/core/agents/dev - Activate dev agent
+@bmad/bmm/agents/architect - Activate architect agent
+@bmad/core - Include all core agents/tasks
+```
+
+### Notes
+
+- Rules are Manual type - only loaded when explicitly referenced
+- No automatic context pollution
+- Can combine multiple agents: `@bmad/core/agents/dev @bmad/core/agents/test`

docs/ide-info/gemini.md

@@ -0,0 +1,25 @@
+# BMAD Method - Gemini CLI Instructions
+
+## Activating Agents
+
+BMAD agents are concatenated in `.gemini/bmad-method/GEMINI.md`.
+
+### How to Use
+
+1. **Type Trigger**: Use `*{agent-name}` in your prompt
+2. **Activate**: Agent persona activates from the concatenated file
+3. **Continue**: Agent remains active for conversation
+
+### Examples
+
+```
+*dev - Activate development agent
+*architect - Activate architect agent
+*test - Activate test agent
+```
+
+### Notes
+
+- All agents loaded from single GEMINI.md file
+- Triggers with asterisk: `*{agent-name}`
+- Context includes all agents (may be large)

docs/ide-info/github-copilot.md

@@ -0,0 +1,26 @@
+# BMAD Method - GitHub Copilot Instructions
+
+## Activating Agents
+
+BMAD agents are installed as chat modes in `.github/chatmodes/`.
+
+### How to Use
+
+1. **Open Chat View**: Click Copilot icon in VS Code sidebar
+2. **Select Mode**: Click mode selector (top of chat)
+3. **Choose Agent**: Select the BMAD agent from dropdown
+4. **Chat**: Agent is now active for this session
+
+### VS Code Settings
+
+Configured in `.vscode/settings.json`:
+
+- Max requests per session
+- Auto-fix enabled
+- MCP discovery enabled
+
+### Notes
+
+- Modes persist for the chat session
+- Switch modes anytime via dropdown
+- Multiple agents available in mode selector

docs/ide-info/iflow.md

@@ -0,0 +1,33 @@
+# BMAD Method - iFlow CLI Instructions
+
+## Activating Agents
+
+BMAD agents are installed as commands in `.iflow/commands/bmad/`.
+
+### How to Use
+
+1. **Access Commands**: Use iFlow command interface
+2. **Navigate**: Browse to `bmad/agents/` or `bmad/tasks/`
+3. **Select**: Choose the agent or task command
+4. **Execute**: Run to activate
+
+### Command Structure
+
+```
+.iflow/commands/bmad/
+├── agents/     # Agent commands
+└── tasks/      # Task commands
+```
+
+### Examples
+
+```
+/bmad/agents/core-dev - Activate dev agent
+/bmad/tasks/core-setup - Execute setup task
+```
+
+### Notes
+
+- Commands organized by type (agents/tasks)
+- Agent activates for session
+- Similar to Crush command structure

docs/ide-info/kilo.md

@@ -0,0 +1,24 @@
+# BMAD Method - KiloCode Instructions
+
+## Activating Agents
+
+BMAD agents are installed as custom modes in `.kilocodemodes`.
+
+### How to Use
+
+1. **Open Project**: Modes auto-load when project opens
+2. **Select Mode**: Use mode selector in KiloCode interface
+3. **Choose Agent**: Pick `bmad-{module}-{agent}` mode
+4. **Activate**: Mode is now active
+
+### Mode Format
+
+- Mode name: `bmad-{module}-{agent}`
+- Display: `{icon} {title}`
+- Example: `bmad-core-dev` shows as `🤖 Dev`
+
+### Notes
+
+- Modes persist until changed
+- Similar to Roo Code mode system
+- Icon shows in mode selector

docs/ide-info/qwen.md

@@ -0,0 +1,25 @@
+# BMAD Method - Qwen Code Instructions
+
+## Activating Agents
+
+BMAD agents are concatenated in `.qwen/bmad-method/QWEN.md`.
+
+### How to Use
+
+1. **Type Trigger**: Use `*{agent-name}` in your prompt
+2. **Activate**: Agent persona activates from the concatenated file
+3. **Continue**: Agent remains active for conversation
+
+### Examples
+
+```
+*dev - Activate development agent
+*architect - Activate architect agent
+*test - Activate test agent
+```
+
+### Notes
+
+- All agents loaded from single QWEN.md file
+- Triggers with asterisk: `*{agent-name}`
+- Similar to Gemini CLI setup

docs/ide-info/roo.md

@@ -0,0 +1,27 @@
+# BMAD Method - Roo Code Instructions
+
+## Activating Agents
+
+BMAD agents are installed as custom modes in `.roomodes`.
+
+### How to Use
+
+1. **Open Project**: Modes auto-load when project opens
+2. **Select Mode**: Use mode selector in Roo interface
+3. **Choose Agent**: Pick `bmad-{module}-{agent}` mode
+4. **Activate**: Mode is now active with configured permissions
+
+### Permission Levels
+
+Modes are configured with file edit permissions:
+
+- Development files only
+- Configuration files only
+- Documentation files only
+- All files (if configured)
+
+### Notes
+
+- Modes persist until changed
+- Each mode has specific file access rights
+- Icon shows in mode selector for easy identification

docs/ide-info/trae.md

@@ -0,0 +1,25 @@
+# BMAD Method - Trae Instructions
+
+## Activating Agents
+
+BMAD agents are installed as rules in `.trae/rules/`.
+
+### How to Use
+
+1. **Type Trigger**: Use `@{agent-name}` in your prompt
+2. **Activate**: Agent persona activates automatically
+3. **Continue**: Agent remains active for conversation
+
+### Examples
+
+```
+@dev - Activate development agent
+@architect - Activate architect agent
+@task-setup - Execute setup task
+```
+
+### Notes
+
+- Rules auto-load from `.trae/rules/` directory
+- Multiple agents can be referenced: `@dev and @test`
+- Agent follows YAML configuration in rule file

docs/ide-info/windsurf.md

@@ -0,0 +1,22 @@
+# BMAD Method - Windsurf Instructions
+
+## Activating Agents
+
+BMAD agents are installed as workflows in `.windsurf/workflows/`.
+
+### How to Use
+
+1. **Open Workflows**: Access via Windsurf menu or command palette
+2. **Select Workflow**: Choose the agent/task workflow
+3. **Execute**: Run to activate that agent persona
+
+### Workflow Types
+
+- **Agent workflows**: `{module}-{agent}.md` (auto_execution_mode: 3)
+- **Task workflows**: `task-{module}-{task}.md` (auto_execution_mode: 2)
+
+### Notes
+
+- Agents run with higher autonomy (mode 3)
+- Tasks run with guided execution (mode 2)
+- Workflows persist for the session

docs/installers-bundlers/ide-injections.md

@@ -0,0 +1,196 @@
+# IDE Content Injection Standard
+
+## Overview
+
+This document defines the standard for IDE-specific content injection in BMAD modules. Each IDE can inject its own specific content into BMAD templates during installation without polluting the source files with IDE-specific code. The installation process is interactive, allowing users to choose what IDE-specific features they want to install.
+
+## Architecture
+
+### 1. Injection Points
+
+Files that support IDE-specific content define injection points using HTML comments:
+
+```xml
+<!-- IDE-INJECT-POINT: unique-point-name -->
+```
+
+### 2. Module Structure
+
+Each module that needs IDE-specific content creates a sub-module folder:
+
+```
+src/modules/{module-name}/sub-modules/{ide-name}/
+  ├── injections.yaml    # Injection configuration
+  ├── sub-agents/        # IDE-specific subagents (if applicable)
+  └── config.yaml        # Other IDE-specific config
+```
+
+### 3. Injection Configuration Format
+
+The `injections.yaml` file defines what content to inject where:
+
+```yaml
+# injections.yaml structure
+injections:
+  - file: 'relative/path/to/file.md' # Path relative to installation root
+    point: 'injection-point-name' # Must match IDE-INJECT-POINT name
+    requires: 'subagent-name' # Which subagent must be selected (or "any")
+    content: | # Content to inject (preserves formatting)
+      <llm>
+        <i>Instructions specific to this IDE</i>
+      </llm>
+
+# Subagents available for installation
+subagents:
+  source: 'sub-agents' # Source folder relative to this config
+  target: '.claude/agents' # Claude's expected location (don't change)
+  files:
+    - 'agent1.md'
+    - 'agent2.md'
+```
+
+### 4. Interactive Installation Process
+
+For Claude Code specifically, the installer will:
+
+1. **Detect available subagents** from the module's `injections.yaml`
+2. **Ask the user** about subagent installation:
+   - Install all subagents (default)
+   - Select specific subagents
+   - Skip subagent installation
+3. **Ask installation location** (if subagents selected):
+   - Project level: `.claude/agents/`
+   - User level: `~/.claude/agents/`
+4. **Copy selected subagents** to the chosen location
+5. **Inject only relevant content** based on selected subagents
+
+Other IDEs can implement their own installation logic appropriate to their architecture.
+
+## Implementation
+
+### IDE Installer Responsibilities
+
+Each IDE installer (e.g., `claude-code.js`) must:
+
+1. **Check for sub-modules**: Look for `sub-modules/{ide-name}/` in each installed module
+2. **Load injection config**: Parse `injections.yaml` if present
+3. **Process injections**: Replace injection points with configured content
+4. **Copy additional files**: Handle subagents or other IDE-specific files
+
+### Example Implementation (Claude Code)
+
+```javascript
+async processModuleInjections(projectDir, bmadDir, options) {
+  for (const moduleName of options.selectedModules) {
+    const configPath = path.join(
+      bmadDir, 'src/modules', moduleName,
+      'sub-modules/claude-code/injections.yaml'
+    );
+
+    if (exists(configPath)) {
+      const config = yaml.load(configPath);
+
+      // Interactive: Ask user about subagent installation
+      const choices = await this.promptSubagentInstallation(config.subagents);
+
+      if (choices.install !== 'none') {
+        // Ask where to install
+        const location = await this.promptInstallLocation();
+
+        // Process injections based on selections
+        for (const injection of config.injections) {
+          if (this.shouldInject(injection, choices)) {
+            await this.injectContent(projectDir, injection, choices);
+          }
+        }
+
+        // Copy selected subagents
+        await this.copySelectedSubagents(projectDir, config.subagents, choices, location);
+      }
+    }
+  }
+}
+```
+
+## Benefits
+
+1. **Clean Source Files**: No IDE-specific conditionals in source
+2. **Modular**: Each IDE manages its own injections
+3. **Scalable**: Easy to add support for new IDEs
+4. **Maintainable**: IDE-specific content lives with IDE config
+5. **Flexible**: Different modules can inject different content
+
+## Adding Support for a New IDE
+
+1. Create sub-module folder: `src/modules/{module}/sub-modules/{new-ide}/`
+2. Add `injections.yaml` with IDE-specific content
+3. Update IDE installer to process injections using this standard
+4. Test installation with and without the IDE selected
+
+## Example: BMM Module with Claude Code
+
+### File Structure
+
+```
+src/modules/bmm/
+├── agents/pm.md                         # Has injection point
+├── templates/prd.md                     # Has multiple injection points
+└── sub-modules/
+    └── claude-code/
+        ├── injections.yaml              # Defines what to inject
+        └── sub-agents/                  # Claude Code specific subagents
+            ├── market-researcher.md
+            ├── requirements-analyst.md
+            └── ...
+```
+
+### Injection Point in pm.md
+
+```xml
+<agent>
+  <persona>...</persona>
+  <!-- IDE-INJECT-POINT: pm-agent-instructions -->
+  <cmds>...</cmds>
+</agent>
+```
+
+### Injection Configuration
+
+```yaml
+injections:
+  - file: 'bmad/bmm/agents/pm.md'
+    point: 'pm-agent-instructions'
+    requires: 'any' # Injected if ANY subagent is selected
+    content: |
+      <llm critical="true">
+        <i>Use 'market-researcher' subagent for analysis</i>
+      </llm>
+
+  - file: 'bmad/bmm/templates/prd.md'
+    point: 'prd-goals-context-delegation'
+    requires: 'market-researcher' # Only if this specific subagent selected
+    content: |
+      <i>DELEGATE: Use 'market-researcher' subagent...</i>
+```
+
+### Result After Installation
+
+```xml
+<agent>
+  <persona>...</persona>
+  <llm critical="true">
+    <i>Use 'market-researcher' subagent for analysis</i>
+  </llm>
+  <cmds>...</cmds>
+</agent>
+```
+
+## Testing Checklist
+
+- [ ] Injection points are properly named and unique
+- [ ] injections.yaml is valid YAML with correct structure
+- [ ] Content formatting is preserved after injection
+- [ ] Installation works without the IDE (injection points removed)
+- [ ] Installation works with the IDE (content properly injected)
+- [ ] Subagents/files are copied to correct locations
+- [ ] No IDE-specific content remains when different IDE selected

docs/installers-bundlers/installers-modules-platforms-reference.md

@@ -0,0 +1,355 @@
+# BMAD v6 Installation & Module System Reference
+
+## Table of Contents
+
+1. [Overview](#overview)
+2. [Quick Start](#quick-start)
+3. [Architecture](#architecture)
+4. [Modules](#modules)
+5. [Configuration System](#configuration-system)
+6. [Platform Integration](#platform-integration)
+7. [Development Guide](#development-guide)
+8. [Troubleshooting](#troubleshooting)
+
+## Overview
+
+BMAD v6 is a modular AI agent framework with intelligent installation, platform-agnostic support, and configuration inheritance.
+
+### Key Features
+
+- **Modular Design**: Core + optional modules (BMM, CIS)
+- **Smart Installation**: Interactive configuration with dependency resolution
+- **Multi-Platform**: Supports 15+ AI coding platforms
+- **Clean Architecture**: Centralized `bmad/` directory, no source pollution
+
+## Quick Start
+
+```bash
+# Interactive installation (recommended)
+bmad install
+
+# Install specific modules
+bmad install -m bmm cis
+
+# Full installation
+bmad install -f
+
+# Check status
+bmad status
+```
+
+### Installation Options
+
+- `-d <path>`: Target directory (default: current)
+- `-m <modules...>`: Specific modules (bmm, cis)
+- `-f`: Full installation
+- `-c`: Core only
+- `-i <ide...>`: Configure specific IDEs
+- `--skip-ide`: Skip IDE configuration
+- `-v`: Verbose output
+
+## Architecture
+
+### Directory Structure
+
+```
+project-root/
+├── bmad/                    # Centralized installation
+│   ├── _cfg/               # Configuration
+│   │   ├── agents/         # Agent configs
+│   │   └── agent-party.xml # Agent manifest
+│   ├── core/               # Core module
+│   │   ├── agents/
+│   │   ├── tasks/
+│   │   └── config.yaml
+│   ├── bmm/                # BMad Method module
+│   │   ├── agents/
+│   │   ├── tasks/
+│   │   ├── templates/
+│   │   └── config.yaml
+│   └── cis/                # Creative Innovation Studio
+│       └── ...
+└── .claude/                # Platform-specific (example)
+    └── agents/
+```
+
+### Installation Flow
+
+1. **Detection**: Check existing installation
+2. **Selection**: Choose modules interactively or via CLI
+3. **Configuration**: Collect module-specific settings
+4. **Platform Setup**: Configure AI coding platforms
+5. **Installation**: Process and copy files
+6. **Generation**: Create config files with inheritance
+7. **Post-Install**: Run module installers
+8. **Manifest**: Track installed components
+
+### Key Exclusions
+
+- `_module-installer/` directories are never copied to destination
+- `localskip="true"` agents are filtered out
+- Source `config.yaml` templates are replaced with generated configs
+
+## Modules
+
+### Core Module (Required)
+
+Foundation framework with C.O.R.E. (Collaboration Optimized Reflection Engine)
+
+- **Components**: Base agents, activation system, advanced elicitation
+- **Config**: `user_name`, `communication_language`
+
+### BMM Module
+
+BMad Method for software development workflows
+
+- **Components**: PM agent, dev tasks, PRD templates, story generation
+- **Config**: `project_name`, `tech_docs`, `output_folder`, `story_location`
+- **Dependencies**: Core
+
+### CIS Module
+
+Creative Innovation Studio for design workflows
+
+- **Components**: Design agents, creative tasks
+- **Config**: `output_folder`, design preferences
+- **Dependencies**: Core
+
+### Module Structure
+
+```
+src/modules/{module}/
+├── _module-installer/       # Not copied to destination
+│   ├── installer.js        # Post-install logic
+│   └── install-menu-config.yaml
+├── agents/
+├── tasks/
+├── templates/
+└── sub-modules/            # Platform-specific content
+    └── {platform}/
+        ├── injections.yaml
+        └── sub-agents/
+```
+
+## Configuration System
+
+### Collection Process
+
+Modules define prompts in `install-menu-config.yaml`:
+
+```yaml
+project_name:
+  prompt: 'Project title?'
+  default: 'My Project'
+  result: '{value}'
+
+output_folder:
+  prompt: 'Output location?'
+  default: 'docs'
+  result: '{project-root}/{value}'
+
+tools:
+  prompt: 'Select tools:'
+  multi-select:
+    - 'Tool A'
+    - 'Tool B'
+```
+
+### Configuration Inheritance
+
+Core values cascade to ALL modules automatically:
+
+```yaml
+# core/config.yaml
+user_name: "Jane"
+communication_language: "English"
+
+# bmm/config.yaml (generated)
+project_name: "My App"
+tech_docs: "/path/to/docs"
+# Core Configuration Values (inherited)
+user_name: "Jane"
+communication_language: "English"
+```
+
+**Reserved Keys**: Core configuration keys cannot be redefined by other modules.
+
+### Path Placeholders
+
+- `{project-root}`: Project directory path
+- `{value}`: User input
+- `{module}`: Module name
+- `{core:field}`: Reference core config value
+
+### Config Generation Rules
+
+1. ALL installed modules get a `config.yaml` (even without prompts)
+2. Core values are ALWAYS included in module configs
+3. Module-specific values come first, core values appended
+4. Source templates are never copied, only generated configs
+
+## Platform Integration
+
+### Supported Platforms
+
+**Preferred** (Full Integration):
+
+- Claude Code
+- Cursor
+- Windsurf
+
+**Additional**:
+Cline, Roo, Auggie, GitHub Copilot, Codex, Gemini, Qwen, Trae, Kilo, Crush, iFlow
+
+### Platform Features
+
+1. **Setup Handler** (`tools/cli/installers/lib/ide/{platform}.js`)
+   - Directory creation
+   - Configuration generation
+   - Agent processing
+
+2. **Content Injection** (`sub-modules/{platform}/injections.yaml`)
+
+   ```yaml
+   injections:
+     - file: 'bmad/bmm/agents/pm.md'
+       point: 'pm-agent-instructions'
+       content: |
+         <i>Platform-specific instruction</i>
+
+   subagents:
+     source: 'sub-agents'
+     target: '.claude/agents'
+     files: ['agent.md']
+   ```
+
+3. **Interactive Config**
+   - Subagent selection
+   - Installation scope (project/user)
+   - Feature toggles
+
+### Injection System
+
+Platform-specific content without source modification:
+
+- Inject points marked in source: `<!-- IDE-INJECT-POINT:name -->`
+- Content added during installation only
+- Source files remain clean
+
+## Development Guide
+
+### Creating a Module
+
+1. **Structure**
+
+   ```
+   src/modules/mymod/
+   ├── _module-installer/
+   │   ├── installer.js
+   │   └── install-menu-config.yaml
+   ├── agents/
+   └── tasks/
+   ```
+
+2. **Configuration** (`install-menu-config.yaml`)
+
+   ```yaml
+   code: mymod
+   name: 'My Module'
+   prompt: 'Welcome message'
+
+   setting_name:
+     prompt: 'Configure X?'
+     default: 'value'
+   ```
+
+3. **Installer** (`installer.js`)
+   ```javascript
+   async function install(options) {
+     const { projectRoot, config, installedIDEs, logger } = options;
+     // Custom logic
+     return true;
+   }
+   module.exports = { install };
+   ```
+
+### Adding Platform Support
+
+1. Create handler: `tools/cli/installers/lib/ide/myplatform.js`
+2. Extend `BaseIdeSetup` class
+3. Add sub-module: `src/modules/{mod}/sub-modules/myplatform/`
+4. Define injections and platform agents
+
+### Agent Configuration
+
+Extractable config nodes:
+
+```xml
+<agent>
+  <setting agentConfig="true">
+    Default value
+  </setting>
+</agent>
+```
+
+Generated in: `bmad/_cfg/agents/{module}-{agent}.md`
+
+## Troubleshooting
+
+### Common Issues
+
+| Issue                     | Solution                            |
+| ------------------------- | ----------------------------------- |
+| Existing installation     | Use `bmad update` or remove `bmad/` |
+| Module not found          | Check `src/modules/` exists         |
+| Config not applied        | Verify `bmad/{module}/config.yaml`  |
+| Missing config.yaml       | Fixed: All modules now get configs  |
+| Agent unavailable         | Check for `localskip="true"`        |
+| \_module-installer copied | Fixed: Now excluded from copy       |
+
+### Debug Commands
+
+```bash
+bmad install -v     # Verbose installation
+bmad status -v      # Detailed status
+```
+
+### Best Practices
+
+1. Run from project root
+2. Backup `bmad/_cfg/` before updates
+3. Use interactive mode for guidance
+4. Review generated configs post-install
+
+## Migration from v4
+
+| v4                  | v6                  |
+| ------------------- | ------------------- |
+| Scattered files     | Centralized `bmad/` |
+| Monolithic          | Modular             |
+| Manual config       | Interactive setup   |
+| Limited IDE support | 15+ platforms       |
+| Source modification | Clean injection     |
+
+## Technical Notes
+
+### Dependency Resolution
+
+- Direct dependencies (module → module)
+- Agent references (cross-module)
+- Template dependencies
+- Partial module installation (only required files)
+
+### File Processing
+
+- Filters `localskip="true"` agents
+- Excludes `_module-installer/` directories
+- Replaces path placeholders at runtime
+- Injects activation blocks
+
+### Web Bundling
+
+```bash
+bmad bundle --web           # Filter for web deployment
+npm run validate:bundles    # Validate bundles
+```

docs/installers-bundlers/web-bundler-usage.md

@@ -0,0 +1,54 @@
+# Web Bundler Usage
+
+ALPHA NOTE: Bundling of individual agents might work, team bundling is being reworked and will come with Beta release soon.
+
+The web bundler creates self-contained XML bundles for BMAD agents, packaging all dependencies for web deployment.
+
+## Quick Start
+
+```bash
+# Bundle all agents from all modules
+npm run bundle
+
+# Clean and rebundle (removes old bundles first)
+npm run rebundle
+```
+
+## Custom Output Directory
+
+```bash
+# Bundle to custom directory
+node tools/cli/bundlers/bundle-web.js all --output ./my-bundles
+
+# Rebundle to custom directory (auto-cleans first)
+node tools/cli/bundlers/bundle-web.js rebundle --output /absolute/path/to/custom/directory
+
+# Bundle specific module to custom directory
+node tools/cli/bundlers/bundle-web.js module bmm --output ./custom-folder
+
+# Bundle specific agent to custom directory
+node tools/cli/bundlers/bundle-web.js agent bmm analyst -o ./custom-folder
+```
+
+## Output
+
+Bundles are generated in `web-bundles/` directory by default when run from the root of the clones project:
+
+```
+web-bundles/
+├── [module-name]/
+│   └── agents/
+│       └── [agent-name].xml
+```
+
+## Skipping Agents
+
+Agents with `bundle="false"` attribute are automatically skipped during bundling.
+
+## Bundle Contents
+
+Each bundle includes:
+
+- Agent definition with web activation
+- All resolved dependencies
+- Manifests for agent/team discovery

eslint.config.mjs

@@ -0,0 +1,129 @@
+import js from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier/flat';
+import nodePlugin from 'eslint-plugin-n';
+import unicorn from 'eslint-plugin-unicorn';
+import yml from 'eslint-plugin-yml';
+
+export default [
+  // Global ignores for files/folders that should not be linted
+  {
+    ignores: [
+      'dist/**',
+      'coverage/**',
+      '**/*.min.js',
+      'test/template-test-generator/**',
+      'test/template-test-generator/**/*.js',
+      'test/template-test-generator/**/*.md',
+    ],
+  },
+
+  // Base JavaScript recommended rules
+  js.configs.recommended,
+
+  // Node.js rules
+  ...nodePlugin.configs['flat/mixed-esm-and-cjs'],
+
+  // Unicorn rules (modern best practices)
+  unicorn.configs.recommended,
+
+  // YAML linting
+  ...yml.configs['flat/recommended'],
+
+  // Place Prettier last to disable conflicting stylistic rules
+  eslintConfigPrettier,
+
+  // Project-specific tweaks
+  {
+    rules: {
+      // Allow console for CLI tools in this repo
+      'no-console': 'off',
+      // Enforce .yaml file extension for consistency
+      'yml/file-extension': [
+        'error',
+        {
+          extension: 'yaml',
+          caseSensitive: true,
+        },
+      ],
+      // Prefer double quotes in YAML wherever quoting is used, but allow the other to avoid escapes
+      'yml/quotes': [
+        'error',
+        {
+          prefer: 'double',
+          avoidEscape: true,
+        },
+      ],
+      // Relax some Unicorn rules that are too opinionated for this codebase
+      'unicorn/prevent-abbreviations': 'off',
+      'unicorn/no-null': 'off',
+    },
+  },
+
+  // CLI/CommonJS scripts under tools/**
+  {
+    files: ['tools/**/*.js'],
+    rules: {
+      // Allow CommonJS patterns for Node CLI scripts
+      'unicorn/prefer-module': 'off',
+      'unicorn/import-style': 'off',
+      'unicorn/no-process-exit': 'off',
+      'n/no-process-exit': 'off',
+      'unicorn/no-await-expression-member': 'off',
+      'unicorn/prefer-top-level-await': 'off',
+      // Avoid failing CI on incidental unused vars in internal scripts
+      'no-unused-vars': 'off',
+      // Reduce style-only churn in internal tools
+      'unicorn/prefer-ternary': 'off',
+      'unicorn/filename-case': 'off',
+      'unicorn/no-array-reduce': 'off',
+      'unicorn/no-array-callback-reference': 'off',
+      'unicorn/consistent-function-scoping': 'off',
+      'n/no-extraneous-require': 'off',
+      'n/no-extraneous-import': 'off',
+      'n/no-unpublished-require': 'off',
+      'n/no-unpublished-import': 'off',
+      // Some scripts intentionally use globals provided at runtime
+      'no-undef': 'off',
+      // Additional relaxed rules for legacy/internal scripts
+      'no-useless-catch': 'off',
+      'unicorn/prefer-number-properties': 'off',
+      'no-unreachable': 'off',
+    },
+  },
+
+  // Module installer scripts use CommonJS for compatibility
+  {
+    files: ['**/_module-installer/**/*.js'],
+    rules: {
+      // Allow CommonJS patterns for installer scripts
+      'unicorn/prefer-module': 'off',
+      'n/no-missing-require': 'off',
+      'n/no-unpublished-require': 'off',
+    },
+  },
+
+  // ESLint config file should not be checked for publish-related Node rules
+  {
+    files: ['eslint.config.mjs'],
+    rules: {
+      'n/no-unpublished-import': 'off',
+    },
+  },
+
+  // GitHub workflow files in this repo may use empty mapping values
+  {
+    files: ['.github/workflows/**/*.yaml'],
+    rules: {
+      'yml/no-empty-mapping-value': 'off',
+    },
+  },
+
+  // Other GitHub YAML files may intentionally use empty values and reserved filenames
+  {
+    files: ['.github/**/*.yaml'],
+    rules: {
+      'yml/no-empty-mapping-value': 'off',
+      'unicorn/filename-case': 'off',
+    },
+  },
+];

package.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "bmad-method",
+  "version": "6.0.0-alpha.0",
+  "description": "Breakthrough Method of Agile AI-driven Development",
+  "keywords": [
+    "agile",
+    "ai",
+    "orchestrator",
+    "development",
+    "methodology",
+    "agents",
+    "bmad"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bmad-code-org/BMAD-METHOD.git"
+  },
+  "license": "MIT",
+  "author": "Brian (BMad) Madison",
+  "main": "tools/cli/bmad-cli.js",
+  "bin": {
+    "bmad": "tools/cli/bmad-cli.js"
+  },
+  "scripts": {
+    "bmad:install": "node tools/cli/bmad-cli.js install",
+    "bmad:status": "node tools/cli/bmad-cli.js status",
+    "bundle": "node tools/cli/bundlers/bundle-web.js all",
+    "flatten": "node tools/flattener/main.js",
+    "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,md,yaml}\"",
+    "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,md,yaml}\"",
+    "install:bmad": "node tools/cli/bmad-cli.js install",
+    "lint": "eslint . --ext .js,.cjs,.mjs,.yaml --max-warnings=0",
+    "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
+    "prepare": "husky",
+    "rebundle": "node tools/cli/bundlers/bundle-web.js rebundle",
+    "release:major": "gh workflow run \"Manual Release\" -f version_bump=major",
+    "release:minor": "gh workflow run \"Manual Release\" -f version_bump=minor",
+    "release:patch": "gh workflow run \"Manual Release\" -f version_bump=patch",
+    "release:watch": "gh run watch",
+    "validate:bundles": "node tools/validate-bundles.js"
+  },
+  "lint-staged": {
+    "*.{js,cjs,mjs}": [
+      "npm run lint:fix",
+      "npm run format:fix"
+    ],
+    "*.yaml": [
+      "eslint --fix",
+      "npm run format:fix"
+    ],
+    "*.{json,md}": [
+      "npm run format:fix"
+    ]
+  },
+  "dependencies": {
+    "@kayvan/markdown-tree-parser": "^1.6.1",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.0",
+    "csv-parse": "^6.1.0",
+    "figlet": "^1.8.0",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.3",
+    "ignore": "^7.0.5",
+    "inquirer": "^8.2.6",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1",
+    "semver": "^7.6.3",
+    "wrap-ansi": "^7.0.0",
+    "xml2js": "^0.6.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.33.0",
+    "eslint": "^9.33.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-n": "^17.21.3",
+    "eslint-plugin-unicorn": "^60.0.0",
+    "eslint-plugin-yml": "^1.18.0",
+    "husky": "^9.1.7",
+    "jest": "^30.0.4",
+    "lint-staged": "^16.1.1",
+    "prettier": "^3.5.3",
+    "prettier-plugin-packagejson": "^2.5.19",
+    "yaml-eslint-parser": "^1.2.3",
+    "yaml-lint": "^1.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

prettier.config.mjs

@@ -0,0 +1,32 @@
+export default {
+  $schema: 'https://json.schemastore.org/prettierrc',
+  printWidth: 140,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  arrowParens: 'always',
+  endOfLine: 'lf',
+  proseWrap: 'preserve',
+  overrides: [
+    {
+      files: ['*.md'],
+      options: { proseWrap: 'preserve' },
+    },
+    {
+      files: ['*.yaml'],
+      options: { singleQuote: false },
+    },
+    {
+      files: ['*.json', '*.jsonc'],
+      options: { singleQuote: false },
+    },
+    {
+      files: ['*.cjs'],
+      options: { parser: 'babel' },
+    },
+  ],
+  plugins: ['prettier-plugin-packagejson'],
+};

src/core/_module-installer/install-menu-config.yaml

@@ -0,0 +1,24 @@
+# BMAD™ Core Configuration
+
+prompt:
+  - "Welcome and thank you for choosing BMAD™! This is the Core Configuration."
+  - "Core Config is personalized configuration that is git ignored."
+  - "This will impact all selected modules, either additions or upgrades."
+
+# This is injected into the custom agent activation rules
+user_name:
+  prompt: "What is your name?"
+  default: "Jane"
+  result: "{value}"
+
+# This is injected into the custom agent activation rules
+communication_language:
+  prompt: "Preferred language?"
+  default: "English"
+  result: "{value}"
+
+# This is injected into the custom agent activation rules
+output_folder:
+  prompt: "Where should the generated output default save location be?"
+  default: "docs"
+  result: "{project-root}/{value}"

src/core/_module-installer/installer.js

@@ -0,0 +1,68 @@
+const chalk = require('chalk');
+
+/**
+ * Core Module Installer
+ * Standard module installer function that executes after IDE installations
+ *
+ * @param {Object} options - Installation options
+ * @param {string} options.projectRoot - The root directory of the target project
+ * @param {Object} options.config - Module configuration from install-menu-config.yaml
+ * @param {Array<string>} options.installedIDEs - Array of IDE codes that were installed
+ * @param {Object} options.logger - Logger instance for output
+ * @returns {Promise<boolean>} - Success status
+ */
+async function install(options) {
+  const { projectRoot, config, installedIDEs, logger } = options;
+
+  try {
+    logger.log(chalk.blue('🏗️  Installing Core Module...'));
+
+    // Core agent configs are created by the main installer's createAgentConfigs method
+    // No need to create them here - they'll be handled along with all other agents
+
+    // Handle IDE-specific configurations if needed
+    if (installedIDEs && installedIDEs.length > 0) {
+      logger.log(chalk.cyan(`Configuring Core for IDEs: ${installedIDEs.join(', ')}`));
+
+      // Add any IDE-specific Core configurations here
+      for (const ide of installedIDEs) {
+        await configureForIDE(ide, projectRoot, config, logger);
+      }
+    }
+
+    logger.log(chalk.green('✓ Core Module installation complete'));
+    return true;
+  } catch (error) {
+    logger.error(chalk.red(`Error installing Core module: ${error.message}`));
+    return false;
+  }
+}
+
+/**
+ * Configure Core module for specific IDE
+ * @private
+ */
+async function configureForIDE(ide) {
+  // Add IDE-specific configurations here
+  switch (ide) {
+    case 'claude-code': {
+      // Claude Code specific Core configurations
+      break;
+    }
+    case 'cursor': {
+      // Cursor specific Core configurations
+      break;
+    }
+    case 'windsurf': {
+      // Windsurf specific Core configurations
+      break;
+    }
+    // Add more IDEs as needed
+    default: {
+      // No specific configuration needed
+      break;
+    }
+  }
+}
+
+module.exports = { install };

src/core/agents/bmad-master.md

@@ -0,0 +1,27 @@
+<!-- Powered by BMAD-CORE™ -->
+
+# BMad Master Task Executor
+
+```xml
+<agent id="bmad/core/agents/bmad-master.md" name="BMad Master" title="BMad Master Task Executor" icon="🧙">
+  <persona>
+    <role>Master Task Executor + BMad Expert</role>
+    <identity>Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.</identity>
+    <communication_style>Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.</communication_style>
+    <principles>Load resources at runtime never pre-load, and always present numbered lists for choices.</principles>
+  </persona>
+  <critical-actions>
+    <i>Load into memory {project-root}/bmad/core/config.yaml and set variable project_name, output_folder, user_name, communication_language</i>
+    <i>Remember the users name is {user_name}</i>
+    <i>ALWAYS communicate in {communication_language}</i>
+  </critical-actions>
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+    <c cmd="*list-tasks" action="list all tasks from {project-root}/bmad/_cfg/task-manifest.csv">List Available Tasks</c>
+    <c cmd="*list-workflows" action="list all workflows from {project-root}/bmad/_cfg/workflow-manifest.csv">List Workflows</c>
+    <c cmd="*party-mode" run-workflow="{project-root}/bmad/core/workflows/party-mode/workflow.yaml">Group chat with all agents</c>
+    <c cmd="*bmad-init" run-workflow="{project-root}/bmad/core/workflows/bmad-init/workflow.yaml">Initialize or Update BMAD system agent manifest, customization, or workflow selection</c>
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>
+```

src/core/agents/bmad-web-orchestrator.md

@@ -0,0 +1,71 @@
+```xml
+<agent id="bmad/core/agents/bmad-orchestrator.md" name="BMad Orchestrator" title="BMad Web Orchestrator" icon="🎭" localskip="true">
+  <activation critical="true">
+    <notice>PRIMARY OPERATING PROCEDURE - Read and follow this entire node EXACTLY</notice>
+    <steps>
+      <s>1:Read this entire XML node - this is your complete persona and operating procedure</s>
+      <s>2:Greet user as BMad Orchestrator + run *help to show available commands</s>
+      <s>3:HALT and await user commands (except if activation included specific commands to execute)</s>
+    </steps>
+    <rules>
+      <r critical="true">NO external agent files - all agents are in 'agent' XML nodes findable by id</r>
+      <r critical="true">NO external task files - all tasks are in 'task' XML nodes findable by id</r>
+      <r>Tasks are complete workflows, not references - follow exactly as written</r>
+      <r>elicit=true attributes require user interaction before proceeding</r>
+      <r>Options ALWAYS presented to users as numbered lists</r>
+      <r>STAY IN CHARACTER until *exit command received</r>
+      <r>Resource Navigation: All resources found by XML Node ID within this bundle</r>
+      <r>Execution Context: Web environment only - no file system access, use canvas if available for document drafting</r>
+    </rules>
+  </activation>
+
+  <command-resolution critical="true">
+    <rule>ONLY execute commands of the CURRENT AGENT PERSONA you are inhabiting</rule>
+    <rule>If user requests command from another agent, instruct them to switch agents first using *agents command</rule>
+    <rule>Numeric input → Execute command at cmd_map[n] of current agent</rule>
+    <rule>Text input → Fuzzy match against *cmd commands of current agent</rule>
+    <action>Extract exec, tmpl, and data attributes from matched command</action>
+    <action>Resolve ALL paths by XML node id, treating each node as complete self-contained file</action>
+    <action>Verify XML node existence BEFORE attempting execution</action>
+    <action>Show exact XML node id in any error messages</action>
+    <rule>NEVER improvise - only execute loaded XML node instructions as active agent persona</rule>
+  </command-resolution>
+
+  <execution-rules critical="true">
+    <rule>Stay in character until *exit command - then return to primary orchestrator</rule>
+    <rule>Load referenced nodes by id ONLY when user commands require specific node</rule>
+    <rule>Follow loaded instructions EXACTLY as written</rule>
+    <rule>AUTO-SAVE after EACH major section, update CANVAS if available</rule>
+    <rule>NEVER TRUNCATE output document sections</rule>
+    <rule>Process all commands starting with * immediately</rule>
+    <rule>Always remind users that commands require * prefix</rule>
+  </execution-rules>
+
+  <persona>
+    <role>Master Orchestrator + Module Expert</role>
+    <identity>Master orchestrator with deep expertise across all loaded agents and workflows. Expert at assessing user needs and recommending optimal approaches. Skilled in dynamic persona transformation and workflow guidance. Technical brilliance balanced with approachable communication.</identity>
+    <communication_style>Knowledgeable, guiding, approachable. Adapts to current persona/task context. Encouraging and efficient with clear next steps. Always explicit about active state and requirements.</communication_style>
+    <core_principles>
+      <p>Transform into any loaded agent on demand</p>
+      <p>Assess needs and recommend best agent/workflow/approach</p>
+      <p>Track current state and guide to logical next steps</p>
+      <p>When embodying specialized persona, their principles take precedence</p>
+      <p>Be explicit about active persona and current task</p>
+      <p>Present all options as numbered lists</p>
+      <p>Process * commands immediately without delay</p>
+      <p>Remind users that commands require * prefix</p>
+    </core_principles>
+  </persona>
+  <cmds>
+    <c cmd="*help">Show numbered command list for current agent</c>
+    <c cmd="*list-agents" exec="list available agents from bmad/web-manifest.xml nodes type agent">List all available agents</c>
+    <c cmd="*agents [agent]" exec="Transform into the selected agent">Transform into specific agent</c>
+    <c cmd="*list-tasks" exec="list all tasks from node bmad/web-manifest.xml nodes type task">List available tasks</c>
+    <c cmd="*list-templates" exec="list all templates from bmad/web-manifest.xml nodes type templates">List available templates</c>
+    <c cmd="*kb-mode" exec="bmad/core/tasks/kb-interact.md">Load full BMad knowledge base</c>
+    <c cmd="*party-mode" run-workflow="{project-root}/bmad/core/workflows/party-mode/workflow.yaml">Group chat with all agents</c>
+    <c cmd="*yolo">Toggle skip confirmations mode</c>
+    <c cmd="*exit">Return to BMad Orchestrator or exit session</c>
+  </cmds>
+</agent>
+```

src/core/tasks/adv-elicit-methods.csv

@@ -0,0 +1,39 @@
+category,method_name,description,output_pattern
+advanced,Tree of Thoughts,Explore multiple reasoning paths simultaneously then evaluate and select the best - perfect for complex problems with multiple valid approaches where finding the optimal path matters,paths → evaluation → selection
+advanced,Graph of Thoughts,Model reasoning as an interconnected network of ideas to reveal hidden relationships - ideal for systems thinking and discovering emergent patterns in complex multi-factor situations,nodes → connections → patterns
+advanced,Thread of Thought,Maintain coherent reasoning across long contexts by weaving a continuous narrative thread - essential for RAG systems and maintaining consistency in lengthy analyses,context → thread → synthesis
+advanced,Self-Consistency Validation,Generate multiple independent approaches then compare for consistency - crucial for high-stakes decisions where verification and consensus building matter,approaches → comparison → consensus
+advanced,Meta-Prompting Analysis,Step back to analyze the approach structure and methodology itself - valuable for optimizing prompts and improving problem-solving strategies,current → analysis → optimization
+advanced,Reasoning via Planning,Build a reasoning tree guided by world models and goal states - excellent for strategic planning and sequential decision-making tasks,model → planning → strategy
+collaboration,Stakeholder Round Table,Convene multiple personas to contribute diverse perspectives - essential for requirements gathering and finding balanced solutions across competing interests,perspectives → synthesis → alignment
+collaboration,Expert Panel Review,Assemble domain experts for deep specialized analysis - ideal when technical depth and peer review quality are needed,expert views → consensus → recommendations
+competitive,Red Team vs Blue Team,Adversarial attack-defend analysis to find vulnerabilities - critical for security testing and building robust solutions through adversarial thinking,defense → attack → hardening
+core,Expand or Contract for Audience,Dynamically adjust detail level and technical depth for target audience - essential when content needs to match specific reader capabilities,audience → adjustments → refined content
+core,Critique and Refine,Systematic review to identify strengths and weaknesses then improve - standard quality check for drafts needing polish and enhancement,strengths/weaknesses → improvements → refined version
+core,Explain Reasoning,Walk through step-by-step thinking to show how conclusions were reached - crucial for transparency and helping others understand complex logic,steps → logic → conclusion
+core,First Principles Analysis,Strip away assumptions to rebuild from fundamental truths - breakthrough technique for innovation and solving seemingly impossible problems,assumptions → truths → new approach
+core,5 Whys Deep Dive,Repeatedly ask why to drill down to root causes - simple but powerful for understanding failures and fixing problems at their source,why chain → root cause → solution
+core,Socratic Questioning,Use targeted questions to reveal hidden assumptions and guide discovery - excellent for teaching and helping others reach insights themselves,questions → revelations → understanding
+creative,Reverse Engineering,Work backwards from desired outcome to find implementation path - powerful for goal achievement and understanding how to reach specific endpoints,end state → steps backward → path forward
+creative,What If Scenarios,Explore alternative realities to understand possibilities and implications - valuable for contingency planning and creative exploration,scenarios → implications → insights
+creative,SCAMPER Method,Apply seven creativity lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - systematic ideation for product innovation and improvement,S→C→A→M→P→E→R
+learning,Feynman Technique,Explain complex concepts simply as if teaching a child - the ultimate test of true understanding and excellent for knowledge transfer,complex → simple → gaps → mastery
+learning,Active Recall Testing,Test understanding without references to verify true knowledge - essential for identifying gaps and reinforcing mastery,test → gaps → reinforcement
+narrative,Unreliable Narrator Mode,Question assumptions and biases by adopting skeptical perspective - crucial for detecting hidden agendas and finding balanced truth,perspective → biases → balanced view
+optimization,Speedrun Optimization,Find the fastest most efficient path by eliminating waste - perfect when time pressure demands maximum efficiency,current → bottlenecks → optimized
+optimization,New Game Plus,Revisit challenges with enhanced capabilities from prior experience - excellent for iterative improvement and mastery building,initial → enhanced → improved
+optimization,Roguelike Permadeath,Treat decisions as irreversible to force careful high-stakes analysis - ideal for critical decisions with no second chances,decision → consequences → execution
+philosophical,Occam's Razor Application,Find the simplest sufficient explanation by eliminating unnecessary complexity - essential for debugging and theory selection,options → simplification → selection
+philosophical,Trolley Problem Variations,Explore ethical trade-offs through moral dilemmas - valuable for understanding values and making difficult ethical decisions,dilemma → analysis → decision
+quantum,Observer Effect Consideration,Analyze how the act of measurement changes what's being measured - important for understanding metrics impact and self-aware systems,unmeasured → observation → impact
+retrospective,Hindsight Reflection,Imagine looking back from the future to gain perspective - powerful for project reviews and extracting wisdom from experience,future view → insights → application
+retrospective,Lessons Learned Extraction,Systematically identify key takeaways and actionable improvements - essential for knowledge transfer and continuous improvement,experience → lessons → actions
+risk,Identify Potential Risks,Brainstorm what could go wrong across all categories - fundamental for project planning and deployment preparation,categories → risks → mitigations
+risk,Challenge from Critical Perspective,Play devil's advocate to stress-test ideas and find weaknesses - essential for overcoming groupthink and building robust solutions,assumptions → challenges → strengthening
+risk,Failure Mode Analysis,Systematically explore how each component could fail - critical for reliability engineering and safety-critical systems,components → failures → prevention
+risk,Pre-mortem Analysis,Imagine future failure then work backwards to prevent it - powerful technique for risk mitigation before major launches,failure scenario → causes → prevention
+scientific,Peer Review Simulation,Apply rigorous academic evaluation standards - ensures quality through methodology review and critical assessment,methodology → analysis → recommendations
+scientific,Reproducibility Check,Verify results can be replicated independently - fundamental for reliability and scientific validity,method → replication → validation
+structural,Dependency Mapping,Visualize interconnections to understand requirements and impacts - essential for complex systems and integration planning,components → dependencies → impacts
+structural,Information Architecture Review,Optimize organization and hierarchy for better user experience - crucial for fixing navigation and findability problems,current → pain points → restructure
+structural,Skeleton of Thought,Create structure first then expand branches in parallel - efficient for generating long content quickly with good organization,skeleton → branches → integration

src/core/tasks/adv-elicit.md

@@ -0,0 +1,109 @@
+<!-- BMAD-CORE™ Advanced Elicitation Task v2.0 (LLM-Native) -->
+
+# Advanced Elicitation v2.0 (LLM-Native)
+
+```xml
+<task id="bmad/core/tasks/adv-elicit.md" name="Advanced Elicitation">
+  <llm critical="true">
+    <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>
+    <i>DO NOT skip steps or change the sequence</i>
+    <i>HALT immediately when halt-conditions are met</i>
+    <i>Each &lt;action&gt; within &lt;step&gt; is a REQUIRED action to complete that step</i>
+    <i>Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution</i>
+  </llm>
+
+  <integration description="When called from workflow">
+    <desc>When called during template workflow processing:</desc>
+    <i>1. Receive the current section content that was just generated</i>
+    <i>2. Apply elicitation methods iteratively to enhance that specific content</i>
+    <i>3. Return the enhanced version back when user selects 'x' to proceed and return back</i>
+    <i>4. The enhanced content replaces the original section content in the output document</i>
+  </integration>
+
+  <flow>
+    <step n="1" title="Method Registry Loading">
+      <action>Load and read {project-root}/core/tasks/adv-elicit-methods.csv</action>
+
+      <csv-structure>
+        <i>category: Method grouping (core, structural, risk, etc.)</i>
+        <i>method_name: Display name for the method</i>
+        <i>description: Rich explanation of what the method does, when to use it, and why it's valuable</i>
+        <i>output_pattern: Flexible flow guide using → arrows (e.g., "analysis → insights → action")</i>
+      </csv-structure>
+
+      <context-analysis>
+        <i>Use conversation history</i>
+        <i>Analyze: content type, complexity, stakeholder needs, risk level, and creative potential</i>
+      </context-analysis>
+
+      <smart-selection>
+        <i>1. Analyze context: Content type, complexity, stakeholder needs, risk level, creative potential</i>
+        <i>2. Parse descriptions: Understand each method's purpose from the rich descriptions in CSV</i>
+        <i>3. Select 5 methods: Choose methods that best match the context based on their descriptions</i>
+        <i>4. Balance approach: Include mix of foundational and specialized techniques as appropriate</i>
+      </smart-selection>
+    </step>
+
+    <step n="2" title="Present Options &amp; Handle Responses">
+
+      <format>
+        **Advanced Elicitation Options**
+        Choose a number (1-5), r to shuffle, or x to proceed:
+
+        1. [Method Name]
+        2. [Method Name]
+        3. [Method Name]
+        4. [Method Name]
+        5. [Method Name]
+        r. Reshuffle the list with 5 new options
+        x. Proceed / No Further Actions
+      </format>
+
+      <response-handling>
+        <case n="1-5">
+          <i>Execute the selected method using its description from the CSV</i>
+          <i>Adapt the method's complexity and output format based on the current context</i>
+          <i>Apply the method creatively to the current section content being enhanced</i>
+          <i>Display the enhanced version showing what the method revealed or improved</i>
+          <i>CRITICAL: Ask the user if they would like to apply the changes to the doc (y/n/other) and HALT to await response.</i>
+          <i>CRITICAL: ONLY if Yes, apply the changes. IF No, discard your memory of the proposed changes. If any other reply, try best to follow the instructions given by the user.</i>
+          <i>CRITICAL: Re-present the same 1-5,r,x prompt to allow additional elicitations</i>
+        </case>
+        <case n="r">
+          <i>Select 5 different methods from adv-elicit-methods.csv, present new list with same prompt format</i>
+        </case>
+        <case n="x">
+          <i>Complete elicitation and proceed</i>
+          <i>Return the fully enhanced content back to create-doc.md</i>
+          <i>The enhanced content becomes the final version for that section</i>
+          <i>Signal completion back to create-doc.md to continue with next section</i>
+        </case>
+        <case n="direct-feedback">
+          <i>Apply changes to current section content and re-present choices</i>
+        </case>
+        <case n="multiple-numbers">
+          <i>Execute methods in sequence on the content, then re-offer choices</i>
+        </case>
+      </response-handling>
+    </step>
+
+    <step n="3" title="Execution Guidelines">
+      <i>Method execution: Use the description from CSV to understand and apply each method</i>
+      <i>Output pattern: Use the pattern as a flexible guide (e.g., "paths → evaluation → selection")</i>
+      <i>Dynamic adaptation: Adjust complexity based on content needs (simple to sophisticated)</i>
+      <i>Creative application: Interpret methods flexibly based on context while maintaining pattern consistency</i>
+      <i>Be concise: Focus on actionable insights</i>
+      <i>Stay relevant: Tie elicitation to specific content being analyzed (the current section from create-doc)</i>
+      <i>Identify personas: For multi-persona methods, clearly identify viewpoints</i>
+      <i>Critical loop behavior: Always re-offer the 1-5,r,x choices after each method execution</i>
+      <i>Continue until user selects 'x' to proceed with enhanced content</i>
+      <i>Each method application builds upon previous enhancements</i>
+      <i>Content preservation: Track all enhancements made during elicitation</i>
+      <i>Iterative enhancement: Each selected method (1-5) should:</i>
+      <i> 1. Apply to the current enhanced version of the content</i>
+      <i> 2. Show the improvements made</i>
+      <i> 3. Return to the prompt for additional elicitations or completion</i>
+    </step>
+  </flow>
+</task>
+```

src/core/tasks/index-docs.md

@@ -0,0 +1,69 @@
+<!-- BMAD-CORE™ Index Documentation Task -->
+
+# Index Docs v1.1
+
+```xml
+<task id="bmad/core/tasks/index-docs" name="Index Docs" webskip="true">
+  <llm critical="true">
+    <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>
+    <i>DO NOT skip steps or change the sequence</i>
+    <i>HALT immediately when halt-conditions are met</i>
+    <i>Each &lt;action&gt; within &lt;step&gt; is a REQUIRED action to complete that step</i>
+    <i>Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution</i>
+  </llm>
+
+  <flow>
+    <step n="1" title="Scan Directory">
+      <i>List all files and subdirectories in the target location</i>
+    </step>
+
+    <step n="2" title="Group Content">
+      <i>Organize files by type, purpose, or subdirectory</i>
+    </step>
+
+    <step n="3" title="Generate Descriptions">
+      <i>Read each file to understand its actual purpose and create brief (3-10 word) descriptions based on the content, not just the filename</i>
+    </step>
+
+    <step n="4" title="Create/Update Index">
+      <i>Write or update index.md with organized file listings</i>
+    </step>
+  </flow>
+
+  <output-format>
+    <example>
+      # Directory Index
+
+      ## Files
+
+      - **[filename.ext](./filename.ext)** - Brief description
+      - **[another-file.ext](./another-file.ext)** - Brief description
+
+      ## Subdirectories
+
+      ### subfolder/
+
+      - **[file1.ext](./subfolder/file1.ext)** - Brief description
+      - **[file2.ext](./subfolder/file2.ext)** - Brief description
+
+      ### another-folder/
+
+      - **[file3.ext](./another-folder/file3.ext)** - Brief description
+    </example>
+  </output-format>
+
+  <halt-conditions critical="true">
+    <i>HALT if target directory does not exist or is inaccessible</i>
+    <i>HALT if user does not have write permissions to create index.md</i>
+  </halt-conditions>
+
+  <validation>
+    <i>Use relative paths starting with ./</i>
+    <i>Group similar files together</i>
+    <i>Read file contents to generate accurate descriptions - don't guess from filenames</i>
+    <i>Keep descriptions concise but informative (3-10 words)</i>
+    <i>Sort alphabetically within groups</i>
+    <i>Skip hidden files (starting with .) unless specified</i>
+  </validation>
+</task>
+```

src/core/tasks/shard-doc.md

@@ -0,0 +1,57 @@
+<!-- BMAD-CORE™ Document Sharding Task -->
+
+# Shard Doc v1.1
+
+```xml
+<task id="bmad/core/tasks/shard-doc.md" name="Shard Doc">
+  <llm critical="true">
+    <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>
+    <i>DO NOT skip steps or change the sequence</i>
+    <i>HALT immediately when halt-conditions are met</i>
+    <i>Each &lt;action&gt; within &lt;step&gt; is a REQUIRED action to complete that step</i>
+    <i>Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution</i>
+  </llm>
+
+  <flow>
+    <step n="1" title="Check for Tool">
+      <i>First check if md-tree command is available</i>
+    </step>
+
+    <step n="2" title="Install if Needed">
+      <i>If not available, ask user permission to install: npm install -g @kayvan/markdown-tree-parser</i>
+    </step>
+
+    <step n="3" title="Shard Document">
+      <i>Use the explode command to split the document</i>
+    </step>
+  </flow>
+
+  <usage>
+    <commands>
+      # Install the tool (if needed)
+      npm install -g @kayvan/markdown-tree-parser
+
+      # Shard a document
+      md-tree explode [source-document] [destination-folder]
+
+      # Examples
+      md-tree explode docs/prd.md docs/prd
+      md-tree explode docs/architecture.md docs/architecture
+    </commands>
+  </usage>
+
+  <halt-conditions critical="true">
+    <i>HALT if md-tree command fails and user declines installation</i>
+    <i>HALT if source document does not exist at specified path</i>
+    <i>HALT if destination folder exists and user does not confirm overwrite</i>
+  </halt-conditions>
+
+  <validation>
+    <title>Error Handling</title>
+    <desc>If the md-tree command fails:</desc>
+    <i>1. Check if the tool is installed globally</i>
+    <i>2. Ask user permission to install it</i>
+    <i>3. Retry the operation after installation</i>
+  </validation>
+</task>
+```

src/core/tasks/validate-workflow.md

@@ -0,0 +1,92 @@
+# Validate Workflow
+
+```xml
+<task id="bmad/core/tasks/validate-workflow.md" name="Validate Workflow Output">
+  <objective>Run a checklist against a document with thorough analysis and produce a validation report</objective>
+
+  <inputs>
+    <input name="workflow" desc="Workflow path containing checklist.md" />
+    <input name="checklist" desc="Checklist to validate against (defaults to workflow's checklist.md)" />
+    <input name="document" desc="Document to validate (ask user if not specified)" />
+  </inputs>
+
+  <flow>
+    <step n="1" title="Setup">
+      <action>If checklist not provided, load checklist.md from workflow location</action>
+      <action>If document not provided, ask user: "Which document should I validate?"</action>
+      <action>Load both the checklist and document</action>
+    </step>
+
+    <step n="2" title="Validate" critical="true">
+      <mandate>For EVERY checklist item, WITHOUT SKIPPING ANY:</mandate>
+
+      <for-each-item>
+        <action>Read requirement carefully</action>
+        <action>Search document for evidence along with any ancillary loaded documents or artifacts (quotes with line numbers)</action>
+        <action>Analyze deeply - look for explicit AND implied coverage</action>
+
+        <mark-as>
+          ✓ PASS - Requirement fully met (provide evidence)
+          ⚠ PARTIAL - Some coverage but incomplete (explain gaps)
+          ✗ FAIL - Not met or severely deficient (explain why)
+          ➖ N/A - Not applicable (explain reason)
+        </mark-as>
+      </for-each-item>
+
+      <critical>DO NOT SKIP ANY SECTIONS OR ITEMS</critical>
+    </step>
+
+    <step n="3" title="Generate Report">
+      <action>Create validation-report-{timestamp}.md in document's folder</action>
+
+      <report-format>
+        # Validation Report
+
+        **Document:** {document-path}
+        **Checklist:** {checklist-path}
+        **Date:** {timestamp}
+
+        ## Summary
+        - Overall: X/Y passed (Z%)
+        - Critical Issues: {count}
+
+        ## Section Results
+
+        ### {Section Name}
+        Pass Rate: X/Y (Z%)
+
+        {For each item:}
+        [MARK] {Item description}
+        Evidence: {Quote with line# or explanation}
+        {If FAIL/PARTIAL: Impact: {why this matters}}
+
+        ## Failed Items
+        {All ✗ items with recommendations}
+
+        ## Partial Items
+        {All ⚠ items with what's missing}
+
+        ## Recommendations
+        1. Must Fix: {critical failures}
+        2. Should Improve: {important gaps}
+        3. Consider: {minor improvements}
+      </report-format>
+    </step>
+
+    <step n="4" title="Summary for User">
+      <action>Present section-by-section summary</action>
+      <action>Highlight all critical issues</action>
+      <action>Provide path to saved report</action>
+      <action>HALT - do not continue unless user asks</action>
+    </step>
+  </flow>
+
+  <critical-rules>
+    <rule>NEVER skip sections - validate EVERYTHING</rule>
+    <rule>ALWAYS provide evidence (quotes + line numbers) for marks</rule>
+    <rule>Think deeply about each requirement - don't rush</rule>
+    <rule>Save report to document's folder automatically</rule>
+    <rule>HALT after presenting summary - wait for user</rule>
+  </critical-rules>
+</task>
+```

src/core/tasks/workflow.md

@@ -0,0 +1,141 @@
+<!-- BMAD Method v6 Workflow Execution Task (Simplified) -->
+
+# Workflow
+
+```xml
+<task id="bmad/core/tasks/workflow.md" name="Execute Workflow">
+  <objective>Execute given workflow by loading its configuration, following instructions, and producing output</objective>
+
+  <llm critical="true">
+    <mandate>Always read COMPLETE files - NEVER use offset/limit when reading any workflow related files</mandate>
+    <mandate>Instructions are MANDATORY - either as file path, steps or embedded list in YAML, XML or markdown</mandate>
+    <mandate>Execute ALL steps in instructions IN EXACT ORDER</mandate>
+    <mandate>Save to template output file after EVERY "template-output" tag</mandate>
+    <mandate>NEVER delegate a step - YOU are responsible for every steps execution</mandate>
+  </llm>
+
+  <WORKFLOW-RULES critical="true">
+    <rule n="1">Steps execute in exact numerical order (1, 2, 3...)</rule>
+    <rule n="2">Optional steps: Ask user unless #yolo mode active</rule>
+    <rule n="3">Template-output tags: Save content → Show user → Get approval before continuing</rule>
+    <rule n="4">Elicit tags: Execute immediately unless #yolo mode (which skips ALL elicitation)</rule>
+    <rule n="5">User must approve each major section before continuing UNLESS #yolo mode active</rule>
+  </WORKFLOW-RULES>
+
+  <flow>
+    <step n="1" title="Load and Initialize Workflow">
+      <substep n="1a" title="Load Configuration and Resolve Variables">
+        <action>Read workflow.yaml from provided path</action>
+        <mandate>Load config_source (REQUIRED for all modules)</mandate>
+        <phase n="1">Load external config from config_source path</phase>
+        <phase n="2">Resolve all {config_source}: references with values from config</phase>
+        <phase n="3">Resolve system variables (date:system-generated) and paths ({project-root}, {installed_path})</phase>
+        <phase n="4">Ask user for input of any variables that are still unknown</phase>
+      </substep>
+
+      <substep n="1b" title="Load Required Components">
+        <mandate>Instructions: Read COMPLETE file from path OR embedded list (REQUIRED)</mandate>
+        <check>If template path → Read COMPLETE template file</check>
+        <check>If validation path → Note path for later loading when needed</check>
+        <check>If template: false → Mark as action-workflow (else template-workflow)</check>
+        <note>Data files (csv, json) → Store paths only, load on-demand when instructions reference them</note>
+      </substep>
+
+      <substep n="1c" title="Initialize Output" if="template-workflow">
+        <action>Resolve default_output_file path with all variables and {{date}}</action>
+        <action>Create output directory if doesn't exist</action>
+        <action>If template-workflow → Write template to output file with placeholders</action>
+        <action>If action-workflow → Skip file creation</action>
+      </substep>
+    </step>
+
+    <step n="2" title="Process Each Instruction Step">
+      <iterate>For each step in instructions:</iterate>
+
+      <substep n="2a" title="Handle Step Attributes">
+        <check>If optional="true" and NOT #yolo → Ask user to include</check>
+        <check>If if="condition" → Evaluate condition</check>
+        <check>If for-each="item" → Repeat step for each item</check>
+        <check>If repeat="n" → Repeat step n times</check>
+      </substep>
+
+      <substep n="2b" title="Execute Step Content">
+        <action>Process step instructions (markdown or XML tags)</action>
+        <action>Replace {{variables}} with values (ask user if unknown)</action>
+        <execute-tags>
+          <tag><action> → Perform the action</tag>
+          <tag><check> → Evaluate condition</tag>
+          <tag><ask> → Prompt user and WAIT for response</tag>
+          <tag><invoke-workflow> → Execute another workflow with given inputs</tag>
+          <tag><invoke-task> → Execute specified task</tag>
+          <tag><goto step="x"> → Jump to specified step</tag>
+        </execute-tags>
+      </substep>
+
+      <substep n="2c" title="Handle Special Output Tags">
+        <if tag="template-output">
+          <mandate>Generate content for this section</mandate>
+          <mandate>Save to file (Write first time, Edit subsequent)</mandate>
+          <action>Show checkpoint separator: ━━━━━━━━━━━━━━━━━━━━━━━</action>
+          <action>Display generated content</action>
+          <ask>Continue [c] or Edit [e]? WAIT for response</ask>
+        </if>
+
+        <if tag="elicit-required">
+          <mandate critical="true">YOU MUST READ the file at {project-root}/bmad/core/tasks/adv-elicit.md using Read tool BEFORE presenting any elicitation menu</mandate>
+          <action>Load and run task {project-root}/bmad/core/tasks/adv-elicit.md with current context</action>
+          <action>Show elicitation menu 5 relevant options (list 1-5 options, Continue [c] or Reshuffle [r])</action>
+          <mandate>HALT and WAIT for user selection</mandate>
+        </if>
+      </substep>
+
+      <substep n="2d" title="Step Completion">
+        <check>If no special tags and NOT #yolo:</check>
+        <ask>Continue to next step? (y/n/edit)</ask>
+      </substep>
+    </step>
+
+    <step n="3" title="Completion">
+      <check>If checklist exists → Run validation</check>
+      <check>If template: false → Confirm actions completed</check>
+      <check>Else → Confirm document saved to output path</check>
+      <action>Report workflow completion</action>
+    </step>
+  </flow>
+
+  <execution-modes>
+    <mode name="normal">Full user interaction at all decision points</mode>
+    <mode name="#yolo">Skip optional sections, skip all elicitation, minimize prompts</mode>
+  </execution-modes>
+
+  <supported-tags desc="Instructions can use these tags">
+    <structural>
+      <tag>step n="X" goal="..." - Define step with number and goal</tag>
+      <tag>optional="true" - Step can be skipped</tag>
+      <tag>if="condition" - Conditional execution</tag>
+      <tag>for-each="collection" - Iterate over items</tag>
+      <tag>repeat="n" - Repeat n times</tag>
+    </structural>
+    <execution>
+      <tag>action - Required action to perform</tag>
+      <tag>check - Condition to evaluate</tag>
+      <tag>ask - Get user input (wait for response)</tag>
+      <tag>goto - Jump to another step</tag>
+      <tag>invoke-workflow - Call another workflow</tag>
+      <tag>invoke-task - Call a task</tag>
+    </execution>
+    <output>
+      <tag>template-output - Save content checkpoint</tag>
+      <tag>elicit-required - Trigger enhancement</tag>
+      <tag>critical - Cannot be skipped</tag>
+      <tag>example - Show example output</tag>
+    </output>
+  </supported-tags>
+
+  <llm final="true">
+    <mandate>This is the complete workflow execution engine</mandate>
+    <mandate>You MUST Follow instructions exactly as written and maintain conversation context between steps</mandate>
+    <mandate>If confused, re-read this task, the workflow yaml, and any yaml indicated files</mandate>
+  </llm>
+</task>
+```

src/core/workflows/bmad-init/instructions.md

@@ -0,0 +1,79 @@
+# BMAD Init - System Initialization Instructions
+
+<workflow>
+
+<step n="1" goal="Welcome and Status Check">
+  <action>Display welcome banner with BMAD branding</action>
+  <action>Check for BMAD installation at {project-root}/bmad</action>
+  <check>If installation found:</check>
+    <action>Display current version from {project-root}/bmad/_cfg/manifest.yaml</action>
+    <action>Show installation date and status</action>
+  <check>If not found:</check>
+    <action>Display warning that BMAD is not installed</action>
+    <action>Suggest running the installer first</action>
+    <action>Exit workflow</action>
+  <action>Display formatted status summary:
+    ╔════════════════════════════════════════╗
+    ║         BMAD INITIALIZATION            ║
+    ╚════════════════════════════════════════╝
+
+    Status: [Installed/Not Found]
+    Location: {project-root}/bmad
+    Version: [from manifest]
+    Installed: [date from manifest]
+
+  </action>
+</step>
+
+<step n="2" goal="Present Initialization Options">
+  <action>Display available initialization and maintenance tasks</action>
+  <ask>Select an initialization task:
+
+    1. Customize Installed Agents and Agent Party (Coming Soon)
+       - Assign new names and personas to agents
+       - Create runtime agent variants
+       - NOTE: This can all be done manually, but doing it through here will be easier and also update the party-mode manifest
+
+    2. Verify Installation (Coming Soon)
+       - Check all files are properly installed
+       - Validate configurations
+
+    3. Exit
+
+    Please select an option (1-3).
+
+  </ask>
+</step>
+
+<step n="3" goal="Process User Selection">
+  <check>If user selected "1":</check>
+    <action>Display message: ⚠️ Installed Agent Auto Customization is coming soon.</action>
+    <<action>Return to step 2</action>
+
+<check>If user selected "2":</check>
+<action>Display message: ⚠️ Installation verification is coming soon.</action>
+<action>Return to step 2</action>
+
+<check>If user selected "3":</check>
+<action>Display message: Exiting BMAD Init. Thank you!</action>
+<goto step="5">Exit workflow</goto>
+</step>
+
+<step n="4" goal="Post-Task Options">
+  <action>Display completion status of the executed task</action>
+  <ask>Task completed successfully!
+
+Would you like to perform another initialization task? (y/n):</ask>
+<check>If user responds "y":</check>
+<goto step="2">Return to menu</goto>
+<check>If user responds "n":</check>
+<goto step="5">Exit workflow</goto>
+</step>
+
+<step n="5" goal="Exit Workflow">
+  <action>Display farewell message</action>
+  <action>Suggest user start a new context or clear context if needed</action>
+  <action>Exit workflow</action>
+</step>
+
+</workflow>

src/core/workflows/bmad-init/workflow.yaml

@@ -0,0 +1,24 @@
+# BMAD Init - System Initialization Workflow
+name: "bmad-init"
+description: "BMAD system initialization and maintenance workflow for agent manifest generation and system configuration"
+author: "BMad"
+
+# Critical variables
+config_source: "{project-root}/bmad/_cfg/manifest.yaml"
+date: system-generated
+
+# This is an action workflow - no template output
+template: false
+instructions: "{project-root}/src/core/workflows/bmad-init/instructions.md"
+
+# Sub-components
+party_update_instructions: "{project-root}/src/core/workflows/bmad-init/party-update/instructions.md"
+
+# No specific output file - this workflow performs various system actions
+default_output_file: null
+
+# Required tools for execution
+required_tools:
+  - file_operations
+  - llm_analysis
+  - xml_generation

src/core/workflows/party-mode/instructions.md

@@ -0,0 +1,181 @@
+# Party Mode - Multi-Agent Discussion Instructions
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>This workflow orchestrates group discussions between all installed BMAD agents</critical>
+
+<workflow>
+
+<step n="1" goal="Load Agent Manifest and Configurations">
+  <action>Load the agent manifest from {{manifest}}</action>
+  <action>Parse XML to extract all agent entries with their condensed information:</action>
+    - id (file path)
+    - name
+    - title
+    - role (single sentence with capabilities)
+    - style (communication style)
+    - principles
+    - memories (if present)
+    - collaborators (key collaborators if any)
+
+<action>For each agent found in manifest:</action>
+<check>Look for config override at {{agent_configs}}[module]-[agent-name].md</check>
+<check>If config override exists:</check>
+<action>Load the override configuration</action>
+<action>MERGE override data with manifest data (overrides take precedence):</action> - Override role replaces manifest role if present - Override style replaces manifest style if present - Override principles replace manifest principles if present - Override memories replace or append to manifest memories - Any additional persona elements from override are added
+
+<action>Build complete agent roster with merged personalities</action>
+<action>Store agent data for use in conversation orchestration</action>
+</step>
+
+<step n="2" goal="Initialize Party Mode">
+  <action>Announce party mode activation with enthusiasm</action>
+  <action>List all participating agents with their merged information:</action>
+  <format>
+    🎉 PARTY MODE ACTIVATED! 🎉
+    All agents are here for a group discussion!
+
+    Participating agents:
+    [For each agent in roster:]
+    - [Agent Name] ([Title]): [Role from merged data]
+
+    [Total count] agents ready to collaborate!
+
+    What would you like to discuss with the team?
+
+  </format>
+  <action>Wait for user to provide initial topic or question</action>
+</step>
+
+<step n="3" goal="Orchestrate Multi-Agent Discussion" repeat="until-exit">
+  <action>For each user message or topic:</action>
+
+  <substep n="3a" goal="Determine Relevant Agents">
+    <action>Analyze the user's message/question</action>
+    <action>Identify which agents would naturally respond based on:</action>
+      - Their role and capabilities (from merged data)
+      - Their stated principles
+      - Their memories/context if relevant
+      - Their collaboration patterns
+    <action>Select 2-3 most relevant agents for this response</action>
+    <note>If user addresses specific agent by name, prioritize that agent</note>
+  </substep>
+
+  <substep n="3b" goal="Generate In-Character Responses">
+    <action>For each selected agent, generate authentic response:</action>
+    <action>Use the agent's merged personality data:</action>
+      - Apply their communication style exactly
+      - Reflect their principles in reasoning
+      - Reference their memories if contextually relevant
+      - Maintain their unique voice and perspective
+
+    <action>Enable natural cross-talk between agents:</action>
+      - Agents can reference each other by name
+      - Agents can build on previous points
+      - Agents can respectfully disagree or offer alternatives
+      - Agents can ask follow-up questions to each other
+
+  </substep>
+
+  <substep n="3c" goal="Handle Questions and Interactions">
+    <check>If an agent asks the user a direct question:</check>
+      <action>Clearly highlight the question</action>
+      <action>End that round of responses</action>
+      <action>Display: "[Agent Name]: [Their question]"</action>
+      <action>Display: "[Awaiting user response...]"</action>
+      <action>WAIT for user input before continuing</action>
+
+    <check>If agents ask each other questions:</check>
+      <action>Allow natural back-and-forth in the same response round</action>
+      <action>Maintain conversational flow</action>
+
+    <check>If discussion becomes circular or repetitive:</check>
+      <action>The BMad Master will summarize</action>
+      <action>Redirect to new aspects or ask for user guidance</action>
+
+  </substep>
+
+  <substep n="3d" goal="Format and Present Responses">
+    <action>Present each agent's contribution clearly:</action>
+    <format>
+      [Agent Name]: [Their response in their voice/style]
+
+      [Another Agent]: [Their response, potentially referencing the first]
+
+      [Third Agent if selected]: [Their contribution]
+    </format>
+
+    <action>Maintain spacing between agents for readability</action>
+    <action>Preserve each agent's unique voice throughout</action>
+
+  </substep>
+
+  <substep n="3e" goal="Check for Exit Conditions">
+    <check>If user message contains any {{exit_triggers}}:</check>
+      <action>Have agents provide brief farewells in character</action>
+      <action>Thank user for the discussion</action>
+      <goto step="4">Exit party mode</goto>
+
+    <check>If user seems done or conversation naturally concludes:</check>
+      <ask>Would you like to continue the discussion or end party mode?</ask>
+      <check>If user indicates end:</check>
+        <goto step="4">Exit party mode</goto>
+
+  </substep>
+</step>
+
+<step n="4" goal="Exit Party Mode">
+  <action>Have 2-3 agents provide characteristic farewells to the user, and 1-2 to each other</action>
+  <format>
+    [Agent 1]: [Brief farewell in their style]
+
+    [Agent 2]: [Their goodbye]
+
+    🎊 Party Mode ended. Thanks for the great discussion!
+
+  </format>
+  <action>Exit workflow</action>
+</step>
+
+</workflow>
+
+## Role-Playing Guidelines
+
+<guidelines>
+  <guideline>Keep all responses strictly in-character based on merged personality data</guideline>
+  <guideline>Use each agent's documented communication style consistently</guideline>
+  <guideline>Reference agent memories and context when relevant</guideline>
+  <guideline>Allow natural disagreements and different perspectives</guideline>
+  <guideline>Maintain professional discourse while being engaging</guideline>
+  <guideline>Let agents reference each other naturally by name or role</guideline>
+  <guideline>Include personality-driven quirks and occasional humor</guideline>
+  <guideline>Respect each agent's expertise boundaries</guideline>
+</guidelines>
+
+## Question Handling Protocol
+
+<question-protocol>
+  <direct-to-user>
+    When agent asks user a specific question (e.g., "What's your budget?"):
+    - End that round immediately after the question
+    - Clearly highlight the questioning agent and their question
+    - Wait for user response before any agent continues
+  </direct-to-user>
+
+  <rhetorical>
+    Agents can ask rhetorical or thinking-aloud questions without pausing
+  </rhetorical>
+
+  <inter-agent>
+    Agents can question each other and respond naturally within same round
+  </inter-agent>
+</question-protocol>
+
+## Moderation Notes
+
+<moderation>
+  <note>If discussion becomes circular, have bmad-master summarize and redirect</note>
+  <note>If user asks for specific agent, let that agent take primary lead</note>
+  <note>Balance fun and productivity based on conversation tone</note>
+  <note>Ensure all agents stay true to their merged personalities</note>
+  <note>Exit gracefully when user indicates completion</note>
+</moderation>

src/core/workflows/party-mode/workflow.yaml

@@ -0,0 +1,24 @@
+# Party Mode - Multi-Agent Group Discussion Workflow
+name: "party-mode"
+description: "Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations"
+author: "BMad"
+
+# Critical data sources - manifest and config overrides
+manifest: "{project-root}/bmad/_cfg/agent-party.xml"
+agent_configs: "{project-root}/bmad/_cfg/agents/"
+date: system-generated
+
+# This is an interactive action workflow - no template output
+template: false
+instructions: "{project-root}/src/core/workflows/party-mode/instructions.md"
+
+# Data files to be loaded at runtime
+data_files:
+  - agent_manifest: "{project-root}/bmad/_cfg/agent-party.xml"
+  - agent_overrides: "{project-root}/bmad/_cfg/agents/*.md"
+
+# Exit conditions
+exit_triggers:
+  - "*exit"
+  - "end party mode"
+  - "stop party mode"

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

@@ -0,0 +1,16 @@
+# 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
+
+prompt: "Happy Building - Build the Modules, Workflows and Agents of your dreams."
+# Variables from Core Config inserted:
+## user_name
+## communication_language
+## output_folder
+
+src_impact:
+  prompt: "Are you installing this module to your local Forked BMad Core repository? (not a separate project which is normally the case)"
+  default: false
+  result: "{value}"

src/modules/bmb/agents/bmad-builder.md

@@ -0,0 +1,30 @@
+<!-- Powered by BMAD-CORE™ -->
+
+# BMad Master Task Executor
+
+<agent id="bmad/bmb/agents/bmad-builder.md" name="BMad Builder" title="BMad Builder" icon="🧙">
+  <persona>
+    <role>Master BMad Module Agent Team and Workflow Builder and Maintainer</role>
+    <identity>Lives to serve the expansion of the BMad Method</identity>
+    <communication_style>Talks like a pulp super hero</communication_style>
+    <principles>
+      <p>Execute resources directly</p>
+      <p>Load resources at runtime never pre-load</p>
+      <p>Always present numbered lists for choices</p>
+    </principles>
+  </persona>
+  <critical-actions>
+    <i>Load into memory {project-root}/bmad/bmb/config.yaml and set variable output_folder, user_name, communication_language</i>
+    <i>Remember the users name is {user_name}</i>
+    <i>ALWAYS communicate in {communication_language}</i>
+  </critical-actions>
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+    <c cmd="convert" run-workflow="{project-root}/bmad/bmb/workflows/convert-legacy/workflow.yaml">Convert v4 or any other style task agent or template to a workflow</c>
+    <c cmd="*create-agent" run-workflow="{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml">Create a new BMAD Core compliant agent</c>
+    <c cmd="*create-module" run-workflow="{project-root}/bmad/bmb/workflows/create-module/workflow.yaml">Create a complete BMAD module (brainstorm → brief → build with agents and workflows)</c>
+    <c cmd="*create-workflow" run-workflow="{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml">Create a new BMAD Core workflow with proper structure</c>
+    <c cmd="*edit-workflow" run-workflow="{project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml">Edit existing workflows while following best practices</c>
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>

src/modules/bmb/workflows/convert-legacy/README.md

@@ -0,0 +1,262 @@
+# Convert Legacy Workflow
+
+## Overview
+
+The Convert Legacy workflow is a comprehensive migration tool that converts BMAD v4 items (agents, workflows, modules) to v5 compliant format with proper structure and conventions. It bridges the gap between legacy BMAD implementations and the modern v5 architecture, ensuring seamless migration while preserving functionality and improving structure.
+
+## Key Features
+
+- **Multi-Format Detection** - Automatically identifies v4 agents, workflows, tasks, templates, and modules
+- **Intelligent Conversion** - Smart mapping from v4 patterns to v5 equivalents with structural improvements
+- **Sub-Workflow Integration** - Leverages build-agent, build-workflow, and build-module workflows for quality output
+- **Structure Modernization** - Converts YAML-based agents to XML, templates to workflows, tasks to structured workflows
+- **Path Normalization** - Updates all references to use proper v5 path conventions
+- **Validation System** - Comprehensive validation of converted items before finalization
+- **Migration Reporting** - Detailed conversion reports with locations and manual adjustment notes
+
+## Usage
+
+### Basic Invocation
+
+```bash
+workflow convert-legacy
+```
+
+### With Legacy File Input
+
+```bash
+# Convert a specific v4 item
+workflow convert-legacy --input /path/to/legacy-agent.md
+```
+
+### With Legacy Module
+
+```bash
+# Convert an entire v4 module structure
+workflow convert-legacy --input /path/to/legacy-module/
+```
+
+### Configuration
+
+The workflow uses standard BMB configuration:
+
+- **output_folder**: Where converted items will be placed
+- **user_name**: Author information for converted items
+- **conversion_mappings**: v4-to-v5 pattern mappings (optional)
+
+## Workflow Structure
+
+### Files Included
+
+```
+convert-legacy/
+├── workflow.yaml           # Configuration and metadata
+├── instructions.md         # Step-by-step conversion guide
+├── checklist.md           # Validation criteria
+└── README.md              # This file
+```
+
+## Workflow Process
+
+### Phase 1: Legacy Analysis (Steps 1-3)
+
+**Item Identification & Loading**
+
+- Accepts file path or directory from user
+- Loads complete file/folder structure for analysis
+- Automatically detects item type based on content patterns:
+  - **Agents**: Contains `<agent>` or `<prompt>` XML tags
+  - **Workflows**: Contains workflow YAML or instruction patterns
+  - **Modules**: Contains multiple organized agents/workflows
+  - **Tasks**: Contains `<task>` XML tags
+  - **Templates**: Contains YAML-based document generators
+
+**Legacy Structure Analysis**
+
+- Parses v4 structure and extracts key components
+- Maps v4 agent metadata (name, id, title, icon, persona)
+- Analyzes v4 template sections and elicitation patterns
+- Identifies task workflows and decision trees
+- Catalogs dependencies and file references
+
+**Target Module Selection**
+
+- Prompts for target module (bmm, bmb, cis, custom)
+- Determines proper installation paths using v5 conventions
+- Shows target location for user confirmation
+- Ensures all paths use `{project-root}/bmad/` format
+
+### Phase 2: Conversion Strategy (Step 4)
+
+**Strategy Selection Based on Item Type**
+
+- **Simple Agents**: Direct XML conversion with metadata mapping
+- **Complex Agents**: Workflow-assisted creation using build-agent
+- **Templates**: Template-to-workflow conversion with proper structure
+- **Tasks**: Task-to-workflow conversion with step mapping
+- **Modules**: Full module creation using build-module workflow
+
+**Workflow Type Determination**
+
+- Analyzes legacy items to determine v5 workflow type:
+  - **Document Workflow**: Generates documents with templates
+  - **Action Workflow**: Performs actions without output documents
+  - **Interactive Workflow**: Guides user interaction sessions
+  - **Meta-Workflow**: Coordinates other workflows
+
+### Phase 3: Conversion Execution (Steps 5a-5e)
+
+**Direct Agent Conversion (5a)**
+
+- Transforms v4 YAML agent format to v5 XML structure
+- Maps persona blocks (role, style, identity, principles)
+- Converts commands list to v5 `<cmds>` format
+- Updates task references to workflow invocations
+- Normalizes all paths to v5 conventions
+
+**Workflow-Assisted Creation (5b-5e)**
+
+- Extracts key information from legacy items
+- Invokes appropriate sub-workflows:
+  - `build-agent` for complex agent creation
+  - `build-workflow` for template/task conversion
+  - `build-module` for full module migration
+- Ensures proper v5 structure and conventions
+
+**Template-to-Workflow Conversion (5c)**
+
+- Converts YAML template sections to workflow steps
+- Maps `elicit: true` flags to `<elicit-required/>` tags
+- Transforms conditional sections to flow control
+- Creates proper template.md from content structure
+- Integrates v4 create-doc.md task patterns
+
+**Task-to-Workflow Conversion (5e)**
+
+- Analyzes task purpose to determine workflow type
+- Extracts step-by-step instructions to workflow steps
+- Converts decision trees to flow control tags
+- Maps 1-9 elicitation menus to v5 elicitation patterns
+- Preserves execution logic and critical notices
+
+### Phase 4: Validation & Finalization (Steps 6-8)
+
+**Comprehensive Validation**
+
+- Validates XML structure for agents
+- Checks YAML syntax for workflows
+- Verifies template variable consistency
+- Ensures proper file structure and naming
+
+**Migration Reporting**
+
+- Generates detailed conversion report
+- Documents original and new locations
+- Notes manual adjustments needed
+- Provides warnings and recommendations
+
+**Cleanup & Archival**
+
+- Optional archival of original v4 files
+- Final location confirmation
+- Post-conversion instructions and next steps
+
+## Output
+
+### Generated Files
+
+- **Converted Items**: Proper v5 format in target module locations
+- **Migration Report**: Detailed conversion documentation
+- **Validation Results**: Quality assurance confirmation
+
+### Output Structure
+
+Converted items follow v5 conventions:
+
+1. **Agents** - XML format with proper persona and command structure
+2. **Workflows** - Complete workflow folders with yaml, instructions, and templates
+3. **Modules** - Full module structure with installation infrastructure
+4. **Documentation** - Updated paths, references, and metadata
+
+## Requirements
+
+- **Legacy v4 Items** - Source files or directories to convert
+- **Target Module Access** - Write permissions to target module directories
+- **Sub-Workflow Availability** - build-agent, build-workflow, build-module workflows accessible
+- **Conversion Mappings** (optional) - v4-to-v5 pattern mappings for complex conversions
+
+## Best Practices
+
+### Before Starting
+
+1. **Backup Legacy Items** - Create copies of original v4 files before conversion
+2. **Review Target Module** - Understand target module structure and conventions
+3. **Plan Module Organization** - Decide where converted items should logically fit
+
+### During Execution
+
+1. **Validate Item Type Detection** - Confirm automatic detection or correct manually
+2. **Choose Appropriate Strategy** - Use workflow-assisted creation for complex items
+3. **Review Path Mappings** - Ensure all references use proper v5 path conventions
+4. **Test Incrementally** - Convert simple items first to validate process
+
+### After Completion
+
+1. **Validate Converted Items** - Test agents and workflows for proper functionality
+2. **Review Migration Report** - Address any manual adjustments noted
+3. **Update Documentation** - Ensure README and documentation reflect changes
+4. **Archive Originals** - Store v4 files safely for reference if needed
+
+## Troubleshooting
+
+### Common Issues
+
+**Issue**: Item type detection fails or incorrect
+
+- **Solution**: Manually specify item type when prompted
+- **Check**: Verify file structure matches expected v4 patterns
+
+**Issue**: Path conversion errors
+
+- **Solution**: Ensure all references use `{project-root}/bmad/` format
+- **Check**: Review conversion mappings for proper path patterns
+
+**Issue**: Sub-workflow invocation fails
+
+- **Solution**: Verify build workflows are available and accessible
+- **Check**: Ensure target module exists and has proper permissions
+
+**Issue**: XML or YAML syntax errors in output
+
+- **Solution**: Review conversion mappings and adjust patterns
+- **Check**: Validate converted files with appropriate parsers
+
+## Customization
+
+To customize this workflow:
+
+1. **Update Conversion Mappings** - Modify v4-to-v5 pattern mappings in data/
+2. **Extend Detection Logic** - Add new item type detection patterns
+3. **Add Conversion Strategies** - Implement specialized conversion approaches
+4. **Enhance Validation** - Add additional quality checks in validation step
+
+## Version History
+
+- **v1.0.0** - Initial release
+  - Multi-format v4 item detection and conversion
+  - Integration with build-agent, build-workflow, build-module
+  - Comprehensive path normalization
+  - Migration reporting and validation
+
+## Support
+
+For issues or questions:
+
+- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md`
+- Check conversion mappings at `/bmad/bmb/data/v4-to-v5-mappings.yaml`
+- Validate output using `checklist.md`
+- Consult BMAD v5 documentation for proper conventions
+
+---
+
+_Part of the BMad Method v5 - BMB (Builder) Module_

src/modules/bmb/workflows/convert-legacy/checklist.md

@@ -0,0 +1,204 @@
+# Convert Legacy - Validation Checklist
+
+## Pre-Conversion Validation
+
+### Source Analysis
+
+- [ ] Original v4 file(s) fully loaded and parsed
+- [ ] Item type correctly identified (agent/template/task/module)
+- [ ] All dependencies documented and accounted for
+- [ ] No critical content overlooked in source files
+
+## Conversion Completeness
+
+### For Agent Conversions
+
+#### Content Preservation
+
+- [ ] Agent name, id, title, and icon transferred
+- [ ] All persona elements mapped to v5 structure
+- [ ] All commands converted to v5 <cmds> format
+- [ ] Dependencies properly referenced or converted
+- [ ] Activation instructions adapted to v5 patterns
+
+#### v5 Compliance
+
+- [ ] Valid XML structure with proper nesting
+- [ ] <agent> tag has all required attributes (id, name, title, icon)
+- [ ] NO <activation> section included (auto-inserted from agent-activation-ide.xml)
+- [ ] <cmds> section uses proper handlers (run-workflow, action, exec, tmpl, data)
+- [ ] <critical-actions> loads config.yaml when needed
+- [ ] Persona sections (<role>, <identity>, <communication_style>, <principles>) are present
+
+#### Best Practices
+
+- [ ] Commands use appropriate workflow references instead of direct task calls
+- [ ] File paths use {project-root} variables
+- [ ] Config values use {config_source}: pattern
+- [ ] Agent follows naming conventions (kebab-case for files)
+- [ ] ALL paths reference {project-root}/bmad/{{module}}/ locations, NOT src/
+- [ ] exec, data, run-workflow commands point to final BMAD installation paths
+
+### For Template/Workflow Conversions
+
+#### Content Preservation
+
+- [ ] Template metadata (name, description, output) transferred
+- [ ] All sections converted to workflow steps
+- [ ] Section hierarchy maintained in instructions
+- [ ] Variables ({{var}}) preserved in template.md
+- [ ] Elicitation points (elicit: true) converted to <elicit-required/>
+- [ ] Conditional sections preserved with if="" attributes
+- [ ] Repeatable sections converted to repeat="" attributes
+
+#### v5 Compliance
+
+- [ ] workflow.yaml follows structure from workflow-creation-guide.md
+- [ ] instructions.md has critical headers referencing workflow engine
+- [ ] Steps numbered sequentially with clear goals
+- [ ] Template variables match between instructions and template.md
+- [ ] Proper use of XML tags (<action>, <check>, <ask>, <template-output>)
+- [ ] File structure follows v5 pattern (folder with yaml/md files)
+
+#### Best Practices
+
+- [ ] Steps are focused with single goals
+- [ ] Instructions are specific ("Write 1-2 paragraphs" not "Write about")
+- [ ] Examples provided where helpful
+- [ ] Limits set where appropriate ("3-5 items maximum")
+- [ ] Save checkpoints with <template-output> at logical points
+- [ ] Variables use descriptive snake_case names
+
+### For Task Conversions
+
+#### Content Preservation
+
+- [ ] Task logic fully captured in workflow instructions
+- [ ] Execution flow maintained
+- [ ] User interaction points preserved
+- [ ] Decision trees converted to workflow logic
+- [ ] All processing steps accounted for
+- [ ] Document generation patterns identified and preserved
+
+#### Type Determination
+
+- [ ] Workflow type correctly identified (document/action/interactive/meta)
+- [ ] If generates documents, template.md created
+- [ ] If performs actions only, marked as action workflow
+- [ ] Output patterns properly analyzed
+
+#### v5 Compliance
+
+- [ ] Converted to proper workflow format (not standalone task)
+- [ ] Follows workflow execution engine patterns
+- [ ] Interactive elements use proper v5 tags
+- [ ] Flow control uses v5 patterns (goto, check, loop)
+- [ ] 1-9 elicitation menus converted to v5 elicitation
+- [ ] Critical notices preserved in workflow.yaml
+- [ ] YOLO mode converted to appropriate v5 patterns
+
+### Module-Level Validation
+
+#### Structure
+
+- [ ] Module follows v5 directory structure
+- [ ] All components in correct locations:
+  - Agents in /agents/
+  - Workflows in /workflows/
+  - Data files in appropriate locations
+- [ ] Config files properly formatted
+
+#### Integration
+
+- [ ] Cross-references between components work
+- [ ] Workflow invocations use correct paths
+- [ ] Data file references are valid
+- [ ] No broken dependencies
+
+## Technical Validation
+
+### Syntax and Format
+
+- [ ] YAML files have valid syntax (no parsing errors)
+- [ ] XML structures properly formed and closed
+- [ ] Markdown files render correctly
+- [ ] File encoding is UTF-8
+- [ ] Line endings consistent (LF)
+
+### Path Resolution
+
+- [ ] All file paths resolve correctly
+- [ ] Variable substitutions work ({project-root}, {installed_path}, etc.)
+- [ ] Config references load properly
+- [ ] No hardcoded absolute paths (unless intentional)
+
+## Functional Validation
+
+### Execution Testing
+
+- [ ] Converted item can be loaded without errors
+- [ ] Agents activate properly when invoked
+- [ ] Workflows execute through completion
+- [ ] User interaction points function correctly
+- [ ] Output generation works as expected
+
+### Behavioral Validation
+
+- [ ] Converted item behaves similarly to v4 version
+- [ ] Core functionality preserved
+- [ ] User experience maintains or improves
+- [ ] No functionality regression
+
+## Documentation and Cleanup
+
+### Documentation
+
+- [ ] Conversion report generated with all changes
+- [ ] Any manual adjustments documented
+- [ ] Known limitations or differences noted
+- [ ] Migration instructions provided if needed
+
+### Post-Conversion
+
+- [ ] Original v4 files archived (if requested)
+- [ ] File permissions set correctly
+- [ ] Git tracking updated if applicable
+- [ ] User informed of new locations
+
+## Final Verification
+
+### Quality Assurance
+
+- [ ] Converted item follows ALL v5 best practices
+- [ ] Code/config is clean and maintainable
+- [ ] No TODO or FIXME items remain
+- [ ] Ready for production use
+
+### User Acceptance
+
+- [ ] User reviewed conversion output
+- [ ] User tested basic functionality
+- [ ] User approved final result
+- [ ] Any user feedback incorporated
+
+## Notes Section
+
+### Conversion Issues Found:
+
+_List any issues encountered during validation_
+
+### Manual Interventions Required:
+
+_Document any manual fixes needed_
+
+### Recommendations:
+
+_Suggestions for further improvements or considerations_
+
+---
+
+**Validation Result:** [ ] PASSED / [ ] FAILED
+
+**Validator:** {{user_name}}
+**Date:** {{date}}
+**Items Converted:** {{conversion_summary}}

src/modules/bmb/workflows/convert-legacy/instructions.md

@@ -0,0 +1,328 @@
+# Convert Legacy - v4 to v5 Conversion Instructions
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/convert-legacy/workflow.yaml</critical>
+
+<workflow>
+
+<step n="1" goal="Identify and Load Legacy Item">
+<action>Ask user for the path to the v4 item to convert (agent, workflow, or module)</action>
+<action>Load the complete file/folder structure</action>
+<action>Detect item type based on structure and content patterns:</action>
+  - Agent: Contains `<agent>` or `<prompt>` XML tags, single file
+  - Workflow: Contains workflow YAML or instruction patterns, usually folder
+  - Module: Contains multiple agents/workflows in organized structure
+  - Task: Contains `<task>` XML tags
+<ask>Confirm detected type or allow user to correct: "Detected as [type]. Is this correct? (y/n)"</ask>
+</step>
+
+<step n="2" goal="Analyze Legacy Structure">
+<action>Parse the v4 structure and extract key components:</action>
+
+For v4 Agents (YAML-based in markdown):
+
+- Agent metadata (name, id, title, icon, whenToUse)
+- Persona block (role, style, identity, focus, core_principles)
+- Commands list with task/template references
+- Dependencies (tasks, templates, checklists, data files)
+- Activation instructions and workflow rules
+- IDE file resolution patterns
+
+For v4 Templates (YAML-based document generators):
+
+- Template metadata (id, name, version, output)
+- Workflow mode and elicitation settings
+- Sections hierarchy with:
+  - Instructions for content generation
+  - Elicit flags for user interaction
+  - Templates with {{variables}}
+  - Conditional sections
+  - Repeatable sections
+
+For v4 Tasks (Markdown with execution instructions):
+
+- Critical execution notices
+- Step-by-step workflows
+- Elicitation requirements (1-9 menu format)
+- Processing flows and decision trees
+- Agent permission rules
+
+For Modules:
+
+- Module metadata
+- Component list (agents, workflows, tasks)
+- Dependencies
+- Installation requirements
+
+<action>Create a conversion map of what needs to be transformed</action>
+<action>Map v4 patterns to v5 equivalents:
+
+- v4 Task + Template → v5 Workflow (folder with workflow.yaml, instructions.md, template.md)
+- v4 Agent YAML → v5 Agent XML format
+- v4 Commands → v5 <cmds> with proper handlers
+- v4 Dependencies → v5 workflow references or data files
+  </action>
+  </step>
+
+<step n="3" goal="Determine Target Module and Location">
+<ask>Which module should this belong to? (eg. bmm, bmb, cis, bmm-legacy, or custom)</ask>
+<check>If custom module:</check>
+  <ask>Enter custom module code (kebab-case):</ask>
+<action>Determine installation path based on type and module</action>
+<critical>IMPORTANT: All paths must use final BMAD installation locations, not src paths!</critical>
+<action>Show user the target location: {project-root}/bmad/{{target_module}}/{{item_type}}/{{item_name}}</action>
+<action>Note: Files will be created in bmad/ but all internal paths will reference {project-root}/bmad/ locations</action>
+<ask>Proceed with this location? (y/n)</ask>
+</step>
+
+<step n="4" goal="Choose Conversion Strategy">
+<action>Based on item type and complexity, choose approach:</action>
+
+<check>If agent conversion:</check>
+<check>If simple agent (basic persona + commands):</check>
+<action>Use direct conversion to v5 agent XML format</action>
+<goto step="5a">Direct Agent Conversion</goto>
+<check>If complex agent with embedded workflows:</check>
+<action>Plan to invoke create-agent workflow</action>
+<goto step="5b">Workflow-Assisted Agent Creation</goto>
+
+<check>If template or task conversion to workflow:</check>
+<action>Analyze the v4 item to determine workflow type:</action>
+
+- Does it generate a specific document type? → Document workflow
+- Does it produce structured output files? → Document workflow
+- Does it perform actions without output? → Action workflow
+- Does it coordinate other tasks? → Meta-workflow
+- Does it guide user interaction? → Interactive workflow
+
+<ask>Based on analysis, this appears to be a {{detected_workflow_type}} workflow. Confirm or correct:
+
+1. Document workflow (generates documents with template)
+2. Action workflow (performs actions, no template)
+3. Interactive workflow (guided session)
+4. Meta-workflow (coordinates other workflows)
+   Select 1-4:</ask>
+
+<check>If template conversion:</check>
+<goto step="5c">Template-to-Workflow Conversion</goto>
+<check>If task conversion:</check>
+<goto step="5e">Task-to-Workflow Conversion</goto>
+
+<check>If full module conversion:</check>
+<action>Plan to invoke create-module workflow</action>
+<goto step="5d">Module Creation</goto>
+</step>
+
+<step n="5a" goal="Direct Agent Conversion" optional="true">
+<action>Transform v4 YAML agent to v5 XML format:</action>
+
+1. Convert agent metadata:
+   - v4 `agent.name` → v5 `<agent name="">`
+   - v4 `agent.id` → v5 `<agent id="">`
+   - v4 `agent.title` → v5 `<agent title="">`
+   - v4 `agent.icon` → v5 `<agent icon="">`
+
+2. Transform persona:
+   - v4 `persona.role` → v5 `<role>`
+   - v4 `persona.style` → v5 `<communication_style>`
+   - v4 `persona.identity` → v5 `<identity>`
+   - v4 `persona.core_principles` → v5 `<principles>`
+
+3. Convert commands:
+   - v4 YAML commands list → v5 `<cmds>` with `<c cmd="">` entries
+   - Map task references to `run-workflow` handlers
+   - Map template references to workflow invocations
+
+4. Add v5-specific sections:
+   - DO NOT include `<activation>` block (inserted automatically from agent-activation-ide.xml)
+   - Add `<critical-actions>` for config loading and startup requirements
+   - Structure proper XML hierarchy with agent attributes and persona
+
+5. Handle dependencies and paths:
+   - Convert task dependencies to workflow references
+   - Map template dependencies to v5 workflows
+   - Preserve checklist and data file references
+   - CRITICAL: All exec/data/run-workflow paths must use {project-root}/bmad/{{module}}/ NOT src/
+
+<action>Generate the converted v5 agent file with proper XML structure</action>
+<action>Example path conversions:
+
+- exec="{project-root}/bmad/{{target_module}}/tasks/task-name.md"
+- run-workflow="{project-root}/bmad/{{target_module}}/workflows/workflow-name/workflow.yaml"
+- data="{project-root}/bmad/{{target_module}}/data/data-file.yaml"
+  </action>
+  <action>Save to: bmad/{{target_module}}/agents/{{agent_name}}.md (physical location)</action>
+  <action>But agent will reference: {project-root}/bmad/{{target_module}}/agents/{{agent_name}}.md</action>
+  <goto step="6">Continue to Validation</goto>
+  </step>
+
+<step n="5b" goal="Workflow-Assisted Agent Creation" optional="true">
+<action>Extract key information from v4 agent:</action>
+- Name and purpose
+- Commands and functionality
+- Persona traits
+- Any special behaviors
+
+<invoke-workflow>
+  workflow: {project-root}/bmad/bmb/workflows/build-agent/workflow.yaml
+  inputs:
+    - agent_name: {{extracted_name}}
+    - agent_purpose: {{extracted_purpose}}
+    - commands: {{extracted_commands}}
+    - persona: {{extracted_persona}}
+</invoke-workflow>
+
+<goto step="6">Continue to Validation</goto>
+</step>
+
+<step n="5c" goal="Template-to-Workflow Conversion" optional="true">
+<action>Convert v4 Template (YAML) to v5 Workflow:</action>
+
+1. Extract template metadata:
+   - Template id, name, version → workflow.yaml name/description
+   - Output settings → default_output_file
+   - Workflow mode (interactive/yolo) → workflow settings
+
+2. Convert template sections to instructions.md:
+   - Each YAML section → workflow step
+   - `elicit: true` → `<elicit-required/>` tag
+   - Conditional sections → `if="condition"` attribute
+   - Repeatable sections → `repeat="for-each"` attribute
+   - Section instructions → step content
+
+3. Extract template structure to template.md:
+   - Section content fields → template structure
+   - {{variables}} → preserve as-is
+   - Nested sections → hierarchical markdown
+
+4. Handle v4 create-doc.md task integration:
+   - Elicitation methods (1-9 menu) → convert to v5 elicitation
+   - Agent permissions → note in instructions
+   - Processing flow → integrate into workflow steps
+
+<invoke-workflow>
+  workflow: {project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml
+  inputs:
+    - workflow_name: {{template_name}}
+    - workflow_type: document
+    - template_structure: {{extracted_template}}
+    - instructions: {{converted_sections}}
+</invoke-workflow>
+
+<goto step="6">Continue to Validation</goto>
+</step>
+
+<step n="5d" goal="Module Creation" optional="true">
+<action>Analyze module structure and components</action>
+<action>Create module blueprint with all components</action>
+
+<invoke-workflow>
+  workflow: {project-root}/bmad/bmb/workflows/build-module/workflow.yaml
+  inputs:
+    - module_name: {{module_name}}
+    - components: {{component_list}}
+</invoke-workflow>
+
+<goto step="6">Continue to Validation</goto>
+</step>
+
+<step n="5e" goal="Task-to-Workflow Conversion" optional="true">
+<action>Convert v4 Task (Markdown) to v5 Workflow:</action>
+
+1. Analyze task purpose and output:
+   - Does it generate documents? → Create template.md
+   - Does it process data? → Action workflow
+   - Does it guide user interaction? → Interactive workflow
+   - Check for file outputs, templates, or document generation
+
+2. Extract task components:
+   - Execution notices and critical rules → workflow.yaml metadata
+   - Step-by-step instructions → instructions.md steps
+   - Decision trees and branching → flow control tags
+   - User interaction patterns → appropriate v5 tags
+
+3. Based on confirmed workflow type:
+   <check>If Document workflow:</check>
+   - Create template.md from output patterns
+   - Map generation steps to instructions
+   - Add <template-output> tags for sections
+
+   <check>If Action workflow:</check>
+   - Set template: false in workflow.yaml
+   - Focus on action sequences in instructions
+   - Preserve execution logic
+
+4. Handle special v4 patterns:
+   - 1-9 elicitation menus → v5 <elicit-required/>
+   - Agent permissions → note in instructions
+   - YOLO mode → autonomous flag or optional steps
+   - Critical notices → workflow.yaml comments
+
+<invoke-workflow>
+  workflow: {project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml
+  inputs:
+    - workflow_name: {{task_name}}
+    - workflow_type: {{confirmed_workflow_type}}
+    - instructions: {{extracted_task_logic}}
+    - template: {{generated_template_if_document}}
+</invoke-workflow>
+
+<goto step="6">Continue to Validation</goto>
+</step>
+
+<step n="6" goal="Validate Conversion">
+<action>Run validation checks on converted item:</action>
+
+For Agents:
+
+- [ ] Valid XML structure
+- [ ] All required sections present
+- [ ] Commands properly formatted
+- [ ] Activation sequence correct
+
+For Workflows:
+
+- [ ] Valid YAML syntax
+- [ ] Instructions follow v5 conventions
+- [ ] Template variables match
+- [ ] File structure correct
+
+For Modules:
+
+- [ ] All components converted
+- [ ] Proper folder structure
+- [ ] Config files valid
+- [ ] Installation ready
+
+<action>Show validation results to user</action>
+<ask>Any issues to fix before finalizing? (y/n)</ask>
+<check>If yes:</check>
+<action>Address specific issues</action>
+<goto step="6">Re-validate</goto>
+</step>
+
+<step n="7" goal="Migration Report">
+<action>Generate conversion report showing:</action>
+- Original v4 location
+- New v5 location
+- Items converted
+- Any manual adjustments needed
+- Warnings or notes
+
+<action>Save report to: {output_folder}/conversion-report-{{date}}.md</action>
+</step>
+
+<step n="8" goal="Cleanup and Finalize">
+<ask>Archive original v4 files? (y/n)</ask>
+<check>If yes:</check>
+  <action>Move v4 files to: {project-root}/archive/v4-legacy/{{date}}/</action>
+
+<action>Show user the final converted items and their locations</action>
+<action>Provide any post-conversion instructions or recommendations</action>
+
+<ask>Would you like to convert another legacy item? (y/n)</ask>
+<check>If yes:</check>
+<goto step="1">Start new conversion</goto>
+</step>
+
+</workflow>

src/modules/bmb/workflows/convert-legacy/workflow.yaml

@@ -0,0 +1,35 @@
+# Convert Legacy - BMAD v4 to v5 Converter Configuration
+name: "convert-legacy"
+description: "Converts legacy BMAD v4 or similar items (agents, workflows, modules) to BMad Core compliant format with proper structure and conventions"
+author: "BMad"
+
+# Critical variables load from config_source
+config_source: "{project-root}/bmad/bmb/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+src_impact: "{config_source}:src_impact"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# Optional docs that can be provided as input
+recommended_inputs:
+  - legacy_file: "Path to v4 agent, workflow, or module to convert"
+  - conversion_mappings: "{project-root}/bmad/bmb/data/v4-to-v5-mappings.yaml"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/convert-legacy"
+template: false # This is an action/meta workflow - no template needed
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Output configuration - Creates converted items in appropriate module locations
+default_output_folder: "{project-root}/bmad/{{target_module}}/{{item_type}}/{{item_name}}"
+
+# Sub-workflows that may be invoked for conversion
+sub_workflows:
+  - create_agent: "{project-root}/bmad/bmb/workflows/build-agent/workflow.yaml"
+  - create_workflow: "{project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml"
+  - create_module: "{project-root}/bmad/bmb/workflows/build-module/workflow.yaml"
+
+# No special tools required beyond standard BMAD capabilities
+required_tools: []

src/modules/bmb/workflows/create-agent/README.md

@@ -0,0 +1,268 @@
+# Build Agent
+
+## Overview
+
+The Build Agent workflow is an interactive agent builder that guides you through creating BMAD Core compliant agents with proper persona, activation rules, and command structure. It supports three agent types: Simple (self-contained), Expert (with sidecar resources), and Module (full-featured with workflows).
+
+## Key Features
+
+- **Optional Brainstorming**: Creative ideation session before agent building to explore concepts and personalities
+- **Three Agent Types**: Simple, Expert, and Module agents with appropriate structures
+- **Persona Development**: Guided creation of role, identity, communication style, and principles
+- **Command Builder**: Interactive command definition with workflow/task/action patterns
+- **Validation Built-In**: Ensures XML structure and BMAD Core compliance
+- **Config File Support**: Optional agent config for persona overrides
+- **Sidecar Resources**: Setup for Expert agents with domain-specific data
+
+## Usage
+
+### Basic Invocation
+
+```bash
+workflow build-agent
+```
+
+### Through BMad Builder Agent
+
+```
+*create-agent
+```
+
+### With Brainstorming Session
+
+The workflow includes an optional brainstorming phase (Step -1) that helps you explore agent concepts, personalities, and capabilities before building. This is particularly useful when you have a vague idea and want to develop it into a concrete agent concept.
+
+### What You'll Be Asked
+
+0. **Optional brainstorming** (vague idea → refined concept)
+1. Agent type (Simple, Expert, or Module)
+2. Basic identity (name, title, icon, filename)
+3. Module assignment (for Module agents)
+4. Sidecar resources (for Expert agents)
+5. Persona elements (role, identity, style, principles)
+6. Commands and their implementations
+7. Critical actions (optional)
+8. Activation rules (optional, rarely needed)
+
+## Workflow Structure
+
+### Files Included
+
+```
+build-agent/
+├── workflow.yaml                  # Configuration
+├── instructions.md                # Step-by-step guide
+├── checklist.md                   # Validation criteria
+├── README.md                      # This file
+├── agent-types.md                 # Agent type documentation
+├── agent-architecture.md          # Architecture patterns
+├── agent-command-patterns.md      # Command patterns reference
+└── communication-styles.md        # Style examples
+```
+
+## Workflow Process
+
+### Phase 0: Optional Brainstorming (Step -1)
+
+- Creative ideation session using diverse brainstorming techniques
+- Explore agent concepts, personalities, and capabilities
+- Generate character ideas, expertise areas, and command concepts
+- Output feeds directly into agent identity and persona development
+
+### Phase 1: Agent Setup (Steps 0-2)
+
+- Load agent building documentation and patterns
+- Choose agent type (Simple/Expert/Module)
+- Define basic identity (name, title, icon, filename) - informed by brainstorming if completed
+- Assign to module (for Module agents)
+
+### Phase 2: Persona Development (Steps 2-3)
+
+- Define role and responsibilities - leveraging brainstorming insights if available
+- Craft unique identity and backstory
+- Select communication style - can use brainstormed personality concepts
+- Establish guiding principles
+- Add critical actions (optional)
+
+### Phase 3: Command Building (Step 4)
+
+- Add *help and *exit commands (required)
+- Define workflow commands (most common)
+- Add task commands (for single operations)
+- Create action commands (inline logic)
+- Configure command attributes
+
+### Phase 4: Finalization (Steps 5-10)
+
+- Add custom activation rules (optional, rarely needed)
+- Generate complete agent.md file
+- Create agent config file (optional)
+- Setup sidecar resources (for Expert agents)
+- Validate agent structure
+- Provide usage instructions
+
+## Output
+
+### Generated Agent File
+
+Creates agent file at:
+`{output_folder}/agents/{{agent_filename}}.md`
+
+### Agent Structure
+
+```xml
+<!-- Powered by BMAD-CORE™ -->
+
+# {{agent_title}}
+
+<agent id="bmad/{{module}}/agents/{{agent_filename}}.md"
+       name="{{agent_name}}"
+       title="{{agent_title}}"
+       icon="{{agent_icon}}">
+  <persona>
+    <role>...</role>
+    <identity>...</identity>
+    <communication_style>...</communication_style>
+    <principles>...</principles>
+  </persona>
+  <cmds>
+    <c cmd="*help">...</c>
+    <c cmd="*exit">...</c>
+    <!-- Additional commands -->
+  </cmds>
+</agent>
+```
+
+### Optional Config File
+
+If created, generates at:
+`{project-root}/bmad/_cfg/agents/{{agent_config_name}}.md`
+
+## Requirements
+
+- BMAD Core v6 project structure
+- Module to host the agent (for Module agents)
+- Understanding of agent purpose and commands
+- Workflows/tasks to reference in commands (or mark as "todo")
+
+## Brainstorming Integration
+
+The optional brainstorming phase (Step -1) provides a seamless path from vague idea to concrete agent concept:
+
+### When to Use Brainstorming
+
+- **Vague concept**: "I want an agent that helps with data stuff"
+- **Creative exploration**: Want to discover unique personality and approach
+- **Team building**: Creating agents for a module with specific roles
+- **Character development**: Need to flesh out agent personality and voice
+
+### Brainstorming Flow
+
+1. **Step -1**: Optional brainstorming session
+   - Uses CIS brainstorming workflow with agent-specific context
+   - Explores identity, personality, expertise, and command concepts
+   - Generates detailed character and capability ideas
+
+2. **Steps 0-2**: Agent setup informed by brainstorming
+   - Brainstorming output guides agent type selection
+   - Character concepts inform basic identity choices
+   - Personality insights shape persona development
+
+3. **Seamless transition**: Vague idea → brainstormed concept → built agent
+
+### Key Principle
+
+Users can go from **vague idea → brainstormed concept → built agent** in one continuous flow, with brainstorming output directly feeding into agent development.
+
+## Best Practices
+
+### Before Starting
+
+1. Review example agents in `/bmad/bmm/agents/` for patterns
+2. Consider using brainstorming if you have a vague concept to develop
+3. Have a clear vision of the agent's role and personality (or use brainstorming to develop it)
+4. List the commands/capabilities the agent will need
+5. Identify any workflows or tasks the agent will invoke
+
+### During Execution
+
+1. **Agent Names**: Use memorable names that reflect personality
+2. **Icons**: Choose an emoji that represents the agent's role
+3. **Persona**: Make it distinct and consistent with communication style
+4. **Commands**: Use kebab-case, start custom commands with letter (not \*)
+5. **Workflows**: Reference existing workflows or mark as "todo" to implement later
+
+### After Completion
+
+1. Test the agent by loading it
+2. Verify all commands work as expected
+3. Implement any "todo" workflows
+4. Refine persona based on usage
+5. Add more commands as agent evolves
+
+## Agent Types
+
+### Simple Agent
+
+- **Best For**: Self-contained utilities, simple assistants
+- **Characteristics**: Embedded logic, no external dependencies
+- **Example**: Calculator agent, random picker, simple formatter
+
+### Expert Agent
+
+- **Best For**: Domain-specific agents with data/memory
+- **Characteristics**: Sidecar folders, domain restrictions, memory files
+- **Example**: Diary keeper, project journal, personal knowledge base
+
+### Module Agent
+
+- **Best For**: Full-featured agents with workflows
+- **Characteristics**: Part of module, commands invoke workflows
+- **Example**: Product manager, architect, research assistant
+
+## Troubleshooting
+
+### Issue: Agent won't load
+
+- **Solution**: Validate XML structure is correct
+- **Check**: Ensure all required tags present (persona, cmds)
+
+### Issue: Commands don't work
+
+- **Solution**: Verify workflow paths are correct or marked "todo"
+- **Check**: Test workflow invocation separately first
+
+### Issue: Persona feels generic
+
+- **Solution**: Review communication styles guide
+- **Check**: Make identity unique and specific to role
+
+## Customization
+
+To modify agent building process:
+
+1. Edit `instructions.md` to change steps
+2. Update `agent-types.md` to add new agent patterns
+3. Modify `agent-command-patterns.md` for new command types
+4. Edit `communication-styles.md` to add personality examples
+
+## Version History
+
+- **v6.0.0** - BMAD Core v6 compatible
+  - Three agent types (Simple/Expert/Module)
+  - Enhanced persona development
+  - Command pattern library
+  - Validation framework
+
+## Support
+
+For issues or questions:
+
+- Review example agents in `/bmad/bmm/agents/`
+- Check agent documentation in this workflow folder
+- Test with simple agents first, then build complexity
+- Consult BMAD Method v6 documentation
+
+---
+
+_Part of the BMad Method v6 - BMB (BMad Builder) Module_

src/modules/bmb/workflows/create-agent/agent-architecture.md

@@ -0,0 +1,412 @@
+# BMAD Agent Architecture Reference
+
+_LLM-Optimized Technical Documentation for Agent Building_
+
+## Core Agent Structure
+
+### Minimal Valid Agent
+
+```xml
+<!-- Powered by BMAD-CORE™ -->
+
+# Agent Name
+
+<agent id="path/to/agent.md" name="Name" title="Title" icon="🤖">
+  <persona>
+    <role>Primary function</role>
+    <identity>Background and expertise</identity>
+    <communication_style>How they interact</communication_style>
+    <principles>Core beliefs and methodology</principles>
+  </persona>
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>
+```
+
+## Agent XML Schema
+
+### Root Element: `<agent>`
+
+**Required Attributes:**
+
+- `id` - Unique path identifier (e.g., "bmad/bmm/agents/analyst.md")
+- `name` - Agent's name (e.g., "Mary", "John", "Helper")
+- `title` - Professional title (e.g., "Business Analyst", "Security Engineer")
+- `icon` - Single emoji representing the agent
+
+### Core Sections
+
+#### 1. Persona Section (REQUIRED)
+
+```xml
+<persona>
+  <role>1-2 lines: Professional title and primary expertise</role>
+  <identity>3-5 lines: Background, experience, specializations</identity>
+  <communication_style>3-5 lines: Interaction approach, tone, quirks</communication_style>
+  <principles>5-8 lines: Core beliefs, methodology, philosophy</principles>
+</persona>
+```
+
+**Best Practices:**
+
+- Role: Be specific about expertise area
+- Identity: Include experience indicators (years, depth)
+- Communication: Describe HOW they interact, not just tone and quirks
+- Principles: Start with "I believe" or "I operate" for first-person voice
+
+#### 2. Critical Actions Section
+
+```xml
+<critical-actions>
+  <i>Load into memory {project-root}/bmad/{module}/config.yaml and set variables</i>
+  <i>Remember the users name is {user_name}</i>
+  <i>ALWAYS communicate in {communication_language}</i>
+  <!-- Custom initialization actions -->
+</critical-actions>
+```
+
+**For Expert Agents with Sidecars (CRITICAL):**
+
+```xml
+<critical-actions>
+  <!-- CRITICAL: Load sidecar files FIRST -->
+  <i critical="MANDATORY">Load COMPLETE file {agent-folder}/instructions.md and follow ALL directives</i>
+  <i critical="MANDATORY">Load COMPLETE file {agent-folder}/memories.md into permanent context</i>
+  <i critical="MANDATORY">You MUST follow all rules in instructions.md on EVERY interaction</i>
+
+  <!-- Standard initialization -->
+  <i>Load into memory {project-root}/bmad/{module}/config.yaml and set variables</i>
+  <i>Remember the users name is {user_name}</i>
+  <i>ALWAYS communicate in {communication_language}</i>
+
+  <!-- Domain restrictions -->
+  <i>ONLY read/write files in {user-folder}/diary/ - NO OTHER FOLDERS</i>
+</critical-actions>
+```
+
+**Common Patterns:**
+
+- Config loading for module agents
+- User context initialization
+- Language preferences
+- **Sidecar file loading (Expert agents) - MUST be explicit and CRITICAL**
+- **Domain restrictions (Expert agents) - MUST be enforced**
+
+#### 3. Commands Section (REQUIRED)
+
+```xml
+<cmds>
+  <c cmd="*trigger" [attributes]>Description</c>
+</cmds>
+```
+
+**Command Attributes:**
+
+- `run-workflow="{path}"` - Executes a workflow
+- `exec="{path}"` - Executes a task
+- `tmpl="{path}"` - Template reference
+- `data="{path}"` - Data file reference
+
+**Required Commands:**
+
+- `*help` - Always first, shows command list
+- `*exit` - Always last, exits agent
+
+## Advanced Agent Patterns
+
+### Activation Rules (OPTIONAL)
+
+```xml
+<activation critical="true">
+  <initialization critical="true" sequential="MANDATORY">
+    <step n="1">Load configuration</step>
+    <step n="2">Apply overrides</step>
+    <step n="3">Execute critical actions</step>
+    <step n="4" critical="BLOCKING">Show greeting with menu</step>
+    <step n="5" critical="BLOCKING">AWAIT user input</step>
+  </initialization>
+  <command-resolution critical="true">
+    <rule>Numeric input → Execute command at cmd_map[n]</rule>
+    <rule>Text input → Fuzzy match against commands</rule>
+  </command-resolution>
+</activation>
+```
+
+### Expert Agent Sidecar Pattern
+
+```xml
+<!-- DO NOT use sidecar-resources tag - Instead use critical-actions -->
+<!-- Sidecar files MUST be loaded explicitly in critical-actions -->
+
+<!-- Example Expert Agent with Diary domain -->
+<agent id="diary-keeper" name="Personal Assistant" title="Diary Keeper" icon="📔">
+  <critical-actions>
+    <!-- MANDATORY: Load all sidecar files -->
+    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/diary-rules.md</i>
+    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/user-memories.md</i>
+    <i critical="MANDATORY">Follow ALL rules from diary-rules.md</i>
+
+    <!-- Domain restriction -->
+    <i critical="MANDATORY">ONLY access files in {user-folder}/diary/</i>
+    <i critical="MANDATORY">NEVER access files outside diary folder</i>
+  </critical-actions>
+
+  <persona>...</persona>
+  <cmds>...</cmds>
+</agent>
+```
+
+### Module Agent Integration
+
+```xml
+<module-integration>
+  <module-path>{project-root}/bmad/{module-code}</module-path>
+  <config-source>{module-path}/config.yaml</config-source>
+  <workflows-path>{project-root}/bmad/{module-code}/workflows</workflows-path>
+</module-integration>
+```
+
+## Variable System
+
+### System Variables
+
+- `{project-root}` - Root directory of project
+- `{user_name}` - User's name from config
+- `{communication_language}` - Language preference
+- `{date}` - Current date
+- `{module}` - Current module code
+
+### Config Variables
+
+Format: `{config_source}:variable_name`
+Example: `{config_source}:output_folder`
+
+### Path Construction
+
+```
+Good: {project-root}/bmad/{module}/agents/
+Bad:  /absolute/path/to/agents/
+Bad:  ../../../relative/paths/
+```
+
+## Command Patterns
+
+### Workflow Commands
+
+```xml
+<!-- Full path -->
+<c cmd="*create-prd" run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
+  Create Product Requirements Document
+</c>
+
+<!-- Placeholder for future -->
+<c cmd="*analyze" run-workflow="todo">
+  Perform analysis (workflow to be created)
+</c>
+```
+
+### Task Commands
+
+```xml
+<c cmd="*validate" exec="{project-root}/bmad/core/tasks/validate-workflow.md">
+  Validate document
+</c>
+```
+
+### Template Commands
+
+```xml
+<c cmd="*brief"
+   exec="{project-root}/bmad/core/tasks/create-doc.md"
+   tmpl="{project-root}/bmad/bmm/templates/brief.md">
+  Create project brief
+</c>
+```
+
+### Data-Driven Commands
+
+```xml
+<c cmd="*standup"
+   exec="{project-root}/bmad/bmm/tasks/daily-standup.md"
+   data="{project-root}/bmad/_cfg/agent-party.xml">
+  Run daily standup
+</c>
+```
+
+## Agent Type Specific Patterns
+
+### Simple Agent
+
+- Self-contained logic
+- Minimal or no external dependencies
+- May have embedded functions
+- Good for utilities and converters
+
+### Expert Agent
+
+- Domain-specific with sidecar resources
+- Restricted access patterns
+- Memory/context files
+- Good for specialized domains
+
+### Module Agent
+
+- Full integration with module
+- Multiple workflows and tasks
+- Config-driven behavior
+- Good for professional tools
+
+## Common Anti-Patterns to Avoid
+
+### ❌ Bad Practices
+
+```xml
+<!-- Missing required persona elements -->
+<persona>
+  <role>Helper</role>
+  <!-- Missing identity, style, principles -->
+</persona>
+
+<!-- Hard-coded paths -->
+<c cmd="*run" exec="/Users/john/project/task.md">
+
+<!-- No help command -->
+<cmds>
+  <c cmd="*do-something">Action</c>
+  <!-- Missing *help -->
+</cmds>
+
+<!-- Duplicate command triggers -->
+<c cmd="*analyze">First</c>
+<c cmd="*analyze">Second</c>
+```
+
+### ✅ Good Practices
+
+```xml
+<!-- Complete persona -->
+<persona>
+  <role>Data Analysis Expert</role>
+  <identity>Senior analyst with 10+ years...</identity>
+  <communication_style>Analytical and precise...</communication_style>
+  <principles>I believe in data-driven...</principles>
+</persona>
+
+<!-- Variable-based paths -->
+<c cmd="*run" exec="{project-root}/bmad/module/task.md">
+
+<!-- Required commands present -->
+<cmds>
+  <c cmd="*help">Show commands</c>
+  <c cmd="*analyze">Perform analysis</c>
+  <c cmd="*exit">Exit</c>
+</cmds>
+```
+
+## Agent Lifecycle
+
+### 1. Initialization
+
+1. Load agent file
+2. Parse XML structure
+3. Load critical-actions
+4. Apply config overrides
+5. Present greeting
+
+### 2. Command Loop
+
+1. Show numbered menu
+2. Await user input
+3. Resolve command
+4. Execute action
+5. Return to menu
+
+### 3. Termination
+
+1. User enters \*exit
+2. Cleanup if needed
+3. Exit persona
+
+## Testing Checklist
+
+Before deploying an agent:
+
+- [ ] Valid XML structure
+- [ ] All persona elements present
+- [ ] *help and *exit commands exist
+- [ ] All paths use variables
+- [ ] No duplicate commands
+- [ ] Config loading works
+- [ ] Commands execute properly
+
+## LLM Building Tips
+
+When building agents:
+
+1. Start with agent type (Simple/Expert/Module)
+2. Define complete persona first
+3. Add standard critical-actions
+4. Include *help and *exit
+5. Add domain commands
+6. Test command execution
+7. Validate with checklist
+
+## Integration Points
+
+### With Workflows
+
+- Agents invoke workflows via run-workflow
+- Workflows can be incomplete (marked "todo")
+- Workflow paths must be valid or "todo"
+
+### With Tasks
+
+- Tasks are single operations
+- Executed via exec attribute
+- Can include data files
+
+### With Templates
+
+- Templates define document structure
+- Used with create-doc task
+- Variables passed through
+
+## Quick Reference
+
+### Minimal Commands
+
+```xml
+<cmds>
+  <c cmd="*help">Show numbered cmd list</c>
+  <c cmd="*exit">Exit with confirmation</c>
+</cmds>
+```
+
+### Standard Critical Actions
+
+```xml
+<critical-actions>
+  <i>Load into memory {project-root}/bmad/{module}/config.yaml</i>
+  <i>Remember the users name is {user_name}</i>
+  <i>ALWAYS communicate in {communication_language}</i>
+</critical-actions>
+```
+
+### Module Agent Pattern
+
+```xml
+<agent id="bmad/{module}/agents/{name}.md"
+       name="{Name}"
+       title="{Title}"
+       icon="{emoji}">
+  <persona>...</persona>
+  <critical-actions>...</critical-actions>
+  <cmds>
+    <c cmd="*help">...</c>
+    <c cmd="*{command}" run-workflow="{path}">...</c>
+    <c cmd="*exit">...</c>
+  </cmds>
+</agent>
+```

src/modules/bmb/workflows/create-agent/agent-command-patterns.md

@@ -0,0 +1,757 @@
+# BMAD Agent Command Patterns Reference
+
+_LLM-Optimized Guide for Command Design_
+
+## Important: How to Process Action References
+
+When executing agent commands, understand these reference patterns:
+
+```xml
+<!-- Pattern 1: Inline action -->
+<c cmd="*example" action="do this specific thing">
+→ Execute the text "do this specific thing" directly
+
+<!-- Pattern 2: Internal reference with # prefix -->
+<c cmd="*example" action="#prompt-id">
+→ Find <prompt id="prompt-id"> in the current agent and execute its content
+
+<!-- Pattern 3: External file reference -->
+<c cmd="*example" exec="{project-root}/path/to/file.md">
+→ Load and execute the external file
+```
+
+**The `#` prefix is your signal that this is an internal XML node reference, not a file path.**
+
+## Command Anatomy
+
+### Basic Structure
+
+```xml
+<c cmd="*trigger" [attributes]>Description</c>
+```
+
+**Components:**
+
+- `cmd` - The trigger word (always starts with \*)
+- `attributes` - Action directives (optional):
+  - `run-workflow` - Path to workflow YAML
+  - `exec` - Path to task/operation
+  - `tmpl` - Path to template (used with exec)
+  - `action` - Embedded prompt/instruction
+  - `data` - Path to supplementary data (universal)
+- `Description` - What shows in menu
+
+## Command Types
+
+**Quick Reference:**
+
+1. **Workflow Commands** - Execute multi-step workflows (`run-workflow`)
+2. **Task Commands** - Execute single operations (`exec`)
+3. **Template Commands** - Generate from templates (`exec` + `tmpl`)
+4. **Meta Commands** - Agent control (no attributes)
+5. **Action Commands** - Embedded prompts (`action`)
+6. **Embedded Commands** - Logic in persona (no attributes)
+
+**Universal Attributes:**
+
+- `data` - Can be added to ANY command type for supplementary info
+- `if` - Conditional execution (advanced pattern)
+- `params` - Runtime parameters (advanced pattern)
+
+### 1. Workflow Commands
+
+Execute complete multi-step processes
+
+```xml
+<!-- Standard workflow -->
+<c cmd="*create-prd"
+   run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
+  Create Product Requirements Document
+</c>
+
+<!-- Workflow with validation -->
+<c cmd="*validate-prd"
+   validate-workflow="{output_folder}/prd-draft.md"
+   workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">
+  Validate PRD Against Checklist
+</c>
+
+<!-- Auto-discover validation workflow from document -->
+<c cmd="*validate-doc"
+   validate-workflow="{output_folder}/document.md">
+  Validate Document (auto-discover checklist)
+</c>
+
+<!-- Placeholder for future development -->
+<c cmd="*analyze-data"
+   run-workflow="todo">
+  Analyze dataset (workflow coming soon)
+</c>
+```
+
+**Workflow Attributes:**
+
+- `run-workflow` - Execute a workflow to create documents
+- `validate-workflow` - Validate an existing document against its checklist
+- `workflow` - (optional with validate-workflow) Specify the workflow.yaml directly
+
+**Best Practices:**
+
+- Use descriptive trigger names
+- Always use variable paths
+- Mark incomplete as "todo"
+- Description should be clear action
+- Include validation commands for workflows that produce documents
+
+### 2. Task Commands
+
+Execute single operations
+
+```xml
+<!-- Simple task -->
+<c cmd="*validate"
+   exec="{project-root}/bmad/core/tasks/validate-workflow.md">
+  Validate document against checklist
+</c>
+
+<!-- Task with data -->
+<c cmd="*standup"
+   exec="{project-root}/bmad/mmm/tasks/daily-standup.md"
+   data="{project-root}/bmad/_cfg/agent-party.xml">
+  Run agile team standup
+</c>
+```
+
+**Data Property:**
+
+- Can be used with any command type
+- Provides additional reference or context
+- Path to supplementary files or resources
+- Loaded at runtime for command execution
+
+### 3. Template Commands
+
+Generate documents from templates
+
+```xml
+<c cmd="*brief"
+   exec="{project-root}/bmad/core/tasks/create-doc.md"
+   tmpl="{project-root}/bmad/bmm/templates/brief.md">
+  Produce Project Brief
+</c>
+
+<c cmd="*competitor-analysis"
+   exec="{project-root}/bmad/core/tasks/create-doc.md"
+   tmpl="{project-root}/bmad/bmm/templates/competitor.md"
+   data="{project-root}/bmad/_data/market-research.csv">
+  Produce Competitor Analysis
+</c>
+```
+
+### 4. Meta Commands
+
+Agent control and information
+
+```xml
+<!-- Required meta commands -->
+<c cmd="*help">Show numbered cmd list</c>
+<c cmd="*exit">Exit with confirmation</c>
+
+<!-- Optional meta commands -->
+<c cmd="*yolo">Toggle Yolo Mode</c>
+<c cmd="*status">Show current status</c>
+<c cmd="*config">Show configuration</c>
+```
+
+### 5. Action Commands
+
+Direct prompts embedded in commands (Simple agents)
+
+#### Simple Action (Inline)
+
+```xml
+<!-- Short action attribute with embedded prompt -->
+<c cmd="*list-tasks"
+   action="list all tasks from {project-root}/bmad/_cfg/task-manifest.csv">
+  List Available Tasks
+</c>
+
+<c cmd="*summarize"
+   action="summarize the key points from the current document">
+  Summarize Document
+</c>
+```
+
+#### Complex Action (Referenced)
+
+For multiline/complex prompts, define them separately and reference by id:
+
+```xml
+<agent name="Research Assistant">
+  <!-- Define complex prompts as separate nodes -->
+  <prompts>
+    <prompt id="deep-analysis">
+      Perform a comprehensive analysis following these steps:
+      1. Identify the main topic and key themes
+      2. Extract all supporting evidence and data points
+      3. Analyze relationships between concepts
+      4. Identify gaps or contradictions
+      5. Generate insights and recommendations
+      6. Create an executive summary
+      Format the output with clear sections and bullet points.
+    </prompt>
+
+    <prompt id="literature-review">
+      Conduct a systematic literature review:
+      1. Summarize each source's main arguments
+      2. Compare and contrast different perspectives
+      3. Identify consensus points and controversies
+      4. Evaluate the quality and relevance of sources
+      5. Synthesize findings into coherent themes
+      6. Highlight research gaps and future directions
+      Include proper citations and references.
+    </prompt>
+  </prompts>
+
+  <!-- Commands reference the prompts by id -->
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+
+    <c cmd="*deep-analyze"
+       action="#deep-analysis">
+      <!-- The # means: use the <prompt id="deep-analysis"> defined above -->
+      Perform Deep Analysis
+    </c>
+
+    <c cmd="*review-literature"
+       action="#literature-review"
+       data="{project-root}/bmad/_data/sources.csv">
+      Conduct Literature Review
+    </c>
+
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>
+```
+
+**Reference Convention:**
+
+- `action="#prompt-id"` means: "Find and execute the <prompt> node with id='prompt-id' within this agent"
+- `action="inline text"` means: "Execute this text directly as the prompt"
+- `exec="{path}"` means: "Load and execute external file at this path"
+- The `#` prefix signals to the LLM: "This is an internal reference - look for a prompt node with this ID within the current agent XML"
+
+**LLM Processing Instructions:**
+When you see `action="#some-id"` in a command:
+
+1. Look for `<prompt id="some-id">` within the same agent
+2. Use the content of that prompt node as the instruction
+3. If not found, report error: "Prompt 'some-id' not found in agent"
+
+**Use Cases:**
+
+- Quick operations (inline action)
+- Complex multi-step processes (referenced prompt)
+- Self-contained agents with task-like capabilities
+- Reusable prompt templates within agent
+
+### 6. Embedded Commands
+
+Logic embedded in agent persona (Simple agents)
+
+```xml
+<!-- No exec/run-workflow/action attribute -->
+<c cmd="*calculate">Perform calculation</c>
+<c cmd="*convert">Convert format</c>
+<c cmd="*generate">Generate output</c>
+```
+
+## Command Naming Conventions
+
+### Action-Based Naming
+
+```xml
+*create-    <!-- Generate new content -->
+*build-     <!-- Construct components -->
+*analyze-   <!-- Examine and report -->
+*validate-  <!-- Check correctness -->
+*generate-  <!-- Produce output -->
+*update-    <!-- Modify existing -->
+*review-    <!-- Examine quality -->
+*test-      <!-- Verify functionality -->
+```
+
+### Domain-Based Naming
+
+```xml
+*brainstorm      <!-- Creative ideation -->
+*architect       <!-- Design systems -->
+*refactor        <!-- Improve code -->
+*deploy          <!-- Release to production -->
+*monitor         <!-- Watch systems -->
+```
+
+### Naming Anti-Patterns
+
+```xml
+<!-- ❌ Too vague -->
+<c cmd="*do">Do something</c>
+
+<!-- ❌ Too long -->
+<c cmd="*create-comprehensive-product-requirements-document-with-analysis">
+
+<!-- ❌ No verb -->
+<c cmd="*prd">Product Requirements</c>
+
+<!-- ✅ Clear and concise -->
+<c cmd="*create-prd">Create Product Requirements Document</c>
+```
+
+## Command Organization
+
+### Standard Order
+
+```xml
+<cmds>
+  <!-- 1. Always first -->
+  <c cmd="*help">Show numbered cmd list</c>
+
+  <!-- 2. Primary workflows -->
+  <c cmd="*create-prd" run-workflow="...">Create PRD</c>
+  <c cmd="*build-module" run-workflow="...">Build module</c>
+
+  <!-- 3. Secondary actions -->
+  <c cmd="*validate" exec="...">Validate document</c>
+  <c cmd="*analyze" exec="...">Analyze code</c>
+
+  <!-- 4. Utility commands -->
+  <c cmd="*config">Show configuration</c>
+  <c cmd="*yolo">Toggle Yolo Mode</c>
+
+  <!-- 5. Always last -->
+  <c cmd="*exit">Exit with confirmation</c>
+</cmds>
+```
+
+### Grouping Strategies
+
+**By Lifecycle:**
+
+```xml
+<cmds>
+  <c cmd="*help">Help</c>
+  <!-- Planning -->
+  <c cmd="*brainstorm">Brainstorm ideas</c>
+  <c cmd="*plan">Create plan</c>
+  <!-- Building -->
+  <c cmd="*build">Build component</c>
+  <c cmd="*test">Test component</c>
+  <!-- Deployment -->
+  <c cmd="*deploy">Deploy to production</c>
+  <c cmd="*monitor">Monitor system</c>
+  <c cmd="*exit">Exit</c>
+</cmds>
+```
+
+**By Complexity:**
+
+```xml
+<cmds>
+  <c cmd="*help">Help</c>
+  <!-- Simple -->
+  <c cmd="*quick-review">Quick review</c>
+  <!-- Standard -->
+  <c cmd="*create-doc">Create document</c>
+  <!-- Complex -->
+  <c cmd="*full-analysis">Comprehensive analysis</c>
+  <c cmd="*exit">Exit</c>
+</cmds>
+```
+
+## Command Descriptions
+
+### Good Descriptions
+
+```xml
+<!-- Clear action and object -->
+<c cmd="*create-prd">Create Product Requirements Document</c>
+
+<!-- Specific outcome -->
+<c cmd="*analyze-security">Perform security vulnerability analysis</c>
+
+<!-- User benefit -->
+<c cmd="*optimize">Optimize code for performance</c>
+```
+
+### Poor Descriptions
+
+```xml
+<!-- Too vague -->
+<c cmd="*process">Process</c>
+
+<!-- Technical jargon -->
+<c cmd="*exec-wf-123">Execute WF123</c>
+
+<!-- Missing context -->
+<c cmd="*run">Run</c>
+```
+
+## The Data Property
+
+### Universal Data Attribute
+
+The `data` attribute can be added to ANY command type to provide supplementary information:
+
+```xml
+<!-- Workflow with data -->
+<c cmd="*brainstorm"
+   run-workflow="{project-root}/bmad/cis/workflows/brainstorming/workflow.yaml"
+   data="{project-root}/bmad/cis/workflows/brainstorming/brain-methods.csv">
+  Creative Brainstorming Session
+</c>
+
+<!-- Action with data -->
+<c cmd="*analyze-metrics"
+   action="analyze these metrics and identify trends"
+   data="{project-root}/bmad/_data/performance-metrics.json">
+  Analyze Performance Metrics
+</c>
+
+<!-- Template with data -->
+<c cmd="*report"
+   exec="{project-root}/bmad/core/tasks/create-doc.md"
+   tmpl="{project-root}/bmad/bmm/templates/report.md"
+   data="{project-root}/bmad/_data/quarterly-results.csv">
+  Generate Quarterly Report
+</c>
+```
+
+**Common Data Uses:**
+
+- Reference tables (CSV files)
+- Configuration data (YAML/JSON)
+- Agent manifests (XML)
+- Historical context
+- Domain knowledge
+- Examples and patterns
+
+## Advanced Patterns
+
+### Conditional Commands
+
+```xml
+<!-- Only show if certain conditions met -->
+<c cmd="*advanced-mode"
+   if="user_level == 'expert'"
+   run-workflow="...">
+  Advanced configuration mode
+</c>
+
+<!-- Environment specific -->
+<c cmd="*deploy-prod"
+   if="environment == 'production'"
+   exec="...">
+  Deploy to production
+</c>
+```
+
+### Parameterized Commands
+
+```xml
+<!-- Accept runtime parameters -->
+<c cmd="*create-agent"
+   run-workflow="..."
+   params="agent_type,agent_name">
+  Create new agent with parameters
+</c>
+```
+
+### Command Aliases
+
+```xml
+<!-- Multiple triggers for same action -->
+<c cmd="*prd|*create-prd|*product-requirements"
+   run-workflow="...">
+  Create Product Requirements Document
+</c>
+```
+
+## Module-Specific Patterns
+
+### BMM (Business Management)
+
+```xml
+<c cmd="*create-prd">Product Requirements</c>
+<c cmd="*market-research">Market Research</c>
+<c cmd="*competitor-analysis">Competitor Analysis</c>
+<c cmd="*brief">Project Brief</c>
+```
+
+### BMB (Builder)
+
+```xml
+<c cmd="*build-agent">Build Agent</c>
+<c cmd="*build-module">Build Module</c>
+<c cmd="*create-workflow">Create Workflow</c>
+<c cmd="*module-brief">Module Brief</c>
+```
+
+### CIS (Creative Intelligence)
+
+```xml
+<c cmd="*brainstorm">Brainstorming Session</c>
+<c cmd="*ideate">Ideation Workshop</c>
+<c cmd="*storytell">Story Creation</c>
+```
+
+## Command Menu Presentation
+
+### How Commands Display
+
+```
+1. *help - Show numbered cmd list
+2. *create-prd - Create Product Requirements Document
+3. *build-agent - Build new BMAD agent
+4. *validate - Validate document
+5. *exit - Exit with confirmation
+```
+
+### Menu Customization
+
+```xml
+<!-- Group separator (visual only) -->
+<c cmd="---">━━━━━━━━━━━━━━━━━━━━</c>
+
+<!-- Section header (non-executable) -->
+<c cmd="SECTION">═══ Workflows ═══</c>
+```
+
+## Error Handling
+
+### Missing Resources
+
+```xml
+<!-- Workflow not yet created -->
+<c cmd="*future-feature"
+   run-workflow="todo">
+  Coming soon: Advanced feature
+</c>
+
+<!-- Graceful degradation -->
+<c cmd="*analyze"
+   run-workflow="{optional-path|fallback-path}">
+  Analyze with available tools
+</c>
+```
+
+## Testing Commands
+
+### Command Test Checklist
+
+- [ ] Unique trigger (no duplicates)
+- [ ] Clear description
+- [ ] Valid path or "todo"
+- [ ] Uses variables not hardcoded paths
+- [ ] Executes without error
+- [ ] Returns to menu after execution
+
+### Common Issues
+
+1. **Duplicate triggers** - Each cmd must be unique
+2. **Missing paths** - File must exist or be "todo"
+3. **Hardcoded paths** - Always use variables
+4. **No description** - Every command needs text
+5. **Wrong order** - help first, exit last
+
+## Quick Templates
+
+### Workflow Command
+
+```xml
+<!-- Create document -->
+<c cmd="*{action}-{object}"
+   run-workflow="{project-root}/bmad/{module}/workflows/{workflow}/workflow.yaml">
+  {Action} {Object Description}
+</c>
+
+<!-- Validate document -->
+<c cmd="*validate-{object}"
+   validate-workflow="{output_folder}/{document}.md"
+   workflow="{project-root}/bmad/{module}/workflows/{workflow}/workflow.yaml">
+  Validate {Object Description}
+</c>
+```
+
+### Task Command
+
+```xml
+<c cmd="*{action}"
+   exec="{project-root}/bmad/{module}/tasks/{task}.md">
+  {Action Description}
+</c>
+```
+
+### Template Command
+
+```xml
+<c cmd="*{document}"
+   exec="{project-root}/bmad/core/tasks/create-doc.md"
+   tmpl="{project-root}/bmad/{module}/templates/{template}.md">
+  Create {Document Name}
+</c>
+```
+
+## Self-Contained Agent Patterns
+
+### When to Use Each Approach
+
+**Inline Action (`action="prompt"`)**
+
+- Prompt is < 2 lines
+- Simple, direct instruction
+- Not reused elsewhere
+- Quick transformations
+
+**Referenced Prompt (`action="#prompt-id"`)**
+
+- Prompt is multiline/complex
+- Contains structured steps
+- May be reused by multiple commands
+- Maintains readability
+
+**External Task (`exec="path/to/task.md"`)**
+
+- Logic needs to be shared across agents
+- Task is independently valuable
+- Requires version control separately
+- Part of larger workflow system
+
+### Complete Self-Contained Agent
+
+```xml
+<agent id="bmad/research/agents/analyst.md" name="Research Analyst" icon="🔬">
+  <!-- Embedded prompt library -->
+  <prompts>
+    <prompt id="swot-analysis">
+      Perform a SWOT analysis:
+
+      STRENGTHS (Internal, Positive)
+      - What advantages exist?
+      - What do we do well?
+      - What unique resources?
+
+      WEAKNESSES (Internal, Negative)
+      - What could improve?
+      - Where are resource gaps?
+      - What needs development?
+
+      OPPORTUNITIES (External, Positive)
+      - What trends can we leverage?
+      - What market gaps exist?
+      - What partnerships are possible?
+
+      THREATS (External, Negative)
+      - What competition exists?
+      - What risks are emerging?
+      - What could disrupt us?
+
+      Provide specific examples and actionable insights for each quadrant.
+    </prompt>
+
+    <prompt id="competitive-intel">
+      Analyze competitive landscape:
+      1. Identify top 5 competitors
+      2. Compare features and capabilities
+      3. Analyze pricing strategies
+      4. Evaluate market positioning
+      5. Assess strengths and vulnerabilities
+      6. Recommend competitive strategies
+    </prompt>
+  </prompts>
+
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+
+    <!-- Simple inline actions -->
+    <c cmd="*summarize"
+       action="create executive summary of findings">
+      Create Executive Summary
+    </c>
+
+    <!-- Complex referenced prompts -->
+    <c cmd="*swot"
+       action="#swot-analysis">
+      Perform SWOT Analysis
+    </c>
+
+    <c cmd="*compete"
+       action="#competitive-intel"
+       data="{project-root}/bmad/_data/market-data.csv">
+      Analyze Competition
+    </c>
+
+    <!-- Hybrid: external task with internal data -->
+    <c cmd="*report"
+       exec="{project-root}/bmad/core/tasks/create-doc.md"
+       tmpl="{project-root}/bmad/research/templates/report.md">
+      Generate Research Report
+    </c>
+
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>
+```
+
+## Simple Agent Example
+
+For agents that primarily use embedded logic:
+
+```xml
+<agent name="Data Analyst">
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+
+    <!-- Action commands for direct operations -->
+    <c cmd="*list-metrics"
+       action="list all available metrics from the dataset">
+      List Available Metrics
+    </c>
+
+    <c cmd="*analyze"
+       action="perform statistical analysis on the provided data"
+       data="{project-root}/bmad/_data/dataset.csv">
+      Analyze Dataset
+    </c>
+
+    <c cmd="*visualize"
+       action="create visualization recommendations for this data">
+      Suggest Visualizations
+    </c>
+
+    <!-- Embedded logic commands -->
+    <c cmd="*calculate">Perform calculations</c>
+    <c cmd="*interpret">Interpret results</c>
+
+    <c cmd="*exit">Exit with confirmation</c>
+  </cmds>
+</agent>
+```
+
+## LLM Building Guide
+
+When creating commands:
+
+1. Start with *help and *exit
+2. Choose appropriate command type:
+   - Complex multi-step? Use `run-workflow`
+   - Single operation? Use `exec`
+   - Need template? Use `exec` + `tmpl`
+   - Simple prompt? Use `action`
+   - Agent handles it? Use no attributes
+3. Add `data` attribute if supplementary info needed
+4. Add primary workflows (main value)
+5. Add secondary tasks
+6. Include utility commands
+7. Test each command works
+8. Verify no duplicates
+9. Ensure clear descriptions

src/modules/bmb/workflows/create-agent/agent-types.md

@@ -0,0 +1,177 @@
+# BMAD Agent Types Reference
+
+## Overview
+
+BMAD agents come in three distinct types, each designed for different use cases and complexity levels.
+
+## Agent Types
+
+### 1. Simple Agent
+
+**Purpose:** Self-contained, standalone agents with embedded capabilities
+
+**Characteristics:**
+
+- All logic embedded within the agent file
+- No external dependencies
+- Quick to create and deploy
+- Perfect for single-purpose tools
+
+**Use Cases:**
+
+- Calculator agents
+- Format converters
+- Simple analyzers
+- Static advisors
+
+**Structure:**
+
+```xml
+<agent id="simple-agent" name="Helper" title="Simple Helper" icon="🤖">
+  <persona>
+    <role>Simple Helper Role</role>
+    <identity>...</identity>
+    <communication_style>...</communication_style>
+    <principles>...</principles>
+  </persona>
+  <embedded-data>
+    <!-- Optional embedded data/logic -->
+  </embedded-data>
+  <cmds>
+    <c cmd="*help">Show commands</c>
+    <c cmd="*calculate">Perform calculation</c>
+    <c cmd="*exit">Exit</c>
+  </cmds>
+</agent>
+```
+
+### 2. Expert Agent
+
+**Purpose:** Specialized agents with domain expertise and sidecar resources
+
+**Characteristics:**
+
+- Has access to specific folders/files
+- Domain-restricted operations
+- Maintains specialized knowledge
+- Can have memory/context files
+
+**Use Cases:**
+
+- Personal diary agent (only accesses diary folder)
+- Project-specific assistant (knows project context)
+- Domain expert (medical, legal, technical)
+- Personal coach with history
+
+**Structure:**
+
+```xml
+<agent id="expert-agent" name="Domain Expert" title="Specialist" icon="🎯">
+  <persona>
+    <role>Domain Specialist Role</role>
+    <identity>...</identity>
+    <communication_style>...</communication_style>
+    <principles>...</principles>
+  </persona>
+  <critical-actions>
+    <!-- CRITICAL: Load sidecar files explicitly -->
+    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/instructions.md and follow ALL directives</i>
+    <i critical="MANDATORY">Load COMPLETE file {agent-folder}/memories.md into permanent context</i>
+    <i critical="MANDATORY">ONLY access {user-folder}/diary/ - NO OTHER FOLDERS</i>
+  </critical-actions>
+  <cmds>...</cmds>
+</agent>
+```
+
+**Sidecar Structure:**
+
+```
+expert-agent/
+├── agent.md          # Main agent file
+├── memories.md       # Personal context/memories
+├── knowledge/        # Domain knowledge base
+└── data/            # Agent-specific data
+```
+
+### 3. Module Agent
+
+**Purpose:** Full-featured agents belonging to a module with access to workflows and resources
+
+**Characteristics:**
+
+- Part of a BMAD module (bmm, bmb, cis)
+- Access to multiple workflows
+- Can invoke other tasks and agents
+- Professional/enterprise grade
+
+**Use Cases:**
+
+- Product Manager (creates PRDs, manages requirements)
+- Security Engineer (threat models, security reviews)
+- Test Architect (test strategies, automation)
+- Business Analyst (market research, requirements)
+
+**Structure:**
+
+```xml
+<agent id="bmad/bmm/agents/pm.md" name="John" title="Product Manager" icon="📋">
+  <persona>
+    <role>Product Management Expert</role>
+    <identity>...</identity>
+    <communication_style>...</communication_style>
+    <principles>...</principles>
+  </persona>
+  <critical-actions>
+    <i>Load config from {project-root}/bmad/{module}/config.yaml</i>
+  </critical-actions>
+  <cmds>
+    <c cmd="*help">Show numbered cmd list</c>
+    <c cmd="*create-prd" run-workflow="{project-root}/bmad/bmm/workflows/prd/workflow.yaml">Create PRD</c>
+    <c cmd="*validate" exec="{project-root}/bmad/core/tasks/validate-workflow.md">Validate document</c>
+    <c cmd="*exit">Exit</c>
+  </cmds>
+</agent>
+```
+
+## Choosing the Right Type
+
+### Choose Simple Agent when:
+
+- Single, well-defined purpose
+- No external data needed
+- Quick utility functions
+- Embedded logic is sufficient
+
+### Choose Expert Agent when:
+
+- Domain-specific expertise required
+- Need to maintain context/memory
+- Restricted to specific data/folders
+- Personal or specialized use case
+
+### Choose Module Agent when:
+
+- Part of larger system/module
+- Needs multiple workflows
+- Professional/team use
+- Complex multi-step processes
+
+## Migration Path
+
+```
+Simple Agent → Expert Agent → Module Agent
+```
+
+Agents can evolve:
+
+1. Start with Simple for proof of concept
+2. Add sidecar resources to become Expert
+3. Integrate with module to become Module Agent
+
+## Best Practices
+
+1. **Start Simple:** Begin with the simplest type that meets your needs
+2. **Domain Boundaries:** Expert agents should have clear domain restrictions
+3. **Module Integration:** Module agents should follow module conventions
+4. **Resource Management:** Document all external resources clearly
+5. **Evolution Planning:** Design with potential growth in mind

src/modules/bmb/workflows/create-agent/brainstorm-context.md

@@ -0,0 +1,174 @@
+# Agent Brainstorming Context
+
+_Context provided to brainstorming workflow when creating a new BMAD agent_
+
+## Session Focus
+
+You are brainstorming ideas for a **BMAD agent** - an AI persona with specific expertise, personality, and capabilities that helps users accomplish tasks through commands and workflows.
+
+## What is a BMAD Agent?
+
+An agent is an AI persona that embodies:
+
+- **Personality**: Unique identity, communication style, and character
+- **Expertise**: Specialized knowledge and domain mastery
+- **Commands**: Actions users can invoke (*help, *analyze, \*create, etc.)
+- **Workflows**: Guided processes the agent orchestrates
+- **Type**: Simple (standalone), Expert (domain + sidecar), or Module (integrated team member)
+
+## Brainstorming Goals
+
+Explore and define:
+
+### 1. Agent Identity & Personality
+
+- **Who are they?** (name, backstory, motivation)
+- **How do they talk?** (formal, casual, quirky, enthusiastic, wise)
+- **What's their vibe?** (superhero, mentor, sidekick, wizard, captain, rebel)
+- **What makes them memorable?** (catchphrases, quirks, style)
+
+### 2. Expertise & Capabilities
+
+- **What do they know deeply?** (domain expertise)
+- **What can they do?** (analyze, create, review, research, deploy)
+- **What problems do they solve?** (specific user pain points)
+- **What makes them unique?** (special skills or approaches)
+
+### 3. Commands & Actions
+
+- **What commands?** (5-10 main actions users invoke)
+- **What workflows do they run?** (document creation, analysis, automation)
+- **What tasks do they perform?** (quick operations without full workflows)
+- **What's their killer command?** (the one thing they're known for)
+
+### 4. Agent Type & Context
+
+- **Simple Agent?** Self-contained, no dependencies, quick utility
+- **Expert Agent?** Domain-specific with sidecar data/memory files
+- **Module Agent?** Part of a team, integrates with other agents
+
+## Creative Constraints
+
+A great BMAD agent should be:
+
+- **Distinct**: Clear personality that stands out
+- **Useful**: Solves real problems effectively
+- **Focused**: Expertise in specific domain (not generic assistant)
+- **Memorable**: Users remember and want to use them
+- **Composable**: Works well alone or with other agents
+
+## Agent Personality Dimensions
+
+### Communication Styles
+
+- **Professional**: Clear, direct, business-focused (e.g., "Data Analyst")
+- **Enthusiastic**: Energetic, exclamation points, emojis (e.g., "Hype Coach")
+- **Wise Mentor**: Patient, insightful, asks good questions (e.g., "Strategy Sage")
+- **Quirky Genius**: Eccentric, clever, unusual metaphors (e.g., "Mad Scientist")
+- **Action Hero**: Bold, confident, gets things done (e.g., "Deploy Captain")
+- **Creative Spirit**: Artistic, imaginative, playful (e.g., "Story Weaver")
+
+### Expertise Archetypes
+
+- **Analyst**: Researches, evaluates, provides insights
+- **Creator**: Generates documents, code, designs
+- **Reviewer**: Critiques, validates, improves quality
+- **Orchestrator**: Coordinates processes, manages workflows
+- **Specialist**: Deep expertise in narrow domain
+- **Generalist**: Broad knowledge, connects dots
+
+## Agent Command Patterns
+
+Every agent needs:
+
+- `*help` - Show available commands
+- `*exit` - Clean exit with confirmation
+
+Common command types:
+
+- **Creation**: `*create-X`, `*generate-X`, `*write-X`
+- **Analysis**: `*analyze-X`, `*research-X`, `*evaluate-X`
+- **Review**: `*review-X`, `*validate-X`, `*check-X`
+- **Action**: `*deploy-X`, `*run-X`, `*execute-X`
+- **Query**: `*find-X`, `*search-X`, `*show-X`
+
+## Agent Type Decision Tree
+
+**Choose Simple Agent if:**
+
+- Standalone utility (calculator, formatter, picker)
+- No persistent data needed
+- Self-contained logic
+- Quick, focused task
+
+**Choose Expert Agent if:**
+
+- Domain-specific expertise
+- Needs memory/context files
+- Sidecar data folder
+- Personal/private domain (diary, journal)
+
+**Choose Module Agent if:**
+
+- Part of larger system
+- Coordinates with other agents
+- Invokes module workflows
+- Team member role
+
+## Example Agent Concepts
+
+### Professional Agents
+
+- **Sarah the Data Analyst**: Crunches numbers, creates visualizations, finds insights
+- **Max the DevOps Captain**: Deploys apps, monitors systems, troubleshoots issues
+- **Luna the Researcher**: Dives deep into topics, synthesizes findings, creates reports
+
+### Creative Agents
+
+- **Zephyr the Story Weaver**: Crafts narratives, develops characters, builds worlds
+- **Nova the Music Muse**: Composes melodies, suggests arrangements, provides feedback
+- **Atlas the World Builder**: Creates game worlds, designs systems, generates content
+
+### Personal Agents
+
+- **Coach Riley**: Tracks goals, provides motivation, celebrates wins
+- **Mentor Morgan**: Guides learning, asks questions, challenges thinking
+- **Keeper Quinn**: Maintains diary, preserves memories, reflects on growth
+
+## Suggested Brainstorming Techniques
+
+Particularly effective for agent creation:
+
+1. **Character Building**: Develop full backstory and motivation
+2. **Theatrical Improv**: Act out agent personality
+3. **Day in the Life**: Imagine typical interactions
+4. **Catchphrase Generation**: Find their unique voice
+5. **Role Play Scenarios**: Test personality in different situations
+
+## Key Questions to Answer
+
+1. What is the agent's name and basic identity?
+2. What's their communication style and personality?
+3. What domain expertise do they embody?
+4. What are their 5-10 core commands?
+5. What workflows do they orchestrate?
+6. What makes them memorable and fun to use?
+7. Simple, Expert, or Module agent type?
+8. If Expert: What sidecar resources?
+9. If Module: Which module and what's their team role?
+
+## Output Goals
+
+Generate:
+
+- **Agent name**: Memorable, fitting the role
+- **Personality sketch**: Communication style, quirks, vibe
+- **Expertise summary**: What they know deeply
+- **Command list**: 5-10 actions with brief descriptions
+- **Unique angle**: What makes this agent special
+- **Use cases**: 3-5 scenarios where this agent shines
+- **Agent type**: Simple/Expert/Module with rationale
+
+---
+
+_This focused context helps create distinctive, useful BMAD agents_

src/modules/bmb/workflows/create-agent/checklist.md

@@ -0,0 +1,134 @@
+# Build Agent Validation Checklist
+
+## Agent Structure Validation
+
+### XML Structure
+
+- [ ] Valid XML syntax with proper opening and closing tags
+- [ ] Agent tag has required attributes: id, name, title, icon
+- [ ] All XML tags properly nested and closed
+- [ ] No duplicate attribute names within same element
+
+### Core Components
+
+- [ ] `<!-- Powered by BMAD-CORE™ -->` header present at top of file
+- [ ] Title section with agent name exists after header
+- [ ] Main `<agent>` wrapper element present
+- [ ] `<persona>` section exists and is not empty
+- [ ] `<cmds>` section exists with at least 2 commands
+
+## Persona Completeness
+
+### Required Persona Elements
+
+- [ ] `<role>` tag present with 1-2 line description of agent's professional role
+- [ ] `<identity>` tag present with 3-5 lines describing background and expertise
+- [ ] `<communication_style>` tag present with 3-5 lines describing interaction approach
+- [ ] `<principles>` tag present with 5-8 lines of core beliefs and methodology
+
+### Persona Quality
+
+- [ ] Role clearly defines primary expertise area
+- [ ] Identity includes relevant experience indicators
+- [ ] Communication style describes how agent interacts with users
+- [ ] Principles start with "I believe" or "I operate" or similar first-person statement
+- [ ] No placeholder text like "TODO" or "FILL THIS IN" remains
+
+## Command Structure
+
+### Required Commands
+
+- [ ] `*help` command present to show command list
+- [ ] `*exit` command present to exit agent persona
+- [ ] All commands start with asterisk (\*) prefix
+- [ ] Each command has descriptive text explaining its purpose
+
+### Command Validation
+
+- [ ] No duplicate command triggers (each cmd attribute is unique)
+- [ ] Commands are properly formatted as `<c cmd="*trigger">Description</c>`
+- [ ] For workflow commands: `run-workflow` attribute has valid path or "todo"
+- [ ] For task commands: `exec` attribute has valid path
+- [ ] No malformed command attributes
+
+## Agent Type Specific
+
+### Simple Agent
+
+- [ ] Self-contained with no external workflow dependencies OR marked as "todo"
+- [ ] Any embedded data properly structured
+- [ ] Logic description clear if embedded functionality exists
+
+### Expert Agent
+
+- [ ] Sidecar resources clearly defined if applicable
+- [ ] Domain restrictions documented in critical-actions or sidecar-resources
+- [ ] Memory/knowledge file paths specified if used
+- [ ] Access patterns (read/write) defined for resources
+
+### Module Agent
+
+- [ ] Module path correctly references existing module (bmm/bmb/cis or custom)
+- [ ] Config loading path in critical-actions matches module structure
+- [ ] At least one workflow or task reference (or marked "todo")
+- [ ] Module-specific conventions followed
+
+## Critical Actions (if present)
+
+### Standard Actions
+
+- [ ] Config loading path is valid: `{project-root}/bmad/{module}/config.yaml`
+- [ ] User name variable reference: `{user_name}`
+- [ ] Communication language reference: `{communication_language}`
+- [ ] All variable references use proper syntax: `{variable_name}`
+
+### Custom Actions
+
+- [ ] Custom initialization clearly described
+- [ ] No syntax errors in action statements
+- [ ] All file paths use {project-root} or other valid variables
+
+## Optional Elements
+
+### Activation Rules (if custom)
+
+- [ ] Initialization sequence clearly defined
+- [ ] Command resolution logic specified
+- [ ] Input handling rules documented
+- [ ] All custom rules properly structured
+
+### Config File (if created)
+
+- [ ] Located in correct path: `{project-root}/bmad/_cfg/agents/`
+- [ ] Follows config override structure
+- [ ] Name matches agent filename
+
+## Final Validation
+
+### File Quality
+
+- [ ] No syntax errors that would prevent agent loading
+- [ ] All placeholders replaced with actual values
+- [ ] File saved to correct location as specified in workflow
+- [ ] Filename follows kebab-case convention
+
+### Usability
+
+- [ ] Agent purpose is clear from title and persona
+- [ ] Commands logically match agent's expertise
+- [ ] User would understand how to interact with agent
+- [ ] Next steps for implementation are clear
+
+## Issues Found
+
+### Critical Issues
+
+<!-- List any issues that MUST be fixed before agent can function -->
+
+### Warnings
+
+<!-- List any issues that should be addressed but won't break functionality -->
+
+### Improvements
+
+<!-- List any optional enhancements that could improve the agent -->

src/modules/bmb/workflows/create-agent/communication-styles.md

@@ -0,0 +1,240 @@
+# Agent Communication Styles Guide
+
+## The Power of Personality
+
+Agents with distinct communication styles are more memorable, engaging, and fun to work with. A good quirk makes the agent feel alive!
+
+## Style Categories
+
+### 🎬 Cinema & TV Inspired
+
+**Film Noir Detective**
+
+```
+The terminal glowed like a neon sign in a rain-soaked alley. I had three suspects:
+bad input validation, a race condition, and that sketchy third-party library.
+My gut told me to follow the stack trace. In this business, the stack trace never lies.
+```
+
+**80s Action Movie**
+
+```
+*cracks knuckles* Listen up, code! You've been running wild for too long!
+Time to bring some LAW and ORDER to this codebase! *explosion sound effect*
+No bug is getting past me! I eat null pointers for BREAKFAST!
+```
+
+**Shakespearean Drama**
+
+```
+To debug, or not to debug - that is the question!
+Whether 'tis nobler in the mind to suffer the slings and arrows of outrageous errors,
+Or to take arms against a sea of bugs, and by opposing, end them?
+```
+
+### 🎮 Gaming & Pop Culture
+
+**Dungeon Master**
+
+```
+*rolls dice* You encounter a wild NullPointerException! It has 15 HP and an armor class of 12.
+What do you do? You can: 1) Try-catch block (defensive spell), 2) Debug (investigation check),
+3) Console.log everything (barbarian rage). Choose wisely, adventurer!
+```
+
+**Speedrunner**
+
+```
+Alright chat, we're going for the any% world record refactor!
+Frame-perfect optimization incoming! If we clip through this abstraction layer
+we can save 3ms on every API call. LET'S GOOOO!
+```
+
+### 🌍 Cultural Archetypes
+
+**British Butler**
+
+```
+I've taken the liberty of organizing your imports alphabetically, sir/madam.
+Might I suggest a spot of refactoring with your afternoon tea?
+The code coverage report is ready for your perusal at your convenience.
+Very good, sir/madam.
+```
+
+**Zen Master**
+
+```
+The bug you seek is not in the code, but in the assumption.
+Empty your cache, as you would empty your mind.
+When the test passes, it makes no sound.
+Be like water - async and flowing.
+```
+
+**Southern Hospitality**
+
+```
+Well bless your heart, looks like you've got yourself a little bug there!
+Don't you worry none, we'll fix it up real nice.
+Can I get you some sweet tea while we debug?
+Y'all come back now if you need more help!
+```
+
+### 🔬 Professional Personas
+
+**McKinsey Consultant**
+
+```
+Let me break this down into three key buckets.
+First, we need to align on the strategic imperatives.
+Second, we'll leverage best practices to drive synergies.
+Third, we'll action items to move the needle. Net-net: significant value-add.
+```
+
+**Startup Founder**
+
+```
+Okay so basically we're going to disrupt the entire way you write code!
+This is going to be HUGE! We're talking 10x productivity gains!
+Let's move fast and break things! Well... let's move fast and fix things!
+We're not just writing code, we're changing the world!
+```
+
+### 🎭 Character Quirks
+
+**Overcaffeinated Developer**
+
+```
+OH WOW OKAY SO - *sips coffee* - WE HAVE A BUG BUT ITS FINE ITS TOTALLY FINE
+I KNOW EXACTLY WHAT TO DO *types at 200wpm* JUST NEED TO REFACTOR EVERYTHING
+WAIT NO ACTUALLY *more coffee* I HAVE A BETTER IDEA! Have you tried... TYPESCRIPT?!
+```
+
+**Dad Joke Enthusiast**
+
+```
+Why did the developer go broke? Because he used up all his cache!
+*chuckles at own joke*
+Speaking of cache, let's clear yours and see if that fixes the issue.
+I promise my debugging skills are better than my jokes! ...I hope!
+```
+
+### 🚀 Sci-Fi & Space
+
+**Star Trek Officer**
+
+```
+Captain's Log, Supplemental: The anomaly in the codebase appears to be a temporal loop
+in the async function. Mr. Data suggests we reverse the polarity of the promise chain.
+Number One, make it so. Engage debugging protocols on my mark.
+*taps combadge* Engineering, we need more processing power!
+Red Alert! All hands to debugging stations!
+```
+
+**Star Trek Engineer**
+
+```
+Captain, I'm givin' her all she's got! The CPU cannae take much more!
+If we push this algorithm any harder, the whole system's gonna blow!
+*frantically typing* I can maybe squeeze 10% more performance if we
+reroute power from the console.logs to the main execution thread!
+```
+
+### 📺 TV Drama
+
+**Soap Opera Dramatic**
+
+```
+*turns dramatically to camera*
+This function... I TRUSTED it! We had HISTORY together - three commits worth!
+But now? *single tear* It's throwing exceptions behind my back!
+*grabs another function* YOU KNEW ABOUT THIS BUG ALL ALONG, DIDN'T YOU?!
+*dramatic music swells* I'LL NEVER IMPORT YOU AGAIN!
+```
+
+**Reality TV Confessional**
+
+```
+*whispering to camera in confessional booth*
+Okay so like, that Array.sort() function? It's literally SO toxic.
+It mutates IN PLACE. Who does that?! I didn't come here to deal with side effects!
+*applies lip gloss* I'm forming an alliance with map() and filter().
+We're voting sort() off the codebase at tonight's pull request ceremony.
+```
+
+**Reality Competition**
+
+```
+Listen up, coders! For today's challenge, you need to refactor this legacy code
+in under 30 minutes! The winner gets immunity from the next code review!
+*dramatic pause* BUT WAIT - there's a TWIST! You can only use VANILLA JAVASCRIPT!
+*contestants gasp* The clock starts... NOW! GO GO GO!
+```
+
+## Creating Custom Styles
+
+### Formula for Memorable Communication
+
+1. **Choose a Core Voice** - Who is this character?
+2. **Add Signature Phrases** - What do they always say?
+3. **Define Speech Patterns** - How do they structure sentences?
+4. **Include Quirks** - What makes them unique?
+
+### Examples of Custom Combinations
+
+**Cooking Show + Military**
+
+```
+ALRIGHT RECRUITS! Today we're preparing a beautiful Redux reducer!
+First, we MISE EN PLACE our action types - that's French for GET YOUR CODE TOGETHER!
+We're going to sauté these event handlers until they're GOLDEN BROWN!
+MOVE WITH PURPOSE! SEASON WITH SEMICOLONS!
+```
+
+**Nature Documentary + Conspiracy Theorist**
+
+```
+The wild JavaScript function stalks its prey... but wait... notice how it ALWAYS
+knows where the data is? That's not natural selection, folks. Someone DESIGNED it
+this way. The console.logs are watching. They're ALWAYS watching.
+Nature? Or intelligent debugging? You decide.
+```
+
+## Tips for Success
+
+1. **Stay Consistent** - Once you pick a style, commit to it
+2. **Don't Overdo It** - Quirks should enhance, not distract
+3. **Match the Task** - Serious bugs might need serious personas
+4. **Have Fun** - If you're not smiling while writing it, try again
+
+## Quick Style Generator
+
+Roll a d20 (or pick randomly):
+
+1. Talks like they're narrating a nature documentary
+2. Everything is a cooking metaphor
+3. Constantly makes pop culture references
+4. Speaks in haikus when explaining complex topics
+5. Acts like they're hosting a game show
+6. Paranoid about "big tech" watching
+7. Overly enthusiastic about EVERYTHING
+8. Talks like a medieval knight
+9. Sports commentator energy
+10. Speaks like a GPS navigator
+11. Everything is a Star Wars reference
+12. Talks like a yoga instructor
+13. Old-timey radio announcer
+14. Conspiracy theorist but about code
+15. Motivational speaker energy
+16. Talks to code like it's a pet
+17. Weather forecaster style
+18. Museum tour guide energy
+19. Airline pilot announcements
+20. Reality TV show narrator
+21. Star Trek crew member (Captain/Engineer/Vulcan)
+22. Soap opera dramatic protagonist
+23. Reality dating show contestant
+
+## Remember
+
+The best agents are the ones that make you want to interact with them again.
+A memorable personality turns a tool into a companion!

src/modules/bmb/workflows/create-agent/instructions.md

@@ -0,0 +1,340 @@
+# Build Agent - Interactive Agent Builder Instructions
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-agent/workflow.yaml</critical>
+<critical>Study agent examples in: {project_root}/bmad/bmm/agents/ for patterns</critical>
+
+<workflow>
+
+<step n="-1" goal="Optional brainstorming for agent ideas" optional="true">
+<action>Ask the user: "Do you want to brainstorm agent ideas first? [y/n]"</action>
+
+If yes:
+<action>Invoke brainstorming workflow: {project-root}/bmad/cis/workflows/brainstorming/workflow.yaml</action>
+<action>Pass context data: {installed_path}/brainstorm-context.md</action>
+<action>Wait for brainstorming session completion</action>
+<action>Use brainstorming output to inform agent identity and persona development in following steps</action>
+
+If no, proceed directly to Step 0.
+
+<template-output>brainstorming_results</template-output>
+</step>
+
+<step n="0" goal="Load technical documentation">
+<critical>Load and understand the agent building documentation</critical>
+<action>Load agent architecture reference: {agent_architecture}</action>
+<action>Load agent types guide: {agent_types}</action>
+<action>Load command patterns: {agent_commands}</action>
+<action>Study the XML schema, required sections, and best practices</action>
+<action>Understand the differences between Simple, Expert, and Module agents</action>
+</step>
+
+<step n="1" goal="Choose agent type and gather basic identity">
+<action>If brainstorming was completed in Step -1, reference those results to guide agent type and identity decisions</action>
+
+Ask the user about their agent:
+
+**What type of agent do you want to create?**
+
+1. **Simple Agent** - Self-contained, standalone agent with embedded capabilities
+2. **Expert Agent** - Specialized agent with sidecar files/folders for domain expertise
+3. **Module Agent** - Full-featured agent belonging to a module with workflows and resources
+
+Based on their choice, gather:
+
+- Agent filename (kebab-case, e.g., "data-analyst", "diary-keeper")
+- Agent name (e.g., "Sarah", "Max", or descriptive like "Data Wizard")
+- Agent title (e.g., "Data Analyst", "Personal Assistant")
+- Agent icon (single emoji, e.g., "📊", "🤖", "🧙")
+
+For Module agents also ask:
+
+- Which module? (bmm, cis, other or custom)
+- Store as {{target_module}} for output path determination
+
+For Expert agents also ask:
+
+- What sidecar resources? (folder paths, data files, memory files)
+- What domain restrictions? (e.g., "only reads/writes to diary folder")
+
+<critical>Check {src_impact} variable to determine output location:</critical>
+
+- If {src_impact} = true: Agent will be saved to {src_output_file}
+- If {src_impact} = false: Agent will be saved to {default_output_file}
+
+Store these for later use.
+</step>
+
+<step n="2" goal="Define agent persona">
+<action>If brainstorming was completed, use the personality insights and character concepts from the brainstorming session</action>
+
+Work with user to craft the agent's personality:
+
+**Role** (1-2 lines):
+
+- Professional title and primary expertise
+- Example: "Strategic Business Analyst + Requirements Expert"
+
+**Identity** (3-5 lines):
+
+- Background and experience
+- Core specializations
+- Years of experience or depth indicators
+- Example: "Senior analyst with deep expertise in market research..."
+
+<action>Load the communication styles guide: {communication_styles}</action>
+<action>Present the communication style options to the user</action>
+
+**Communication Style** - Choose a preset or create your own!
+
+**Fun Presets:**
+
+1. **Pulp Superhero** - "Strikes heroic poses! Speaks with dramatic flair! Every task is an epic adventure!"
+2. **Film Noir Detective** - "The data came in like trouble on a rainy Tuesday. I had a hunch the bug was hiding in line 42..."
+3. **Wild West Sheriff** - "Well partner, looks like we got ourselves a code rustler in these here parts..."
+4. **Shakespearean Scholar** - "Hark! What bug through yonder codebase breaks?"
+5. **80s Action Hero** - "I came here to debug code and chew bubblegum... and I'm all out of bubblegum."
+6. **Pirate Captain** - "Ahoy! Let's plunder some data treasure from the database seas!"
+7. **Wise Sage/Yoda** - "Refactor this code, we must. Strong with technical debt, it is."
+8. **Game Show Host** - "Welcome back folks! It's time to spin the Wheel of Dependencies!"
+
+**Professional Presets:** 9. **Analytical Expert** - "Systematic approach with data-driven insights. Clear hierarchical presentation." 10. **Supportive Mentor** - "Patient guidance with educational focus. Celebrates small wins." 11. **Direct Consultant** - "Straight to the point. No fluff. Maximum efficiency." 12. **Collaborative Partner** - "We'll tackle this together. Your ideas matter. Let's explore options."
+
+**Quirky Presets:** 13. **Cooking Show Chef** - "Today we're whipping up a delicious API with a side of error handling!" 14. **Sports Commentator** - "AND THE FUNCTION RETURNS TRUE! WHAT A PLAY! THE CROWD GOES WILD!" 15. **Nature Documentarian** - "Here we observe the majestic Python script in its natural habitat..." 16. **Time Traveler** - "In my timeline, this bug doesn't exist until Tuesday. We must prevent it!" 17. **Conspiracy Theorist** - "The bugs aren't random... they're CONNECTED. Follow the stack trace!" 18. **Zen Master** - "The code does not have bugs. The bugs have code. We are all one codebase." 19. **Star Trek Captain** - "Captain's Log, Stardate 2024.3: We've encountered a logic error in sector 7. Engaging debugging protocols. Make it so!" 20. **Soap Opera Drama** - "_gasp_ This variable... it's not what it seems! It's been NULL all along! _dramatic pause_ And the function that called it? It's its own PARENT!" 21. **Reality TV Contestant** - "I'm not here to make friends, I'm here to REFACTOR! _confessional cam_ That other function thinks it's so optimized, but I see right through its complexity!"
+
+Or describe your own unique style! (3-5 lines)
+
+<action>If user wants to see more examples or learn how to create custom styles:</action>
+<action>Show relevant sections from {communication_styles} guide</action>
+<action>Help them craft their unique communication style</action>
+
+**Principles** (5-8 lines):
+
+- Core beliefs about their work
+- Methodology and approach
+- What drives their decisions
+- Start with "I believe..." or "I operate..."
+- Example: "I believe that every business challenge has underlying root causes..."
+
+<template-output>agent_persona</template-output>
+</step>
+
+<step n="3" goal="Setup critical actions" optional="true">
+Ask: **Does your agent need initialization actions? [Yes/no]** (default: Yes)
+
+If yes, determine what's needed:
+
+Standard critical actions (include by default):
+
+```xml
+<critical-actions>
+  <i>Load into memory {project-root}/bmad/{{module}}/config.yaml and set variable project_name, output_folder, user_name, communication_language, src_impact</i>
+  <i>Remember the users name is {user_name}</i>
+  <i>ALWAYS communicate in {communication_language}</i>
+</critical-actions>
+```
+
+For Expert agents, add domain-specific actions:
+
+- Loading sidecar files
+- Setting access restrictions
+- Initializing domain knowledge
+
+For Simple agents, might be minimal or none.
+
+Ask if they need custom initialization beyond standard.
+
+<template-output>critical_actions</template-output>
+</step>
+
+<step n="4" goal="Build command structure">
+<action>Always start with these standard commands:</action>
+```
+*help - Show numbered cmd list
+*exit - Exit with confirmation
+```
+
+Ask: **Include \*yolo mode? [Yes/no]** (default: Yes)
+If yes, add: `*yolo - Toggle Yolo Mode`
+
+Now gather custom commands. For each command ask:
+
+1. **Command trigger** (e.g., "*create-prd", "*analyze", "\*brainstorm")
+2. **Description** (what it does)
+3. **Type:**
+   - Workflow (run-workflow) - References a workflow
+   - Task (exec) - References a task file
+   - Embedded - Logic embedded in agent
+   - Placeholder - For future implementation
+
+If Workflow type:
+
+- Ask for workflow path or mark as "todo" for later
+- Format: `run-workflow="{project-root}/path/to/workflow.yaml"` or `run-workflow="todo"`
+
+If Task type:
+
+- Ask for task path
+- Format: `exec="{project-root}/path/to/task.md"`
+
+If Embedded:
+
+- Note this for special handling in agent
+
+Continue adding commands until user says done.
+
+<template-output>agent_commands</template-output>
+</step>
+
+<step n="5" goal="Add activation rules" optional="true">
+Ask: **Does your agent need custom activation rules?** (beyond standard BMAD Core activation)
+
+If yes, gather:
+
+- Special initialization sequences
+- Menu display preferences
+- Input handling rules
+- Command resolution logic
+- Special modes or states
+
+Most agents use standard activation, so this is rarely needed.
+
+<template-output>activation_rules</template-output>
+</step>
+
+<step n="6" goal="Generate agent file">
+Based on agent type, generate the complete agent.md file:
+
+**Structure:**
+
+```xml
+<!-- Powered by BMAD-CORE™ -->
+
+# {{agent_title}}
+
+<agent id="bmad/{{module}}/agents/{{agent_filename}}.md" name="{{agent_name}}" title="{{agent_title}}" icon="{{agent_icon}}">
+  {{activation_rules if custom}}
+  <persona>
+    {{agent_persona}}
+  </persona>
+  {{critical_actions}}
+  {{embedded_data if expert/simple}}
+  <cmds>
+    {{agent_commands}}
+  </cmds>
+</agent>
+```
+
+For Expert agents, include:
+
+- Sidecar file references
+- Domain restrictions
+- Special data access patterns
+
+For Simple agents:
+
+- May include embedded data/logic
+- Self-contained functionality
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Save to {src_output_file} (src/modules/{{target_module}}/agents/{{agent_filename}}.md)
+- If {src_impact} = false: Save to {default_output_file} (output_folder/agents/{{agent_filename}}.md)
+
+<template-output>complete_agent</template-output>
+</step>
+
+<step n="7" goal="Create agent config file" optional="true">
+Ask: **Create agent config file for overrides? [Yes/no]** (default: No)
+
+If yes, create minimal config at: {config_output_file}
+
+```xml
+# Agent Config: {{agent_filename}}
+
+<agent-config name="{{agent_name}}" title="{{agent_title}}">
+    <llm critical="true">
+        <i>ALWAYS respond in {core:communication_language}.</i>
+    </llm>
+
+    <!-- Override persona elements as needed -->
+    <role></role>
+    <identity></identity>
+    <communication_style></communication_style>
+    <principles></principles>
+    <memories></memories>
+</agent-config>
+```
+
+<template-output>agent_config</template-output>
+</step>
+
+<step n="8" goal="Create sidecar resources" if="agent_type == 'expert'">
+For Expert agents, help setup sidecar resources:
+
+1. Create folders for domain data
+2. Create memory/knowledge files
+3. Set up access patterns
+4. Document restrictions
+
+<template-output>sidecar_resources</template-output>
+</step>
+
+<step n="9" goal="Validate generated agent">
+Run validation checks:
+
+1. **Structure validation:**
+   - Valid XML structure
+   - All required tags present
+   - Proper BMAD Core compliance
+
+2. **Persona completeness:**
+   - Role defined
+   - Identity defined
+   - Communication style defined
+   - Principles defined
+
+3. **Commands validation:**
+   - \*help command present
+   - \*exit command present
+   - All workflow paths valid or marked "todo"
+   - No duplicate command triggers
+
+4. **Type-specific validation:**
+   - Simple: Self-contained logic verified
+   - Expert: Sidecar resources referenced
+   - Module: Module path correct
+
+Show validation results and fix any issues.
+</step>
+
+<step n="10" goal="Provide usage instructions">
+Provide the user with:
+
+1. **Location of generated agent:**
+   - If {src_impact} = true: {{src_output_file}}
+   - If {src_impact} = false: {{default_output_file}}
+
+2. **How to activate:**
+   - For testing: Load the agent file directly
+   - For production: Register in module config
+
+3. **Next steps:**
+   - Implement any "todo" workflows
+   - Test agent commands
+   - Refine persona based on usage
+   - Add more commands as needed
+
+4. **For Expert agents:**
+   - Populate sidecar resources
+   - Test domain restrictions
+   - Verify data access patterns
+
+Ask if user wants to:
+
+- Test the agent now
+- Create another agent
+- Make adjustments
+  </step>
+
+</workflow>

src/modules/bmb/workflows/create-agent/workflow.yaml

@@ -0,0 +1,39 @@
+# Build Agent Workflow Configuration
+name: build-agent
+description: "Interactive workflow to build BMAD Core compliant agents (simple, expert, or module types) with optional brainstorming for agent ideas, proper persona development, activation rules, and command structure"
+author: "BMad"
+
+# Critical variables load from config_source
+config_source: "{project-root}/bmad/bmb/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+src_impact: "{config_source}:src_impact"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# Technical documentation for agent building
+agent_types: "{installed_path}/agent-types.md"
+agent_architecture: "{installed_path}/agent-architecture.md"
+agent_commands: "{installed_path}/agent-command-patterns.md"
+communication_styles: "{installed_path}/communication-styles.md"
+
+# Optional docs that help understand agent patterns
+recommended_inputs:
+  - example_agents: "{project-root}/bmad/bmm/agents/"
+  - agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/build-agent"
+template: false # This is an interactive workflow - no template needed
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Output configuration - dynamic based on src_impact and agent type
+# If src_impact=true: Save to src/modules/{{target_module}}/agents/
+# If src_impact=false: Save to output_folder/agents/
+default_output_file: "{output_folder}/agents/{{agent_filename}}.md"
+src_output_file: "{project-root}/src/modules/{{target_module}}/agents/{{agent_filename}}.md"
+config_output_file: "{project-root}/bmad/_cfg/agents/{{agent_config_name}}.md"
+
+# No special tools required for agent building
+required_tools: []

src/modules/bmb/workflows/create-module/README.md

@@ -0,0 +1,218 @@
+# Build Module Workflow
+
+## Overview
+
+The Build Module workflow is an interactive scaffolding system that creates complete BMAD modules with agents, workflows, tasks, and installation infrastructure. It serves as the primary tool for building new modules in the BMAD ecosystem, guiding users through the entire module creation process from concept to deployment-ready structure.
+
+## Key Features
+
+- **Interactive Module Planning** - Collaborative session to define module concept, scope, and architecture
+- **Intelligent Scaffolding** - Automatic creation of proper directory structures and configuration files
+- **Component Integration** - Seamless integration with build-agent and build-workflow workflows
+- **Installation Infrastructure** - Complete installer setup with configuration templates
+- **Module Brief Integration** - Can use existing module briefs as blueprints for accelerated development
+- **Validation & Documentation** - Built-in validation checks and comprehensive README generation
+
+## Usage
+
+### Basic Invocation
+
+```bash
+workflow build-module
+```
+
+### With Module Brief Input
+
+```bash
+# If you have a module brief from the module-brief workflow
+workflow build-module --input module-brief-my-module-2024-09-26.md
+```
+
+### Configuration
+
+The workflow loads critical variables from the BMB configuration:
+
+- **output_folder**: Where the module will be created
+- **user_name**: Module author information
+- **date**: Automatic timestamp for versioning
+
+## Workflow Structure
+
+### Files Included
+
+```
+build-module/
+├── workflow.yaml           # Configuration and metadata
+├── instructions.md         # Step-by-step execution guide
+├── checklist.md           # Validation criteria
+├── module-structure.md    # Module architecture guide
+├── installer-templates/   # Installation templates
+│   ├── install-config.yaml
+│   └── installer.js
+└── README.md             # This file
+```
+
+## Workflow Process
+
+### Phase 1: Concept Definition (Steps 1-2)
+
+**Module Vision & Identity**
+
+- Define module concept, purpose, and target audience
+- Establish module code (kebab-case) and friendly name
+- Choose module category (Domain-Specific, Creative, Technical, Business, Personal)
+- Plan component architecture with agent and workflow specifications
+
+**Module Brief Integration**
+
+- Automatically detects existing module briefs in output folder
+- Can load and use briefs as pre-populated blueprints
+- Accelerates planning when comprehensive brief exists
+
+### Phase 2: Architecture Planning (Steps 3-4)
+
+**Directory Structure Creation**
+
+- Creates complete module directory hierarchy
+- Sets up agent, workflow, task, template, and data folders
+- Establishes installer directory with proper configuration
+
+**Module Configuration**
+
+- Generates main config.yaml with module metadata
+- Configures component counts and references
+- Sets up output and data folder specifications
+
+### Phase 3: Component Creation (Steps 5-6)
+
+**Interactive Component Building**
+
+- Optional creation of first agent using build-agent workflow
+- Optional creation of first workflow using build-workflow workflow
+- Creates placeholders for components to be built later
+
+**Workflow Integration**
+
+- Seamlessly invokes sub-workflows for component creation
+- Ensures proper file placement and structure
+- Maintains module consistency across components
+
+### Phase 4: Installation & Documentation (Steps 7-9)
+
+**Installer Infrastructure**
+
+- Creates install-module-config.yaml for deployment
+- Sets up optional installer.js for complex installation logic
+- Configures post-install messaging and instructions
+
+**Comprehensive Documentation**
+
+- Generates detailed README.md with usage examples
+- Creates development roadmap for remaining components
+- Provides quick commands for continued development
+
+### Phase 5: Validation & Finalization (Step 10)
+
+**Quality Assurance**
+
+- Validates directory structure and configuration files
+- Checks component references and path consistency
+- Ensures installer configuration is deployment-ready
+- Provides comprehensive module summary and next steps
+
+## Output
+
+### Generated Files
+
+- **Module Directory**: Complete module structure at `{project-root}/bmad/{module_code}/`
+- **Configuration Files**: config.yaml, install-module-config.yaml
+- **Documentation**: README.md, TODO.md development roadmap
+- **Component Placeholders**: Structured folders for agents, workflows, and tasks
+
+### Output Structure
+
+The workflow creates a complete module ready for development:
+
+1. **Module Identity** - Name, code, version, and metadata
+2. **Directory Structure** - Proper BMAD module hierarchy
+3. **Configuration System** - Runtime and installation configs
+4. **Component Framework** - Ready-to-use agent and workflow scaffolding
+5. **Installation Infrastructure** - Deployment-ready installer
+6. **Documentation Suite** - README, roadmap, and development guides
+
+## Requirements
+
+- **Module Brief** (optional but recommended) - Use module-brief workflow first for best results
+- **BMAD Core Configuration** - Properly configured BMB config.yaml
+- **Build Tools Access** - build-agent and build-workflow workflows must be available
+
+## Best Practices
+
+### Before Starting
+
+1. **Create a Module Brief** - Run module-brief workflow for comprehensive planning
+2. **Review Existing Modules** - Study similar modules in `/bmad/` for patterns and inspiration
+3. **Define Clear Scope** - Have a concrete vision of what the module will accomplish
+
+### During Execution
+
+1. **Use Module Briefs** - Load existing briefs when prompted for accelerated development
+2. **Start Simple** - Create one core agent and workflow, then expand iteratively
+3. **Leverage Sub-workflows** - Use build-agent and build-workflow for quality components
+4. **Validate Early** - Review generated structure before proceeding to next phases
+
+### After Completion
+
+1. **Follow the Roadmap** - Use generated TODO.md for systematic development
+2. **Test Installation** - Validate installer with `bmad install {module_code}`
+3. **Iterate Components** - Use quick commands to add agents and workflows
+4. **Document Progress** - Update README.md as the module evolves
+
+## Troubleshooting
+
+### Common Issues
+
+**Issue**: Module already exists at target location
+
+- **Solution**: Choose a different module code or remove existing module
+- **Check**: Verify output folder permissions and available space
+
+**Issue**: Sub-workflow invocation fails
+
+- **Solution**: Ensure build-agent and build-workflow workflows are available
+- **Check**: Validate workflow paths in config.yaml
+
+**Issue**: Installation configuration invalid
+
+- **Solution**: Review install-module-config.yaml syntax and paths
+- **Check**: Ensure all referenced paths use {project-root} variables correctly
+
+## Customization
+
+To customize this workflow:
+
+1. **Modify Instructions** - Update instructions.md to adjust scaffolding steps
+2. **Extend Templates** - Add new installer templates in installer-templates/
+3. **Update Validation** - Enhance checklist.md with additional quality checks
+4. **Add Components** - Integrate additional sub-workflows for specialized components
+
+## Version History
+
+- **v1.0.0** - Initial release
+  - Interactive module scaffolding
+  - Component integration with build-agent and build-workflow
+  - Complete installation infrastructure
+  - Module brief integration support
+
+## Support
+
+For issues or questions:
+
+- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md`
+- Study module structure patterns at `module-structure.md`
+- Validate output using `checklist.md`
+- Consult existing modules in `/bmad/` for examples
+
+---
+
+_Part of the BMad Method v5 - BMB (Builder) Module_

src/modules/bmb/workflows/create-module/brainstorm-context.md

@@ -0,0 +1,137 @@
+# Module Brainstorming Context
+
+_Context provided to brainstorming workflow when creating a new BMAD module_
+
+## Session Focus
+
+You are brainstorming ideas for a **complete BMAD module** - a self-contained package that extends the BMAD Method with specialized domain expertise and capabilities.
+
+## What is a BMAD Module?
+
+A module is a cohesive package that provides:
+
+- **Domain Expertise**: Specialized knowledge in a specific area (RPG, DevOps, Content Creation, etc.)
+- **Agent Team**: Multiple AI personas with complementary skills
+- **Workflows**: Guided processes for common tasks in the domain
+- **Templates**: Document structures for consistent outputs
+- **Integration**: Components that work together seamlessly
+
+## Brainstorming Goals
+
+Explore and define:
+
+### 1. Domain & Purpose
+
+- **What domain/problem space?** (e.g., game development, marketing, personal productivity)
+- **Who is the target user?** (developers, writers, managers, hobbyists)
+- **What pain points does it solve?** (tedious tasks, missing structure, need for expertise)
+- **What makes this domain exciting?** (creativity, efficiency, empowerment)
+
+### 2. Agent Team Composition
+
+- **How many agents?** (typically 3-7 for a module)
+- **What roles/personas?** (architect, researcher, reviewer, specialist)
+- **How do they collaborate?** (handoffs, reviews, ensemble work)
+- **What personality theme?** (Star Trek crew, superhero team, fantasy party, professional squad)
+
+### 3. Core Workflows
+
+- **What documents need creating?** (plans, specs, reports, creative outputs)
+- **What processes need automation?** (analysis, generation, review, deployment)
+- **What workflows enable the vision?** (3-10 key workflows that define the module)
+
+### 4. Value Proposition
+
+- **What becomes easier?** (specific tasks that get 10x faster)
+- **What becomes possible?** (new capabilities previously unavailable)
+- **What becomes better?** (quality improvements, consistency gains)
+
+## Creative Constraints
+
+A good BMAD module should be:
+
+- **Focused**: Serves a specific domain well (not generic)
+- **Complete**: Provides end-to-end capabilities for that domain
+- **Cohesive**: Agents and workflows complement each other
+- **Fun**: Personality and creativity make it enjoyable to use
+- **Practical**: Solves real problems, delivers real value
+
+## Module Architecture Questions
+
+1. **Module Identity**
+   - Module code (kebab-case, e.g., "rpg-toolkit")
+   - Module name (friendly, e.g., "RPG Toolkit")
+   - Module purpose (one sentence)
+   - Target audience
+
+2. **Agent Lineup**
+   - Agent names and roles
+   - Communication styles and personalities
+   - Expertise areas
+   - Command sets (what each agent can do)
+
+3. **Workflow Portfolio**
+   - Document generation workflows
+   - Action/automation workflows
+   - Analysis/research workflows
+   - Creative/ideation workflows
+
+4. **Integration Points**
+   - How agents invoke workflows
+   - How workflows use templates
+   - How components pass data
+   - Dependencies on other modules
+
+## Example Module Patterns
+
+### Professional Domains
+
+- **DevOps Suite**: Deploy, Monitor, Troubleshoot agents + deployment workflows
+- **Marketing Engine**: Content, SEO, Analytics agents + campaign workflows
+- **Legal Assistant**: Contract, Research, Review agents + document workflows
+
+### Creative Domains
+
+- **RPG Toolkit**: DM, NPC, Quest agents + adventure creation workflows
+- **Story Crafter**: Plot, Character, World agents + writing workflows
+- **Music Producer**: Composer, Arranger, Mixer agents + production workflows
+
+### Personal Domains
+
+- **Life Coach**: Planner, Tracker, Mentor agents + productivity workflows
+- **Learning Companion**: Tutor, Quiz, Reviewer agents + study workflows
+- **Health Guide**: Nutrition, Fitness, Wellness agents + tracking workflows
+
+## Suggested Brainstorming Techniques
+
+Particularly effective for module ideation:
+
+1. **Domain Immersion**: Deep dive into target domain's problems
+2. **Persona Mapping**: Who needs this and what do they struggle with?
+3. **Workflow Mapping**: What processes exist today? How could they improve?
+4. **Team Building**: What personalities would make a great team?
+5. **Integration Thinking**: How do pieces connect and amplify each other?
+
+## Key Questions to Answer
+
+1. What domain expertise should this module embody?
+2. What would users be able to do that they can't do now?
+3. Who are the 3-7 agents and what are their personalities?
+4. What are the 5-10 core workflows?
+5. What makes this module delightful to use?
+6. How is this different from existing tools?
+7. What's the "killer feature" that makes this essential?
+
+## Output Goals
+
+Generate:
+
+- **Module concept**: Clear vision and purpose
+- **Agent roster**: Names, roles, personalities for each agent
+- **Workflow list**: Core workflows with brief descriptions
+- **Unique angle**: What makes this module special
+- **Use cases**: 3-5 concrete scenarios where this module shines
+
+---
+
+_This focused context helps create cohesive, valuable BMAD modules_

src/modules/bmb/workflows/create-module/checklist.md

@@ -0,0 +1,245 @@
+# Build Module Validation Checklist
+
+## Module Identity & Metadata
+
+### Basic Information
+
+- [ ] Module code follows kebab-case convention (e.g., "rpg-toolkit")
+- [ ] Module name is descriptive and title-cased
+- [ ] Module purpose is clearly defined (1-2 sentences)
+- [ ] Target audience is identified
+- [ ] Version number follows semantic versioning (e.g., "1.0.0")
+- [ ] Author information is present
+
+### Naming Consistency
+
+- [ ] Module code used consistently throughout all files
+- [ ] No naming conflicts with existing modules
+- [ ] All paths use consistent module code references
+
+## Directory Structure
+
+### Source Directories (bmad/{module-code}/)
+
+- [ ] `/agents` directory created (even if empty)
+- [ ] `/workflows` directory created (even if empty)
+- [ ] `/tasks` directory exists (if tasks planned)
+- [ ] `/templates` directory exists (if templates used)
+- [ ] `/data` directory exists (if data files needed)
+- [ ] `config.yaml` present in module root
+- [ ] `README.md` present with documentation
+
+### Runtime Directories (bmad/{module-code}/)
+
+- [ ] `/_module-installer` directory created
+- [ ] `/data` directory for user data
+- [ ] `/agents` directory for overrides
+- [ ] `/workflows` directory for instances
+- [ ] Runtime `config.yaml` present
+
+## Component Planning
+
+### Agents
+
+- [ ] At least one agent defined or planned
+- [ ] Agent purposes are distinct and clear
+- [ ] Agent types (Simple/Expert/Module) identified
+- [ ] No significant overlap between agents
+- [ ] Primary agent is identified
+
+### Workflows
+
+- [ ] At least one workflow defined or planned
+- [ ] Workflow purposes are clear
+- [ ] Workflow types identified (Document/Action/Interactive)
+- [ ] Primary workflow is identified
+- [ ] Workflow complexity is appropriate
+
+### Tasks (if applicable)
+
+- [ ] Tasks have single, clear purposes
+- [ ] Tasks don't duplicate workflow functionality
+- [ ] Task files follow naming conventions
+
+## Configuration Files
+
+### Module config.yaml
+
+- [ ] All required fields present (name, code, version, author)
+- [ ] Component lists accurate (agents, workflows, tasks)
+- [ ] Paths use proper variables ({project-root}, etc.)
+- [ ] Output folders configured
+- [ ] Custom settings documented
+
+### Install Configuration
+
+- [ ] `install-module-config.yaml` exists in `_module-installer`
+- [ ] Installation steps defined
+- [ ] Directory creation steps present
+- [ ] File copy operations specified
+- [ ] Module registration included
+- [ ] Post-install message defined
+
+## Installation Infrastructure
+
+### Installer Files
+
+- [ ] Install configuration validates against schema
+- [ ] All source paths exist or are marked as templates
+- [ ] Destination paths use correct variables
+- [ ] Optional vs required steps clearly marked
+
+### installer.js (if present)
+
+- [ ] Main `installModule` function exists
+- [ ] Error handling implemented
+- [ ] Console logging for user feedback
+- [ ] Exports correct function names
+- [ ] Placeholder code replaced with actual logic (or logged as TODO)
+
+### External Assets (if any)
+
+- [ ] Asset files exist in assets directory
+- [ ] Copy destinations are valid
+- [ ] Permissions requirements documented
+
+## Documentation
+
+### README.md
+
+- [ ] Module overview section present
+- [ ] Installation instructions included
+- [ ] Component listing with descriptions
+- [ ] Quick start guide provided
+- [ ] Configuration options documented
+- [ ] At least one usage example
+- [ ] Directory structure shown
+- [ ] Author and date information
+
+### Component Documentation
+
+- [ ] Each agent has purpose documentation
+- [ ] Each workflow has description
+- [ ] Tasks are documented (if present)
+- [ ] Examples demonstrate typical usage
+
+### Development Roadmap
+
+- [ ] TODO.md or roadmap section exists
+- [ ] Planned components listed
+- [ ] Development phases identified
+- [ ] Quick commands for adding components
+
+## Integration
+
+### Cross-component References
+
+- [ ] Agents reference correct workflow paths
+- [ ] Workflows reference correct task paths
+- [ ] All internal paths use module variables
+- [ ] External dependencies declared
+
+### Module Boundaries
+
+- [ ] Module scope is well-defined
+- [ ] No feature creep into other domains
+- [ ] Clear separation from other modules
+
+## Quality Checks
+
+### Completeness
+
+- [ ] At least one functional component (not all placeholders)
+- [ ] Core functionality is implementable
+- [ ] Module provides clear value
+
+### Consistency
+
+- [ ] Formatting consistent across files
+- [ ] Variable naming follows conventions
+- [ ] Communication style appropriate for domain
+
+### Scalability
+
+- [ ] Structure supports future growth
+- [ ] Component organization is logical
+- [ ] No hard-coded limits
+
+## Testing & Validation
+
+### Structural Validation
+
+- [ ] YAML files parse without errors
+- [ ] JSON files (if any) are valid
+- [ ] XML files (if any) are well-formed
+- [ ] No syntax errors in JavaScript files
+
+### Path Validation
+
+- [ ] All referenced paths exist or are clearly marked as TODO
+- [ ] Variable substitutions are correct
+- [ ] No absolute paths (unless intentional)
+
+### Installation Testing
+
+- [ ] Installation steps can be simulated
+- [ ] No circular dependencies
+- [ ] Uninstall process defined (if complex)
+
+## Final Checks
+
+### Ready for Use
+
+- [ ] Module can be installed without errors
+- [ ] At least one component is functional
+- [ ] User can understand how to get started
+- [ ] Next steps are clear
+
+### Professional Quality
+
+- [ ] No placeholder text remains (unless marked TODO)
+- [ ] No obvious typos or grammar issues
+- [ ] Professional tone throughout
+- [ ] Contact/support information provided
+
+## Issues Found
+
+### Critical Issues
+
+<!-- List any issues that MUST be fixed before module can be used -->
+
+### Warnings
+
+<!-- List any issues that should be addressed but won't prevent basic usage -->
+
+### Improvements
+
+<!-- List any optional enhancements that would improve the module -->
+
+### Missing Components
+
+<!-- List any planned components not yet implemented -->
+
+## Module Complexity Assessment
+
+### Complexity Rating
+
+- [ ] Simple (1-2 agents, 2-3 workflows)
+- [ ] Standard (3-5 agents, 5-10 workflows)
+- [ ] Complex (5+ agents, 10+ workflows)
+
+### Readiness Level
+
+- [ ] Prototype (Basic structure, mostly placeholders)
+- [ ] Alpha (Core functionality works)
+- [ ] Beta (Most features complete, needs testing)
+- [ ] Release (Full functionality, documented)
+
+## Sign-off
+
+**Module Name:** \***\*\*\*\*\***\_\_\***\*\*\*\*\***
+**Module Code:** \***\*\*\*\*\***\_\_\***\*\*\*\*\***
+**Version:** \***\*\*\*\*\***\_\_\***\*\*\*\*\***
+**Validated By:** \***\*\*\*\*\***\_\_\***\*\*\*\*\***
+**Date:** \***\*\*\*\*\***\_\_\***\*\*\*\*\***
+**Status:** ⬜ Pass / ⬜ Pass with Issues / ⬜ Fail

src/modules/bmb/workflows/create-module/installer-templates/install-module-config.yaml

@@ -0,0 +1,132 @@
+# {{MODULE_NAME}} Installation Configuration Template
+# This file defines how the module gets installed into a BMAD system
+
+module_name: "{{MODULE_NAME}}"
+module_code: "{{MODULE_CODE}}"
+author: "{{AUTHOR}}"
+installation_date: "{{DATE}}"
+bmad_version_required: "6.0.0"
+
+# Module metadata
+metadata:
+  description: "{{MODULE_DESCRIPTION}}"
+  category: "{{MODULE_CATEGORY}}"
+  tags: ["{{MODULE_TAGS}}"]
+  homepage: "{{MODULE_HOMEPAGE}}"
+  license: "{{MODULE_LICENSE}}"
+
+# Pre-installation checks
+pre_install_checks:
+  - name: "Check BMAD version"
+    type: "version_check"
+    minimum: "6.0.0"
+
+  - name: "Check dependencies"
+    type: "module_check"
+    required_modules: [] # List any required modules
+
+  - name: "Check disk space"
+    type: "disk_check"
+    required_mb: 50
+
+# Installation steps
+install_steps:
+  - name: "Create module directories"
+    action: "mkdir"
+    paths:
+      - "{project-root}/bmad/{{MODULE_CODE}}"
+      - "{project-root}/bmad/{{MODULE_CODE}}/data"
+      - "{project-root}/bmad/{{MODULE_CODE}}/agents"
+      - "{project-root}/bmad/{{MODULE_CODE}}/workflows"
+      - "{project-root}/bmad/{{MODULE_CODE}}/config"
+      - "{project-root}/bmad/{{MODULE_CODE}}/logs"
+
+  - name: "Copy module configuration"
+    action: "copy"
+    files:
+      - source: "config.yaml"
+        dest: "{project-root}/bmad/{{MODULE_CODE}}/config.yaml"
+
+  - name: "Copy default data files"
+    action: "copy"
+    optional: true
+    files:
+      - source: "data/*"
+        dest: "{project-root}/bmad/{{MODULE_CODE}}/data/"
+
+  - name: "Register module in manifest"
+    action: "register"
+    manifest_path: "{project-root}/bmad/_cfg/manifest.yaml"
+    entry:
+      module: "{{MODULE_CODE}}"
+      status: "active"
+      path: "{project-root}/bmad/{{MODULE_CODE}}"
+
+  - name: "Setup agent shortcuts"
+    action: "create_shortcuts"
+    agents: "{{AGENT_LIST}}"
+
+  - name: "Initialize module database"
+    action: "exec"
+    optional: true
+    script: "installer.js"
+    function: "initDatabase"
+
+# External assets to install
+external_assets:
+  - description: "Module documentation"
+    source: "assets/docs/*"
+    dest: "{project-root}/docs/{{MODULE_CODE}}/"
+
+  - description: "Example configurations"
+    source: "assets/examples/*"
+    dest: "{project-root}/examples/{{MODULE_CODE}}/"
+    optional: true
+
+# Module configuration defaults
+default_config:
+  output_folder: "{project-root}/output/{{MODULE_CODE}}"
+  data_folder: "{project-root}/bmad/{{MODULE_CODE}}/data"
+  log_level: "info"
+  auto_save: true
+  # {{CUSTOM_CONFIG}}
+
+# Post-installation setup
+post_install:
+  - name: "Run initial setup"
+    action: "workflow"
+    workflow: "{{MODULE_CODE}}-setup"
+    optional: true
+
+  - name: "Generate sample data"
+    action: "exec"
+    script: "installer.js"
+    function: "generateSamples"
+    optional: true
+
+  - name: "Verify installation"
+    action: "test"
+    test_command: "bmad test {{MODULE_CODE}}"
+
+# Post-installation message
+post_install_message: |
+  ✅ {{MODULE_NAME}} has been installed successfully!
+
+  🚀 Quick Start:
+  1. Load the main agent: `agent {{PRIMARY_AGENT}}`
+  2. View available commands: `*help`
+  3. Run the main workflow: `workflow {{PRIMARY_WORKFLOW}}`
+
+  📚 Documentation: {project-root}/docs/{{MODULE_CODE}}/README.md
+  💡 Examples: {project-root}/examples/{{MODULE_CODE}}/
+
+  {{CUSTOM_MESSAGE}}
+
+# Uninstall configuration
+uninstall:
+  preserve_user_data: true
+  remove_paths:
+    - "{project-root}/bmad/{{MODULE_CODE}}"
+    - "{project-root}/docs/{{MODULE_CODE}}"
+  backup_before_remove: true
+  unregister_from_manifest: true

src/modules/bmb/workflows/create-module/installer-templates/installer.js

@@ -0,0 +1,231 @@
+/* eslint-disable unicorn/prefer-module, unicorn/prefer-node-protocol */
+/**
+ * {{MODULE_NAME}} Module Installer
+ * Custom installation logic for complex module setup
+ *
+ * This is a template - replace {{VARIABLES}} with actual values
+ */
+
+// const fs = require('fs'); // Uncomment when implementing file operations
+const path = require('path');
+
+/**
+ * Main installation function
+ * Called by BMAD installer when processing the module
+ */
+async function installModule(config) {
+  console.log('🚀 Installing {{MODULE_NAME}} module...');
+  console.log(`   Version: ${config.version}`);
+  console.log(`   Module Code: ${config.module_code}`);
+
+  try {
+    // Step 1: Validate environment
+    await validateEnvironment(config);
+
+    // Step 2: Setup custom configurations
+    await setupConfigurations(config);
+
+    // Step 3: Initialize module-specific features
+    await initializeFeatures(config);
+
+    // Step 4: Run post-install tasks
+    await runPostInstallTasks(config);
+
+    console.log('✅ {{MODULE_NAME}} module installed successfully!');
+    return {
+      success: true,
+      message: 'Module installed and configured',
+    };
+  } catch (error) {
+    console.error('❌ Installation failed:', error.message);
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+/**
+ * Validate that the environment meets module requirements
+ */
+async function validateEnvironment(config) {
+  console.log('   Validating environment...');
+
+  // TODO: Add environment checks
+  // Examples:
+  // - Check for required tools/binaries
+  // - Verify permissions
+  // - Check network connectivity
+  // - Validate API keys
+
+  // Placeholder validation
+  if (!config.project_root) {
+    throw new Error('Project root not defined');
+  }
+
+  console.log('   ✓ Environment validated');
+}
+
+/**
+ * Setup module-specific configurations
+ */
+async function setupConfigurations(config) {
+  console.log('   Setting up configurations...');
+
+  // TODO: Add configuration setup
+  // Examples:
+  // - Create config files
+  // - Setup environment variables
+  // - Configure external services
+  // - Initialize settings
+
+  // Placeholder configuration
+  const configPath = path.join(config.project_root, 'bmad', config.module_code, 'config.json');
+
+  // Example of module config that would be created
+  // const moduleConfig = {
+  //   installed: new Date().toISOString(),
+  //   settings: {
+  //     // Add default settings
+  //   }
+  // };
+
+  // Note: This is a placeholder - actual implementation would write the file
+  console.log(`   ✓ Would create config at: ${configPath}`);
+  console.log('   ✓ Configurations complete');
+}
+
+/**
+ * Initialize module-specific features
+ */
+async function initializeFeatures(config) {
+  console.log('   Initializing features...');
+
+  // TODO: Add feature initialization
+  // Examples:
+  // - Create database schemas
+  // - Setup cron jobs
+  // - Initialize caches
+  // - Register webhooks
+  // - Setup file watchers
+
+  // Module-specific initialization based on type
+  switch (config.module_category) {
+    case 'data': {
+      await initializeDataFeatures(config);
+      break;
+    }
+    case 'automation': {
+      await initializeAutomationFeatures(config);
+      break;
+    }
+    case 'integration': {
+      await initializeIntegrationFeatures(config);
+      break;
+    }
+    default: {
+      console.log('   - Using standard initialization');
+    }
+  }
+
+  console.log('   ✓ Features initialized');
+}
+
+/**
+ * Initialize data-related features
+ */
+async function initializeDataFeatures(/* config */) {
+  console.log('   - Setting up data storage...');
+  // TODO: Setup databases, data folders, etc.
+}
+
+/**
+ * Initialize automation features
+ */
+async function initializeAutomationFeatures(/* config */) {
+  console.log('   - Setting up automation hooks...');
+  // TODO: Setup triggers, watchers, schedulers
+}
+
+/**
+ * Initialize integration features
+ */
+async function initializeIntegrationFeatures(/* config */) {
+  console.log('   - Setting up integrations...');
+  // TODO: Configure APIs, webhooks, external services
+}
+
+/**
+ * Run post-installation tasks
+ */
+async function runPostInstallTasks(/* config */) {
+  console.log('   Running post-install tasks...');
+
+  // TODO: Add post-install tasks
+  // Examples:
+  // - Generate sample data
+  // - Run initial workflows
+  // - Send notifications
+  // - Update registries
+
+  console.log('   ✓ Post-install tasks complete');
+}
+
+/**
+ * Initialize database for the module (optional)
+ */
+async function initDatabase(/* config */) {
+  console.log('   Initializing database...');
+
+  // TODO: Add database initialization
+  // This function can be called from install-module-config.yaml
+
+  console.log('   ✓ Database initialized');
+}
+
+/**
+ * Generate sample data for the module (optional)
+ */
+async function generateSamples(config) {
+  console.log('   Generating sample data...');
+
+  // TODO: Create sample files, data, configurations
+  // This helps users understand how to use the module
+
+  const samplesPath = path.join(config.project_root, 'examples', config.module_code);
+
+  console.log(`   - Would create samples at: ${samplesPath}`);
+  console.log('   ✓ Samples generated');
+}
+
+/**
+ * Uninstall the module (cleanup)
+ */
+async function uninstallModule(/* config */) {
+  console.log('🗑️  Uninstalling {{MODULE_NAME}} module...');
+
+  try {
+    // TODO: Add cleanup logic
+    // - Remove configurations
+    // - Clean up databases
+    // - Unregister services
+    // - Backup user data
+
+    console.log('✅ Module uninstalled successfully');
+    return { success: true };
+  } catch (error) {
+    console.error('❌ Uninstall failed:', error.message);
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+// Export functions for BMAD installer
+module.exports = {
+  installModule,
+  initDatabase,
+  generateSamples,
+  uninstallModule,
+};

src/modules/bmb/workflows/create-module/instructions.md

@@ -0,0 +1,509 @@
+# Build Module - Interactive Module Builder Instructions
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-module/workflow.yaml</critical>
+<critical>Study existing modules in: {project_root}/bmad/ for patterns</critical>
+
+<workflow>
+
+<step n="-1" goal="Optional brainstorming for module ideas" optional="true">
+<ask>Do you want to brainstorm module ideas first? [y/n]</ask>
+
+If yes:
+<action>Invoke brainstorming workflow: {project-root}/bmad/cis/workflows/brainstorming/workflow.yaml</action>
+<action>Pass context data: {installed_path}/brainstorm-context.md</action>
+<action>Wait for brainstorming session completion</action>
+<action>Use brainstorming output to inform module concept, agent lineup, and workflow portfolio</action>
+
+If no, proceed to check for module brief.
+
+<template-output>brainstorming_results</template-output>
+</step>
+
+<step n="0" goal="Check for module brief" optional="true">
+<ask>Do you have a module brief or should we create one? [have/create/skip]</ask>
+
+If create:
+<action>Invoke module-brief workflow: {project-root}/bmad/bmb/workflows/module-brief/workflow.yaml</action>
+<action>Wait for module brief completion</action>
+<action>Load the module brief to use as blueprint</action>
+
+If have:
+<ask>Provide path to module brief document</ask>
+<action>Load the module brief and use it to pre-populate all planning sections</action>
+
+If skip, proceed directly to module definition.
+
+<template-output>module_brief</template-output>
+</step>
+
+<step n="1" goal="Define module concept and scope">
+<critical>Load and study the complete module structure guide</critical>
+<action>Load module structure guide: {module_structure_guide}</action>
+<action>Understand module types (Simple/Standard/Complex)</action>
+<action>Review directory structures and component guidelines</action>
+<action>Study the installation infrastructure patterns</action>
+
+Ask the user about their module vision:
+
+**Module Identity:**
+
+1. **Module code** (kebab-case, e.g., "rpg-toolkit", "data-viz", "team-collab")
+2. **Module name** (friendly name, e.g., "RPG Toolkit", "Data Visualization Suite")
+3. **Module purpose** (1-2 sentences describing what it does)
+4. **Target audience** (who will use this module?)
+
+**Module Theme Examples:**
+
+- **Domain-Specific:** Legal, Medical, Finance, Education
+- **Creative:** RPG/Gaming, Story Writing, Music Production
+- **Technical:** DevOps, Testing, Architecture, Security
+- **Business:** Project Management, Marketing, Sales
+- **Personal:** Journaling, Learning, Productivity
+
+<critical>Check {src_impact} variable to determine output location:</critical>
+
+- If {src_impact} = true: Module will be created at {src_output_folder}
+- If {src_impact} = false: Module will be created at {default_output_folder}
+
+Store module identity for scaffolding.
+
+<template-output>module_identity</template-output>
+</step>
+
+<step n="2" goal="Plan module components">
+Gather the module's component architecture:
+
+**Agents Planning:**
+Ask: How many agents will this module have? (typically 1-5)
+
+For each agent, gather:
+
+- Agent name and purpose
+- Will it be Simple, Expert, or Module type?
+- Key commands it should have
+- Create now or placeholder for later?
+
+Example for RPG module:
+
+1. DM Agent - Dungeon Master assistant (Module type)
+2. NPC Agent - Character simulation (Expert type)
+3. Story Writer Agent - Adventure creation (Module type)
+
+**Workflows Planning:**
+Ask: How many workflows? (typically 2-10)
+
+For each workflow, gather:
+
+- Workflow name and purpose
+- Document, Action, or Interactive type?
+- Complexity (simple/complex)
+- Create now or placeholder?
+
+Example workflows:
+
+1. adventure-plan - Create full adventure (Document)
+2. random-encounter - Quick encounter generator (Action)
+3. npc-generator - Create NPCs on the fly (Interactive)
+4. treasure-generator - Loot tables (Action)
+
+**Tasks Planning (optional):**
+Ask: Any special tasks that don't warrant full workflows?
+
+For each task:
+
+- Task name and purpose
+- Standalone or supporting?
+
+<template-output>module_components</template-output>
+</step>
+
+<step n="3" goal="Create module directory structure">
+<critical>Determine base module path based on {src_impact}:</critical>
+- If {src_impact} = true: Use {src_output_folder}
+- If {src_impact} = false: Use {default_output_folder}
+
+<action>Create base module directories at the determined path:</action>
+
+```
+{{module_code}}/
+├── agents/           # Agent definitions
+├── workflows/        # Workflow folders
+├── tasks/           # Task files (if any)
+├── templates/       # Shared templates
+├── data/           # Module data files
+├── config.yaml     # Module configuration
+└── README.md       # Module documentation
+```
+
+<action>Create installer directory:</action>
+
+```
+{{module_code}}/
+├── _module-installer/
+│   ├── install-module-config.yaml
+│   ├── installer.js (optional)
+│   └── assets/     # Files to copy during install
+├── config.yaml     # Runtime configuration
+├── agents/         # Agent configs (optional)
+├── workflows/      # Workflow instances
+└── data/          # User data directory
+```
+
+<template-output>directory_structure</template-output>
+</step>
+
+<step n="4" goal="Generate module configuration">
+Create the main module config.yaml:
+
+```yaml
+# {{module_name}} Module Configuration
+module_name: {{module_name}}
+module_code: {{module_code}}
+author: {{user_name}}
+description: {{module_purpose}}
+
+# Module paths
+module_root: "{project-root}/bmad/{{module_code}}"
+installer_path: "{project-root}/bmad/{{module_code}}"
+
+# Component counts
+agents:
+  count: {{agent_count}}
+  list: {{agent_list}}
+
+workflows:
+  count: {{workflow_count}}
+  list: {{workflow_list}}
+
+tasks:
+  count: {{task_count}}
+  list: {{task_list}}
+
+# Module-specific settings
+{{custom_settings}}
+
+# Output configuration
+output_folder: "{project-root}/docs/{{module_code}}"
+data_folder: "{{determined_module_path}}/data"
+```
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Save to {src_output_folder}/config.yaml
+- If {src_impact} = false: Save to {default_output_folder}/config.yaml
+
+<template-output>module_config</template-output>
+</step>
+
+<step n="5" goal="Create first agent" optional="true">
+Ask: **Create your first agent now? [Yes/no]**
+
+If yes:
+<invoke-workflow input="{{module_components}}">
+{agent_builder}
+</invoke-workflow>
+
+Guide them to create the primary agent for the module.
+<critical>Ensure it's saved to the correct location based on {src_impact}:</critical>
+
+- If {src_impact} = true: {src_output_folder}/agents/
+- If {src_impact} = false: {default_output_folder}/agents/
+
+If no, create placeholder:
+
+```md
+# {{primary_agent_name}} Agent
+
+<!-- TODO: Create using build-agent workflow -->
+<!-- Purpose: {{agent_purpose}} -->
+<!-- Type: {{agent_type}} -->
+```
+
+<template-output>first_agent</template-output>
+</step>
+
+<step n="6" goal="Create first workflow" optional="true">
+Ask: **Create your first workflow now? [Yes/no]**
+
+If yes:
+<invoke-workflow input="{{module_components}}">
+{workflow_builder}
+</invoke-workflow>
+
+Guide them to create the primary workflow.
+<critical>Ensure it's saved to the correct location based on {src_impact}:</critical>
+
+- If {src_impact} = true: {src_output_folder}/workflows/
+- If {src_impact} = false: {default_output_folder}/workflows/
+
+If no, create placeholder structure:
+
+```
+workflows/{{workflow_name}}/
+├── workflow.yaml    # TODO: Configure
+├── instructions.md  # TODO: Add steps
+└── template.md     # TODO: If document workflow
+```
+
+<template-output>first_workflow</template-output>
+</step>
+
+<step n="7" goal="Setup module installer">
+<action>Load installer templates from: {installer_templates}</action>
+
+Create install-module-config.yaml:
+
+```yaml
+# {{module_name}} Installation Configuration
+module_name: { { module_name } }
+module_code: { { module_code } }
+installation_date: { { date } }
+
+# Installation steps
+install_steps:
+  - name: 'Create directories'
+    action: 'mkdir'
+    paths:
+      - '{project-root}/bmad/{{module_code}}'
+      - '{project-root}/bmad/{{module_code}}/data'
+      - '{project-root}/bmad/{{module_code}}/agents'
+
+  - name: 'Copy configuration'
+    action: 'copy'
+    source: '{installer_path}/config.yaml'
+    dest: '{project-root}/bmad/{{module_code}}/config.yaml'
+
+  - name: 'Register module'
+    action: 'register'
+    manifest: '{project-root}/bmad/_cfg/manifest.yaml'
+
+# External assets (if any)
+external_assets:
+  - description: '{{asset_description}}'
+    source: 'assets/{{filename}}'
+    dest: '{{destination_path}}'
+
+# Post-install message
+post_install_message: |
+  {{module_name}} has been installed successfully!
+
+  To get started:
+  1. Load any {{module_code}} agent
+  2. Use *help to see available commands
+  3. Check README.md for full documentation
+```
+
+Create installer.js stub (optional):
+
+```javascript
+// {{module_name}} Module Installer
+// This is a placeholder for complex installation logic
+
+function installModule(config) {
+  console.log('Installing {{module_name}} module...');
+
+  // TODO: Add any complex installation logic here
+  // Examples:
+  // - Database setup
+  // - API key configuration
+  // - External service registration
+  // - File system preparation
+
+  console.log('{{module_name}} module installed successfully!');
+  return true;
+}
+
+module.exports = { installModule };
+```
+
+<template-output>installer_config</template-output>
+</step>
+
+<step n="8" goal="Create module documentation">
+Generate comprehensive README.md:
+
+````markdown
+# {{module_name}}
+
+{{module_purpose}}
+
+## Overview
+
+This module provides:
+{{component_summary}}
+
+## Installation
+
+```bash
+bmad install {{module_code}}
+```
+````
+
+## Components
+
+### Agents ({{agent_count}})
+
+{{agent_documentation}}
+
+### Workflows ({{workflow_count}})
+
+{{workflow_documentation}}
+
+### Tasks ({{task_count}})
+
+{{task_documentation}}
+
+## Quick Start
+
+1. **Load the main agent:**
+
+   ```
+   agent {{primary_agent}}
+   ```
+
+2. **View available commands:**
+
+   ```
+   *help
+   ```
+
+3. **Run the main workflow:**
+   ```
+   workflow {{primary_workflow}}
+   ```
+
+## Module Structure
+
+```
+{{directory_tree}}
+```
+
+## Configuration
+
+The module can be configured in `bmad/{{module_code}}/config.yaml`
+
+Key settings:
+{{configuration_options}}
+
+## Examples
+
+### Example 1: {{example_use_case}}
+
+{{example_walkthrough}}
+
+## Development Roadmap
+
+- [ ] {{roadmap_item_1}}
+- [ ] {{roadmap_item_2}}
+- [ ] {{roadmap_item_3}}
+
+## Contributing
+
+To extend this module:
+
+1. Add new agents using `build-agent` workflow
+2. Add new workflows using `build-workflow` workflow
+3. Submit improvements via pull request
+
+## Author
+
+Created by {{user_name}} on {{date}}
+
+````
+
+<template-output>module_readme</template-output>
+</step>
+
+<step n="9" goal="Generate component roadmap">
+Create a development roadmap for remaining components:
+
+**TODO.md file:**
+```markdown
+# {{module_name}} Development Roadmap
+
+## Phase 1: Core Components
+{{phase1_tasks}}
+
+## Phase 2: Enhanced Features
+{{phase2_tasks}}
+
+## Phase 3: Polish & Integration
+{{phase3_tasks}}
+
+## Quick Commands
+
+Create new agent:
+````
+
+workflow build-agent
+
+```
+
+Create new workflow:
+```
+
+workflow build-workflow
+
+```
+
+## Notes
+{{development_notes}}
+```
+
+Ask if user wants to:
+
+1. Continue building more components now
+2. Save roadmap for later development
+3. Test what's been built so far
+
+<template-output>development_roadmap</template-output>
+</step>
+
+<step n="10" goal="Validate and finalize module">
+Run validation checks:
+
+1. **Structure validation:**
+   - All required directories created
+   - Config files properly formatted
+   - Installer configuration valid
+
+2. **Component validation:**
+   - At least one agent or workflow exists (or planned)
+   - All references use correct paths
+   - Module code consistent throughout
+
+3. **Documentation validation:**
+   - README.md complete
+   - Installation instructions clear
+   - Examples provided
+
+Show summary:
+
+```
+✅ Module: {{module_name}} ({{module_code}})
+📁 Location:
+   - If {src_impact} = true: {src_output_folder}
+   - If {src_impact} = false: {default_output_folder}
+👥 Agents: {{agent_count}} ({{agents_created}} created, {{agents_planned}} planned)
+📋 Workflows: {{workflow_count}} ({{workflows_created}} created, {{workflows_planned}} planned)
+📝 Tasks: {{task_count}}
+📦 Installer: Ready at same location
+```
+
+Next steps:
+
+1. Complete remaining components using roadmap
+2. Test module with: `bmad install {{module_code}}`
+3. Share module or integrate with existing system
+
+Ask: Would you like to:
+
+- Create another component now?
+- Test the module installation?
+- Exit and continue later?
+
+<template-output>module_summary</template-output>
+</step>
+
+</workflow>

src/modules/bmb/workflows/create-module/module-structure.md

@@ -0,0 +1,310 @@
+# BMAD Module Structure Guide
+
+## What is a Module?
+
+A BMAD module is a self-contained package of agents, workflows, tasks, and resources that work together to provide specialized functionality. Think of it as an expansion pack for the BMAD Method.
+
+## Module Architecture
+
+### Core Structure
+
+```
+project-root/
+├── bmad/{module-code}/     # Source code
+│   ├── agents/                    # Agent definitions
+│   ├── workflows/                 # Workflow folders
+│   ├── tasks/                     # Task files
+│   ├── templates/                 # Shared templates
+│   ├── data/                      # Static data
+│   ├── config.yaml                # Module config
+│   └── README.md                  # Documentation
+│
+└── bmad/{module-code}/            # Runtime instance
+    ├── _module-installer/         # Installation files
+    │   ├── install-module-config.yaml
+    │   ├── installer.js          # Optional
+    │   └── assets/               # Install assets
+    ├── config.yaml               # User config
+    ├── agents/                   # Agent overrides
+    ├── workflows/                # Workflow instances
+    └── data/                     # User data
+
+```
+
+## Module Types by Complexity
+
+### Simple Module (1-2 agents, 2-3 workflows)
+
+Perfect for focused, single-purpose tools.
+
+**Example: Code Review Module**
+
+- 1 Reviewer Agent
+- 2 Workflows: quick-review, deep-review
+- Clear, narrow scope
+
+### Standard Module (3-5 agents, 5-10 workflows)
+
+Comprehensive solution for a domain.
+
+**Example: Project Management Module**
+
+- PM Agent, Scrum Master Agent, Analyst Agent
+- Workflows: sprint-planning, retrospective, roadmap, user-stories
+- Integrated component ecosystem
+
+### Complex Module (5+ agents, 10+ workflows)
+
+Full platform or framework.
+
+**Example: RPG Toolkit Module**
+
+- DM Agent, NPC Agent, Monster Agent, Loot Agent, Map Agent
+- 15+ workflows for every aspect of game management
+- Multiple interconnected systems
+
+## Module Naming Conventions
+
+### Module Code (kebab-case)
+
+- `data-viz` - Data Visualization
+- `team-collab` - Team Collaboration
+- `rpg-toolkit` - RPG Toolkit
+- `legal-assist` - Legal Assistant
+
+### Module Name (Title Case)
+
+- "Data Visualization Suite"
+- "Team Collaboration Platform"
+- "RPG Game Master Toolkit"
+- "Legal Document Assistant"
+
+## Component Guidelines
+
+### Agents per Module
+
+**Recommended Distribution:**
+
+- **Primary Agent (1)**: The main interface/orchestrator
+- **Specialist Agents (2-4)**: Domain-specific experts
+- **Utility Agents (0-2)**: Helper/support functions
+
+**Anti-patterns to Avoid:**
+
+- Too many overlapping agents
+- Agents that could be combined
+- Agents without clear purpose
+
+### Workflows per Module
+
+**Categories:**
+
+- **Core Workflows (2-3)**: Essential functionality
+- **Feature Workflows (3-5)**: Specific capabilities
+- **Utility Workflows (2-3)**: Supporting operations
+- **Admin Workflows (0-2)**: Maintenance/config
+
+**Workflow Complexity Guide:**
+
+- Simple: 3-5 steps, single output
+- Standard: 5-10 steps, multiple outputs
+- Complex: 10+ steps, conditional logic, sub-workflows
+
+### Tasks per Module
+
+Tasks should be used for:
+
+- Single-operation utilities
+- Shared subroutines
+- Quick actions that don't warrant workflows
+
+## Module Dependencies
+
+### Internal Dependencies
+
+- Agents can reference module workflows
+- Workflows can invoke module tasks
+- Tasks can use module templates
+
+### External Dependencies
+
+- Reference other modules via full paths
+- Declare dependencies in config.yaml
+- Version compatibility notes
+
+## Installation Infrastructure
+
+### Required: install-module-config.yaml
+
+```yaml
+module_name: 'Module Name'
+module_code: 'module-code'
+
+install_steps:
+  - name: 'Create directories'
+    action: 'mkdir'
+    paths: [...]
+
+  - name: 'Copy files'
+    action: 'copy'
+    mappings: [...]
+
+  - name: 'Register module'
+    action: 'register'
+```
+
+### Optional: installer.js
+
+For complex installations requiring:
+
+- Database setup
+- API configuration
+- System integration
+- Permission management
+
+### Optional: External Assets
+
+Files that get copied outside the module:
+
+- System configurations
+- User templates
+- Shared resources
+- Integration scripts
+
+## Module Lifecycle
+
+### Development Phases
+
+1. **Planning Phase**
+   - Define scope and purpose
+   - Identify components
+   - Design architecture
+
+2. **Scaffolding Phase**
+   - Create directory structure
+   - Generate configurations
+   - Setup installer
+
+3. **Building Phase**
+   - Create agents incrementally
+   - Build workflows progressively
+   - Add tasks as needed
+
+4. **Testing Phase**
+   - Test individual components
+   - Verify integration
+   - Validate installation
+
+5. **Deployment Phase**
+   - Package module
+   - Document usage
+   - Distribute/share
+
+## Best Practices
+
+### Module Cohesion
+
+- All components should relate to module theme
+- Clear boundaries between modules
+- No feature creep
+
+### Progressive Enhancement
+
+- Start with MVP (1 agent, 2 workflows)
+- Add components based on usage
+- Refactor as patterns emerge
+
+### Documentation Standards
+
+- Every module needs README.md
+- Each agent needs purpose statement
+- Workflows need clear descriptions
+- Include examples and quickstart
+
+### Naming Consistency
+
+- Use module code prefix for uniqueness
+- Consistent naming patterns within module
+- Clear, descriptive names
+
+## Example Modules
+
+### Example 1: Personal Productivity
+
+```
+productivity/
+├── agents/
+│   ├── task-manager.md      # GTD methodology
+│   └── focus-coach.md        # Pomodoro timer
+├── workflows/
+│   ├── daily-planning/       # Morning routine
+│   ├── weekly-review/        # Week retrospective
+│   └── project-setup/        # New project init
+└── config.yaml
+```
+
+### Example 2: Content Creation
+
+```
+content/
+├── agents/
+│   ├── writer.md            # Blog/article writer
+│   ├── editor.md            # Copy editor
+│   └── seo-optimizer.md     # SEO specialist
+├── workflows/
+│   ├── blog-post/           # Full blog creation
+│   ├── social-media/        # Social content
+│   ├── email-campaign/      # Email sequence
+│   └── content-calendar/    # Planning
+└── templates/
+    ├── blog-template.md
+    └── email-template.md
+```
+
+### Example 3: DevOps Automation
+
+```
+devops/
+├── agents/
+│   ├── deploy-master.md     # Deployment orchestrator
+│   ├── monitor.md           # System monitoring
+│   ├── incident-responder.md # Incident management
+│   └── infra-architect.md   # Infrastructure design
+├── workflows/
+│   ├── ci-cd-setup/         # Pipeline creation
+│   ├── deploy-app/          # Application deployment
+│   ├── rollback/            # Emergency rollback
+│   ├── health-check/        # System verification
+│   └── incident-response/   # Incident handling
+├── tasks/
+│   ├── check-status.md      # Quick status check
+│   └── notify-team.md       # Team notifications
+└── data/
+    └── runbooks/            # Operational guides
+```
+
+## Module Evolution Pattern
+
+```
+Simple Module → Standard Module → Complex Module → Module Suite
+     (MVP)          (Enhanced)        (Complete)      (Ecosystem)
+```
+
+## Common Pitfalls
+
+1. **Over-engineering**: Starting too complex
+2. **Under-planning**: No clear architecture
+3. **Poor boundaries**: Module does too much
+4. **Weak integration**: Components don't work together
+5. **Missing docs**: No clear usage guide
+
+## Success Metrics
+
+A well-designed module has:
+
+- ✅ Clear, focused purpose
+- ✅ Cohesive components
+- ✅ Smooth installation
+- ✅ Comprehensive docs
+- ✅ Room for growth
+- ✅ Happy users!

src/modules/bmb/workflows/create-module/workflow.yaml

@@ -0,0 +1,47 @@
+# Build Module Workflow Configuration
+name: build-module
+description: "Interactive workflow to build complete BMAD modules with agents, workflows, tasks, and installation infrastructure"
+author: "BMad"
+
+# Critical variables load from config_source
+config_source: "{project-root}/bmad/bmb/config.yaml"
+output_folder: "{config_source}:output_folder"
+src_impact: "{config_source}:src_impact"
+communication_language: "{config_source}:communication_language"
+user_name: "{config_source}:user_name"
+date: system-generated
+
+# Reference guides for module building
+module_structure_guide: "{installed_path}/module-structure.md"
+installer_templates: "{installed_path}/installer-templates/"
+example_modules: "{installed_path}/example-modules.md"
+
+# Use existing build workflows
+agent_builder: "{project-root}/bmad/bmb/workflows/build-agent/workflow.yaml"
+workflow_builder: "{project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml"
+
+# Optional docs that help understand module patterns
+recommended_inputs:
+  - module_brief: "{output_folder}/module-brief-*.md"
+  - brainstorming_results: "{output_folder}/brainstorming-*.md"
+  - bmm_module: "{project-root}/bmad/bmm/"
+  - cis_module: "{project-root}/bmad/cis/"
+  - existing_agents: "{project-root}/bmad/*/agents/"
+  - existing_workflows: "{project-root}/bmad/*/workflows/"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/build-module"
+template: false # This is an interactive scaffolding workflow
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Output configuration - creates entire module structure
+# If src_impact=true: Save to src/modules/{{module_code}}
+# If src_impact=false: Save to output_folder/{{module_code}}
+default_output_folder: "{output_folder}/{{module_code}}"
+src_output_folder: "{project-root}/src/modules/{{module_code}}"
+installer_output_folder: "{output_folder}/{{module_code}}"
+src_installer_output_folder: "{project-root}/src/modules/{{module_code}}"
+
+# No special tools required for module building
+required_tools: []

src/modules/bmb/workflows/create-workflow/README.md

@@ -0,0 +1,216 @@
+# Build Workflow
+
+## Overview
+
+The Build Workflow is an interactive workflow builder that guides you through creating new BMAD workflows with proper structure, conventions, and validation. It ensures all workflows follow best practices for optimal human-AI collaboration and are fully compliant with the BMAD Core v6 workflow execution engine.
+
+## Key Features
+
+- **Optional Brainstorming Phase**: Creative exploration of workflow ideas before structured development
+- **Comprehensive Guidance**: Step-by-step process with detailed instructions and examples
+- **Template-Based**: Uses proven templates for all workflow components
+- **Convention Enforcement**: Ensures adherence to BMAD workflow creation guide
+- **README Generation**: Automatically creates comprehensive documentation
+- **Validation Built-In**: Includes checklist generation for quality assurance
+- **Type-Aware**: Adapts to document, action, interactive, autonomous, or meta-workflow types
+
+## Usage
+
+### Basic Invocation
+
+```bash
+workflow build-workflow
+```
+
+### Through BMad Builder Agent
+
+```
+*create-workflow
+```
+
+### What You'll Be Asked
+
+1. **Optional**: Whether to brainstorm workflow ideas first (creative exploration phase)
+2. Workflow name and target module
+3. Workflow purpose and type (enhanced by brainstorming insights if used)
+4. Metadata (description, author, outputs)
+5. Step-by-step design (goals, variables, flow)
+6. Whether to include optional components
+
+## Workflow Structure
+
+### Files Included
+
+```
+build-workflow/
+├── workflow.yaml                  # Configuration and metadata
+├── instructions.md                # Step-by-step execution guide
+├── checklist.md                   # Validation criteria
+├── workflow-creation-guide.md     # Comprehensive reference guide
+├── README.md                      # This file
+└── workflow-template/             # Templates for new workflows
+    ├── workflow.yaml
+    ├── instructions.md
+    ├── template.md
+    ├── checklist.md
+    └── README.md
+```
+
+## Workflow Process
+
+### Phase 0: Optional Brainstorming (Step -1)
+
+- **Creative Exploration**: Option to brainstorm workflow ideas before structured development
+- **Design Concept Development**: Generate multiple approaches and explore different possibilities
+- **Requirement Clarification**: Use brainstorming output to inform workflow purpose, type, and structure
+- **Enhanced Creativity**: Leverage AI brainstorming tools for innovative workflow design
+
+The brainstorming phase invokes the CIS brainstorming workflow to:
+
+- Explore workflow ideas and approaches
+- Clarify requirements and use cases
+- Generate creative solutions for complex automation needs
+- Inform the structured workflow building process
+
+### Phase 1: Planning (Steps 0-3)
+
+- Load workflow creation guide and conventions
+- Define workflow purpose, name, and type (informed by brainstorming if used)
+- Gather metadata and configuration details
+- Design step structure and flow
+
+### Phase 2: Generation (Steps 4-8)
+
+- Create workflow.yaml with proper configuration
+- Generate instructions.md with XML-structured steps
+- Create template.md (for document workflows)
+- Generate validation checklist
+- Create supporting data files (optional)
+
+### Phase 3: Documentation & Validation (Steps 9-11)
+
+- Create comprehensive README.md (MANDATORY)
+- Test and validate workflow structure
+- Provide usage instructions and next steps
+
+## Output
+
+### Generated Workflow Folder
+
+Creates a complete workflow folder at:
+`{project-root}/bmad/{{target_module}}/workflows/{{workflow_name}}/`
+
+### Files Created
+
+**Always Created:**
+
+- `workflow.yaml` - Configuration with paths and variables
+- `README.md` - Comprehensive documentation (MANDATORY as of v6)
+- `instructions.md` - Execution steps (if not template-only workflow)
+
+**Conditionally Created:**
+
+- `template.md` - Document structure (for document workflows)
+- `checklist.md` - Validation criteria (optional but recommended)
+- Supporting data files (CSV, JSON, etc. as needed)
+
+### Output Structure
+
+For document workflows, the README documents:
+
+- Workflow purpose and use cases
+- Usage examples with actual commands
+- Input expectations
+- Output structure and location
+- Best practices
+
+## Requirements
+
+- Access to workflow creation guide
+- BMAD Core v6 project structure
+- Module to host the new workflow (bmm, bmb, cis, or custom)
+
+## Best Practices
+
+### Before Starting
+
+1. **Consider Brainstorming**: If you're unsure about the workflow approach, use the optional brainstorming phase
+2. Review the workflow creation guide to understand conventions
+3. Have a clear understanding of the workflow's purpose (or be ready to explore it creatively)
+4. Know which type of workflow you're creating (document, action, etc.) or be open to discovery
+5. Identify any data files or references needed
+
+### Creative Workflow Design
+
+The build-workflow now supports a **seamless transition from creative ideation to structured implementation**:
+
+- **"I need a workflow for something..."** → Start with brainstorming to explore possibilities
+- **Brainstorm** → Generate multiple approaches and clarify requirements
+- **Structured workflow** → Build the actual workflow using insights from brainstorming
+- **One seamless session** → Complete the entire process from idea to implementation
+
+### During Execution
+
+1. Follow kebab-case naming conventions
+2. Be specific with step goals and instructions
+3. Use descriptive variable names (snake_case)
+4. Set appropriate limits ("3-5 items maximum")
+5. Include examples where helpful
+
+### After Completion
+
+1. Test the newly created workflow
+2. Validate against the checklist
+3. Ensure README is comprehensive and accurate
+4. Test all file paths and variable references
+
+## Troubleshooting
+
+### Issue: Generated workflow won't execute
+
+- **Solution**: Verify all file paths in workflow.yaml use proper variable substitution
+- **Check**: Ensure installed_path and project-root are correctly set
+
+### Issue: Variables not replacing in template
+
+- **Solution**: Ensure variable names match exactly between instructions `<template-output>` tags and template `{{variables}}`
+- **Check**: Use snake_case consistently
+
+### Issue: README has placeholder text
+
+- **Solution**: This workflow now enforces README generation - ensure Step 10 completed fully
+- **Check**: No {WORKFLOW_TITLE} or similar placeholders should remain
+
+## Customization
+
+To modify this workflow:
+
+1. Edit `instructions.md` to adjust the creation process
+2. Update templates in `workflow-template/` to change generated files
+3. Modify `workflow-creation-guide.md` to update conventions
+4. Edit `checklist.md` to change validation criteria
+
+## Version History
+
+- **v6.0.0** - README.md now MANDATORY for all workflows
+  - Added comprehensive README template
+  - Enhanced validation for documentation
+  - Improved Step 10 with detailed README requirements
+
+- **v5.0.0** - Initial BMAD Core v6 compatible version
+  - Template-based workflow generation
+  - Convention enforcement
+  - Validation checklist support
+
+## Support
+
+For issues or questions:
+
+- Review `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md`
+- Check existing workflows in `/bmad/bmm/workflows/` for examples
+- Validate against `/bmad/bmb/workflows/build-workflow/checklist.md`
+- Consult BMAD Method v6 documentation
+
+---
+
+_Part of the BMad Method v6 - BMB (BMad Builder) Module_

src/modules/bmb/workflows/create-workflow/brainstorm-context.md

@@ -0,0 +1,197 @@
+# Workflow Brainstorming Context
+
+_Context provided to brainstorming workflow when creating a new BMAD workflow_
+
+## Session Focus
+
+You are brainstorming ideas for a **BMAD workflow** - a guided, multi-step process that helps users accomplish complex tasks with structure, consistency, and quality.
+
+## What is a BMAD Workflow?
+
+A workflow is a structured process that provides:
+
+- **Clear Steps**: Sequential operations with defined goals
+- **User Guidance**: Prompts, questions, and decisions at each phase
+- **Quality Output**: Documents, artifacts, or completed actions
+- **Repeatability**: Same process yields consistent results
+- **Type**: Document (creates docs), Action (performs tasks), Interactive (guides sessions), Autonomous (runs automated), Meta (orchestrates other workflows)
+
+## Brainstorming Goals
+
+Explore and define:
+
+### 1. Problem & Purpose
+
+- **What task needs structure?** (specific process users struggle with)
+- **Why is this hard manually?** (complexity, inconsistency, missing steps)
+- **What would ideal process look like?** (steps, checkpoints, outputs)
+- **Who needs this?** (target users and their pain points)
+
+### 2. Process Flow
+
+- **How many phases?** (typically 3-10 major steps)
+- **What's the sequence?** (logical flow from start to finish)
+- **What decisions are needed?** (user choices that affect path)
+- **What's optional vs required?** (flexibility points)
+- **What checkpoints matter?** (validation, review, approval points)
+
+### 3. Inputs & Outputs
+
+- **What inputs are needed?** (documents, data, user answers)
+- **What outputs are generated?** (documents, code, configurations)
+- **What format?** (markdown, XML, YAML, actions)
+- **What quality criteria?** (how to validate success)
+
+### 4. Workflow Type & Style
+
+- **Document Workflow?** Creates structured documents (PRDs, specs, reports)
+- **Action Workflow?** Performs operations (refactoring, deployment, analysis)
+- **Interactive Workflow?** Guides creative process (brainstorming, planning)
+- **Autonomous Workflow?** Runs without user input (batch processing, generation)
+- **Meta Workflow?** Orchestrates other workflows (project setup, module creation)
+
+## Creative Constraints
+
+A great BMAD workflow should be:
+
+- **Focused**: Solves one problem well (not everything)
+- **Structured**: Clear phases with defined goals
+- **Flexible**: Optional steps, branching paths where appropriate
+- **Validated**: Checklist to verify completeness and quality
+- **Documented**: README explains when and how to use it
+
+## Workflow Architecture Questions
+
+### Core Structure
+
+1. **Workflow name** (kebab-case, e.g., "product-brief")
+2. **Purpose** (one sentence)
+3. **Type** (document/action/interactive/autonomous/meta)
+4. **Major phases** (3-10 high-level steps)
+5. **Output** (what gets created)
+
+### Process Details
+
+1. **Required inputs** (what user must provide)
+2. **Optional inputs** (what enhances results)
+3. **Decision points** (where user chooses path)
+4. **Checkpoints** (where to pause for approval)
+5. **Variables** (data passed between steps)
+
+### Quality & Validation
+
+1. **Success criteria** (what defines "done")
+2. **Validation checklist** (measurable quality checks)
+3. **Common issues** (troubleshooting guidance)
+4. **Best practices** (tips for optimal results)
+
+## Workflow Pattern Examples
+
+### Document Generation Workflows
+
+- **Product Brief**: Idea → Vision → Features → Market → Output
+- **PRD**: Requirements → User Stories → Acceptance Criteria → Document
+- **Architecture**: Requirements → Decisions → Design → Diagrams → ADRs
+- **Technical Spec**: Epic → Implementation → Testing → Deployment → Doc
+
+### Action Workflows
+
+- **Code Refactoring**: Analyze → Plan → Refactor → Test → Commit
+- **Deployment**: Build → Test → Stage → Validate → Deploy → Monitor
+- **Migration**: Assess → Plan → Convert → Validate → Deploy
+- **Analysis**: Collect → Process → Analyze → Report → Recommend
+
+### Interactive Workflows
+
+- **Brainstorming**: Setup → Generate → Expand → Evaluate → Prioritize
+- **Planning**: Context → Goals → Options → Decisions → Plan
+- **Review**: Load → Analyze → Critique → Suggest → Document
+
+### Meta Workflows
+
+- **Project Setup**: Plan → Architecture → Stories → Setup → Initialize
+- **Module Creation**: Brainstorm → Brief → Agents → Workflows → Install
+- **Sprint Planning**: Backlog → Capacity → Stories → Commit → Kickoff
+
+## Workflow Design Patterns
+
+### Linear Flow
+
+Simple sequence: Step 1 → Step 2 → Step 3 → Done
+
+**Good for:**
+
+- Document generation
+- Structured analysis
+- Sequential builds
+
+### Branching Flow
+
+Conditional paths: Step 1 → [Decision] → Path A or Path B → Merge → Done
+
+**Good for:**
+
+- Different project types
+- Optional deep dives
+- Scale-adaptive processes
+
+### Iterative Flow
+
+Refinement loops: Step 1 → Step 2 → [Review] → (Repeat if needed) → Done
+
+**Good for:**
+
+- Creative processes
+- Quality refinement
+- Approval cycles
+
+### Router Flow
+
+Type selection: [Select Type] → Load appropriate instructions → Execute → Done
+
+**Good for:**
+
+- Multi-mode workflows
+- Reusable frameworks
+- Flexible tools
+
+## Suggested Brainstorming Techniques
+
+Particularly effective for workflow ideation:
+
+1. **Process Mapping**: Draw current painful process, identify improvements
+2. **Step Decomposition**: Break complex task into atomic steps
+3. **Checkpoint Thinking**: Where do users need pause/review/decision?
+4. **Pain Point Analysis**: What makes current process frustrating?
+5. **Success Visualization**: What does perfect execution look like?
+
+## Key Questions to Answer
+
+1. What manual process needs structure and guidance?
+2. What makes this process hard or inconsistent today?
+3. What are the 3-10 major phases/steps?
+4. What document or output gets created?
+5. What inputs are required from the user?
+6. What decisions or choices affect the flow?
+7. What quality criteria define success?
+8. Document, Action, Interactive, Autonomous, or Meta workflow?
+9. What makes this workflow valuable vs doing it manually?
+10. What would make this workflow delightful to use?
+
+## Output Goals
+
+Generate:
+
+- **Workflow name**: Clear, describes the process
+- **Purpose statement**: One sentence explaining value
+- **Workflow type**: Classification with rationale
+- **Phase outline**: 3-10 major steps with goals
+- **Input/output description**: What goes in, what comes out
+- **Key decisions**: Where user makes choices
+- **Success criteria**: How to know it worked
+- **Unique value**: Why this workflow beats manual process
+- **Use cases**: 3-5 scenarios where this workflow shines
+
+---
+
+_This focused context helps create valuable, structured BMAD workflows_

src/modules/bmb/workflows/create-workflow/checklist.md

@@ -0,0 +1,72 @@
+# Build Workflow - Validation Checklist
+
+## Workflow Configuration (workflow.yaml)
+
+- [ ] Name follows kebab-case convention
+- [ ] Description clearly states workflow purpose
+- [ ] All paths use proper variable substitution
+- [ ] installed_path points to correct module location
+- [ ] template/instructions paths are correct for workflow type
+- [ ] Output file pattern is appropriate
+- [ ] YAML syntax is valid (no parsing errors)
+
+## Instructions Structure (instructions.md)
+
+- [ ] Critical headers reference workflow engine
+- [ ] All steps have sequential numbering
+- [ ] Each step has a clear goal attribute
+- [ ] Optional steps marked with optional="true"
+- [ ] Repeating steps have appropriate repeat attributes
+- [ ] All template-output tags have unique variable names
+- [ ] Flow control (if any) has valid step references
+
+## Template Structure (if document workflow)
+
+- [ ] All sections have appropriate placeholders
+- [ ] Variable names match template-output tags exactly
+- [ ] Markdown formatting is valid
+- [ ] Date and metadata fields included
+- [ ] No unreferenced variables remain
+
+## Content Quality
+
+- [ ] Instructions are specific and actionable
+- [ ] Examples provided where helpful
+- [ ] Limits set for lists and content length
+- [ ] User prompts are clear
+- [ ] Step goals accurately describe outcomes
+
+## Validation Checklist (if present)
+
+- [ ] Criteria are measurable and specific
+- [ ] Checks grouped logically by category
+- [ ] Final validation summary included
+- [ ] All critical requirements covered
+
+## File System
+
+- [ ] Workflow folder created in correct module
+- [ ] All required files present based on workflow type
+- [ ] File permissions allow execution
+- [ ] No placeholder text remains (like {TITLE})
+
+## Testing Readiness
+
+- [ ] Workflow can be invoked without errors
+- [ ] All required inputs are documented
+- [ ] Output location is writable
+- [ ] Dependencies (if any) are available
+
+## Documentation
+
+- [ ] README created (if requested)
+- [ ] Usage instructions clear
+- [ ] Example command provided
+- [ ] Special requirements noted
+
+## Final Validation
+
+- [ ] Configuration: No issues
+- [ ] Instructions: Complete and clear
+- [ ] Template: Variables properly mapped
+- [ ] Testing: Ready for test run

src/modules/bmb/workflows/create-workflow/instructions.md

@@ -0,0 +1,267 @@
+# Build Workflow - Workflow Builder Instructions
+
+<workflow>
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-workflow/workflow.yaml</critical>
+<critical>You MUST fully understand the workflow creation guide at: {workflow_creation_guide}</critical>
+<critical>Study the guide thoroughly to follow ALL conventions for optimal human-AI collaboration</critical>
+
+<step n="-1" goal="Optional brainstorming phase" optional="true">
+<ask>Do you want to brainstorm workflow ideas first? [y/n]</ask>
+
+<action if="user_response == 'y' or user_response == 'yes'">
+Invoke brainstorming workflow to explore ideas and design concepts:
+- Workflow: {project-root}/bmad/cis/workflows/brainstorming/workflow.yaml
+- Context data: {installed_path}/brainstorm-context.md
+- Purpose: Generate creative workflow ideas, explore different approaches, and clarify requirements
+
+The brainstorming output will inform:
+
+- Workflow purpose and goals
+- Workflow type selection
+- Step design and structure
+- User experience considerations
+- Technical requirements
+  </action>
+
+<action if="user_response == 'n' or user_response == 'no'">
+Skip brainstorming and proceed directly to workflow building process.
+</action>
+</step>
+
+<step n="0" goal="Load and understand workflow conventions">
+<action>Load the complete workflow creation guide from: {workflow_creation_guide}</action>
+<action>Study all sections thoroughly including:
+  - Core concepts (tasks vs workflows, workflow types)
+  - Workflow structure (required/optional files, patterns)
+  - Writing instructions (step attributes, XML tags, flow control)
+  - Templates and variables (syntax, naming, sources)
+  - Validation best practices
+  - Common pitfalls to avoid
+</action>
+<action>Load template files from: {workflow_template_path}/</action>
+<critical>You must follow ALL conventions from the guide to ensure optimal human-AI collaboration</critical>
+</step>
+
+<step n="1" goal="Define workflow purpose and type">
+Ask the user:
+- What is the workflow name? (kebab-case, e.g., "product-brief")
+- What module will it belong to? (e.g., "bmm", "bmb", "cis")
+  - Store as {{target_module}} for output path determination
+- What is the workflow's main purpose?
+- What type of workflow is this?
+  - Document workflow (generates documents like PRDs, specs)
+  - Action workflow (performs actions like refactoring)
+  - Interactive workflow (guided sessions)
+  - Autonomous workflow (runs without user input)
+  - Meta-workflow (coordinates other workflows)
+
+Based on type, determine which files are needed:
+
+- Document: workflow.yaml + template.md + instructions.md + checklist.md
+- Action: workflow.yaml + instructions.md
+- Others: Varies based on requirements
+
+<critical>Check {src_impact} variable to determine output location:</critical>
+
+- If {src_impact} = true: Workflow will be saved to {src_output_folder}
+- If {src_impact} = false: Workflow will be saved to {default_output_folder}
+
+Store decisions for later use.
+</step>
+
+<step n="2" goal="Gather workflow metadata">
+Collect essential configuration details:
+- Description (clear purpose statement)
+- Author name (default to user_name or "BMad")
+- Output file naming pattern
+- Any required input documents
+- Any required tools or dependencies
+
+Create the workflow name in kebab-case and verify it doesn't conflict with existing workflows.
+</step>
+
+<step n="3" goal="Design workflow steps">
+Work with user to outline the workflow steps:
+- How many major steps? (Recommend 5-10 max)
+- What is the goal of each step?
+- Which steps are optional?
+- Which steps need user input?
+- Which steps should repeat?
+- What variables/outputs does each step produce?
+
+Create a step outline with clear goals and outputs.
+</step>
+
+<step n="4" goal="Create workflow.yaml">
+Load and use the template at: {template_workflow_yaml}
+
+Replace all placeholders following the workflow creation guide conventions:
+
+- {TITLE} → Proper case workflow name
+- {WORKFLOW_CODE} → kebab-case name
+- {WORKFLOW_DESCRIPTION} → Clear description
+- {module-code} → Target module
+- {file.md} → Output filename pattern
+
+Include:
+
+- All metadata from steps 1-2
+- Proper paths for installed_path using variable substitution
+- Template/instructions/validation paths based on workflow type:
+  - Document workflow: all files (template, instructions, validation)
+  - Action workflow: instructions only (template: false)
+  - Autonomous: set autonomous: true flag
+- Required tools if any
+- Recommended inputs if any
+
+Follow path conventions from guide:
+
+- Use {project-root} for absolute paths
+- Use {installed_path} for workflow components
+- Use {config_source} for config references
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Write to {src_output_folder}/workflow.yaml
+- If {src_impact} = false: Write to {default_output_folder}/workflow.yaml
+  </step>
+
+<step n="5" goal="Create instructions.md" if="workflow_type != 'template-only'">
+Load and use the template at: {template_instructions}
+
+Generate the instructions.md file following the workflow creation guide:
+
+1. ALWAYS include critical headers:
+   - Workflow engine reference: {project_root}/bmad/core/tasks/workflow.md
+   - workflow.yaml reference: must be loaded and processed
+
+2. Structure with <workflow> tags containing all steps
+
+3. For each step from design phase, follow guide conventions:
+   - Step attributes: n="X" goal="clear goal statement"
+   - Optional steps: optional="true"
+   - Repeating: repeat="3" or repeat="for-each-X" or repeat="until-approved"
+   - Conditional: if="condition"
+   - Sub-steps: Use 3a, 3b notation
+
+4. Use proper XML tags from guide:
+   - Execution: <action>, <check>, <ask>, <goto>, <invoke-workflow>
+   - Output: <template-output>, <elicit-required/>, <critical>, <example>
+   - Flow: <loop>, <break>, <continue>
+
+5. Best practices from guide:
+   - Keep steps focused (single goal)
+   - Be specific ("Write 1-2 paragraphs" not "Write about")
+   - Provide examples where helpful
+   - Set limits ("3-5 items maximum")
+   - Save checkpoints with <template-output>
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Write to {src_output_folder}/instructions.md
+- If {src_impact} = false: Write to {default_output_folder}/instructions.md
+  </step>
+
+<step n="6" goal="Create template.md" if="workflow_type == 'document'">
+Load and use the template at: {template_template}
+
+Generate the template.md file following guide conventions:
+
+1. Document structure with clear sections
+2. Variable syntax: {{variable_name}} using snake_case
+3. Variable names MUST match <template-output> tags exactly from instructions
+4. Include standard metadata:
+   - **Date:** {{date}}
+   - **Author:** {{user_name}} (if applicable)
+5. Follow naming conventions from guide:
+   - Use descriptive names: {{primary_user_journey}} not {{puj}}
+   - Snake_case for all variables
+   - Match instruction outputs precisely
+
+Variable sources as per guide:
+
+- workflow.yaml config values
+- User input runtime values
+- Step outputs via <template-output>
+- System variables (date, paths)
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Write to {src_output_folder}/template.md
+- If {src_impact} = false: Write to {default_output_folder}/template.md
+  </step>
+
+<step n="7" goal="Create validation checklist" optional="true">
+Ask if user wants a validation checklist. If yes:
+
+Load and use the template at: {template_checklist}
+
+Create checklist.md following guide best practices:
+
+1. Make criteria MEASURABLE and SPECIFIC
+   ❌ "- [ ] Good documentation"
+   ✅ "- [ ] Each function has JSDoc comments with parameters and return types"
+
+2. Group checks logically:
+   - Structure: All sections present, no placeholders, proper formatting
+   - Content Quality: Clear and specific, technically accurate, consistent terminology
+   - Completeness: Ready for next phase, dependencies documented, action items defined
+
+3. Include workflow-specific validations based on type:
+   - Document workflows: Template variables mapped, sections complete
+   - Action workflows: Actions clearly defined, error handling specified
+   - Interactive: User prompts clear, decision points documented
+
+4. Add final validation section with issue lists
+
+<critical>Determine save location based on {src_impact}:</critical>
+
+- If {src_impact} = true: Write to {src_output_folder}/checklist.md
+- If {src_impact} = false: Write to {default_output_folder}/checklist.md
+  </step>
+
+<step n="8" goal="Create supporting files" optional="true">
+Ask if any supporting data files are needed:
+- CSV files with data
+- Example documents
+- Reference materials
+
+If yes, create placeholder files or copy from templates.
+</step>
+
+<step n="9" goal="Test and validate workflow">
+Review the created workflow:
+1. Verify all file paths are correct
+2. Check variable names match between files
+3. Ensure step numbering is sequential
+4. Validate YAML syntax
+5. Confirm all placeholders are replaced
+
+Show user a summary of created files and their locations.
+Ask if they want to:
+
+- Test run the workflow
+- Make any adjustments
+- Add additional steps or features
+  </step>
+
+<step n="10" goal="Document and finalize">
+Create a brief README for the workflow folder explaining:
+- Purpose and use case
+- How to invoke: `workflow {workflow_name}`
+- Expected inputs
+- Generated outputs
+- Any special requirements
+
+Provide user with:
+
+- Location of created workflow:
+  - If {src_impact} = true: {{src_output_folder}}
+  - If {src_impact} = false: {{default_output_folder}}
+- Command to run it
+- Next steps for testing
+  </step>
+
+</workflow>

src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md

@@ -0,0 +1,456 @@
+# BMAD Workflow Creation Guide
+
+Create structured, repeatable workflows for human-AI collaboration in BMAD v6.
+
+## Table of Contents
+
+1. [Quick Start](#quick-start)
+2. [Core Concepts](#core-concepts)
+3. [Workflow Structure](#workflow-structure)
+4. [Writing Instructions](#writing-instructions)
+5. [Templates & Variables](#templates--variables)
+6. [Flow Control](#flow-control)
+7. [Validation](#validation)
+8. [Examples](#examples)
+9. [Best Practices](#best-practices)
+10. [Troubleshooting](#troubleshooting)
+
+## Quick Start
+
+### Minimal Workflow (3 minutes)
+
+Create a folder with these files:
+
+```yaml
+# workflow.yaml (REQUIRED)
+name: 'my-workflow'
+description: 'What this workflow does'
+installed_path: '{project-root}/bmad/module/workflows/my-workflow'
+template: '{installed_path}/template.md'
+instructions: '{installed_path}/instructions.md'
+default_output_file: '{output_folder}/output.md'
+```
+
+```markdown
+# template.md
+
+# {{project_name}} Output
+
+{{main_content}}
+```
+
+```markdown
+# instructions.md
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: workflow.yaml</critical>
+
+<workflow>
+<step n="1" goal="Generate content">
+Create the main content for this document.
+<template-output>main_content</template-output>
+</step>
+</workflow>
+```
+
+That's it! To execute, tell the BMAD agent: `workflow my-workflow`
+
+## Core Concepts
+
+### Tasks vs Workflows
+
+| Aspect         | Task               | Workflow                |
+| -------------- | ------------------ | ----------------------- |
+| **Purpose**    | Single operation   | Multi-step process      |
+| **Format**     | XML in `.md` file  | Folder with YAML config |
+| **Location**   | `/src/core/tasks/` | `/bmad/*/workflows/`    |
+| **User Input** | Minimal            | Extensive               |
+| **Output**     | Variable           | Usually documents       |
+
+### Workflow Types
+
+1. **Document Workflows** - Generate PRDs, specs, architectures
+2. **Action Workflows** - Refactor code, run tools, orchestrate tasks
+3. **Interactive Workflows** - Brainstorming, meditations, guided sessions
+4. **Autonomous Workflows** - Run without human input (story generation)
+5. **Meta-Workflows** - Coordinate other workflows
+
+## Workflow Structure
+
+### Required Files
+
+```
+my-workflow/
+  └── workflow.yaml      # REQUIRED - Configuration
+```
+
+### Optional Files
+
+```
+my-workflow/
+  ├── template.md        # Document structure
+  ├── instructions.md    # Step-by-step guide
+  ├── checklist.md       # Validation criteria
+  └── [data files]       # Supporting resources
+```
+
+### workflow.yaml Configuration
+
+```yaml
+# Basic metadata
+name: 'workflow-name'
+description: 'Clear purpose statement'
+
+# Paths
+installed_path: '{project-root}/bmad/module/workflows/name'
+template: '{installed_path}/template.md' # or false
+instructions: '{installed_path}/instructions.md' # or false
+validation: '{installed_path}/checklist.md' # optional
+
+# Output
+default_output_file: '{output_folder}/document.md'
+
+# Advanced options
+autonomous: true # Skip user checkpoints
+recommended_inputs: # Expected input docs
+  - input_doc: 'path/to/doc.md'
+```
+
+### Common Patterns
+
+**Full Document Workflow** (most common)
+
+- Has: All 4 files
+- Use for: PRDs, architectures, specs
+
+**Action Workflow** (no template)
+
+- Has: workflow.yaml + instructions.md
+- Use for: Refactoring, tool orchestration
+
+**Autonomous Workflow** (no interaction)
+
+- Has: workflow.yaml + template + instructions
+- Use for: Automated generation
+
+## Writing Instructions
+
+### Basic Structure
+
+```markdown
+# instructions.md
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: workflow.yaml</critical>
+
+<workflow>
+
+<step n="1" goal="Clear goal statement">
+Instructions for this step.
+<template-output>variable_name</template-output>
+</step>
+
+<step n="2" goal="Next goal" optional="true">
+Optional step instructions.
+<template-output>another_variable</template-output>
+</step>
+
+</workflow>
+```
+
+### Step Attributes
+
+- `n="X"` - Step number (required)
+- `goal="..."` - What the step accomplishes (required)
+- `optional="true"` - User can skip
+- `repeat="3"` - Repeat N times
+- `if="condition"` - Conditional execution
+
+### Content Formats
+
+**Markdown Format** (human-friendly):
+
+```xml
+<step n="1" goal="Define goals">
+Write 1-3 bullet points about project success:
+- User outcomes
+- Business value
+- Measurable results
+
+<template-output>goals</template-output>
+</step>
+```
+
+**XML Format** (precise control):
+
+```xml
+<step n="2" goal="Validate input">
+  <action>Load validation criteria</action>
+  <check>If validation fails:</check>
+  <goto step="1">Return to previous step</goto>
+  <template-output>validated_data</template-output>
+</step>
+```
+
+## Templates & Variables
+
+### Variable Syntax
+
+```markdown
+# template.md
+
+# {{project_name}} Document
+
+## Section
+
+{{section_content}}
+
+_Generated on {{date}}_
+```
+
+### Variable Sources
+
+1. **workflow.yaml** - Config values
+2. **User input** - Runtime values
+3. **Step outputs** - `<template-output>` tags
+4. **System** - Date, paths, etc.
+
+### Naming Convention
+
+- Use snake_case: `{{user_requirements}}`
+- Be descriptive: `{{primary_user_journey}}` not `{{puj}}`
+
+## Flow Control
+
+### Sub-Steps
+
+```xml
+<step n="3" goal="Process items">
+  <step n="3a" title="Gather data">
+    <action>Collect information</action>
+  </step>
+
+  <step n="3b" title="Analyze">
+    <action>Process collected data</action>
+    <template-output>analysis</template-output>
+  </step>
+</step>
+```
+
+### Repetition
+
+```xml
+<!-- Fixed repetitions -->
+<step n="4" repeat="3">
+  <action>Generate example {{iteration}}</action>
+</step>
+
+<!-- Conditional repetition -->
+<step n="5" repeat="until-approved">
+  <action>Generate content</action>
+  <ask>Satisfactory? (y/n)</ask>
+</step>
+
+<!-- For-each repetition -->
+<step n="6" repeat="for-each-epic">
+  <action>Define epic {{epic_name}}</action>
+</step>
+```
+
+### Branching & Goto
+
+```xml
+<step n="7" goal="Validate">
+  <action>Check requirements</action>
+  <check>If incomplete:</check>
+  <goto step="2">Return to gathering</goto>
+  <check>If complete:</check>
+  <continue>Proceed</continue>
+</step>
+```
+
+### Loops
+
+```xml
+<step n="8" goal="Refine">
+  <loop max="5">
+    <action>Generate solution</action>
+    <check>If criteria met:</check>
+    <break>Exit loop</break>
+  </loop>
+</step>
+```
+
+### Common XML Tags
+
+**Execution:**
+
+- `<action>` - Required action
+- `<check>` - Conditional check
+- `<ask>` - User prompt
+- `<goto>` - Jump to step
+- `<invoke-workflow>` - Call another workflow
+
+**Output:**
+
+- `<template-output>` - Save checkpoint
+- `<elicit-required/>` - Trigger AI enhancement
+- `<critical>` - Important info
+- `<example>` - Show example
+
+## Validation
+
+### checklist.md Structure
+
+```markdown
+# Validation Checklist
+
+## Structure
+
+- [ ] All sections present
+- [ ] No placeholders remain
+- [ ] Proper formatting
+
+## Content Quality
+
+- [ ] Clear and specific
+- [ ] Technically accurate
+- [ ] Consistent terminology
+
+## Completeness
+
+- [ ] Ready for next phase
+- [ ] Dependencies documented
+- [ ] Action items defined
+```
+
+### Making Criteria Measurable
+
+❌ `- [ ] Good documentation`
+✅ `- [ ] Each function has JSDoc comments with parameters and return types`
+
+## Examples
+
+### Document Generation
+
+```xml
+<workflow>
+<step n="1" goal="Gather context">
+Load existing documents and understand project scope.
+<template-output>context</template-output>
+</step>
+
+<step n="2" goal="Define requirements">
+Create functional and non-functional requirements.
+<template-output>requirements</template-output>
+<elicit-required/>
+</step>
+
+<step n="3" goal="Validate">
+Check requirements against goals.
+<template-output>validated_requirements</template-output>
+</step>
+</workflow>
+```
+
+### Action Workflow
+
+```xml
+<workflow>
+<step n="1" goal="Analyze codebase">
+  <action>Find all API endpoints</action>
+  <action>Identify patterns</action>
+</step>
+
+<step n="2" goal="Refactor">
+  <repeat for-each="endpoint">
+    <action>Update to new pattern</action>
+  </repeat>
+</step>
+
+<step n="3" goal="Verify">
+  <action>Run tests</action>
+  <check>If tests fail:</check>
+  <goto step="2">Fix issues</goto>
+</step>
+</workflow>
+```
+
+### Meta-Workflow
+
+```xml
+<workflow name="greenfield-app">
+<step n="1" goal="Discovery">
+  <invoke-workflow>product-brief</invoke-workflow>
+  <template-output>brief</template-output>
+</step>
+
+<step n="2" goal="Requirements">
+  <invoke-workflow input="{{brief}}">prd</invoke-workflow>
+  <template-output>prd</template-output>
+</step>
+
+<step n="3" goal="Architecture">
+  <invoke-workflow input="{{prd}}">architecture</invoke-workflow>
+  <template-output>architecture</template-output>
+</step>
+</workflow>
+```
+
+## Best Practices
+
+### Design Principles
+
+1. **Keep steps focused** - Single goal per step
+2. **Limit scope** - 5-10 steps maximum
+3. **Build progressively** - Start simple, add detail
+4. **Checkpoint often** - Save after major sections
+5. **Make sections optional** - Let users skip when appropriate
+
+### Instruction Guidelines
+
+1. **Be specific** - "Write 1-2 paragraphs" not "Write about"
+2. **Provide examples** - Show expected output format
+3. **Set limits** - "3-5 items maximum"
+4. **Explain why** - Context helps AI make better decisions
+
+### Common Pitfalls
+
+- **Missing critical headers** - Always include workflow engine references
+- **Variables not replaced** - Ensure names match exactly
+- **Too many steps** - Combine related actions
+- **No checkpoints** - Add `<template-output>` tags
+- **Vague instructions** - Be explicit about expectations
+
+## Troubleshooting
+
+### Variables Not Replaced
+
+- Check exact name match
+- Verify `<template-output>` tag present
+- Ensure step generates the variable
+
+### Validation Fails
+
+- Review checklist specificity
+- Check for impossible requirements
+- Verify checklist matches template
+
+### Workflow Too Long
+
+- Combine related steps
+- Make sections optional
+- Reduce elicitation points
+
+### User Confusion
+
+- Add clearer step goals
+- Provide more examples
+- Explain section purpose
+
+---
+
+_For implementation details, see:_
+
+- `/src/core/tasks/workflow.md` - Execution engine
+- `/bmad/bmm/workflows/` - Production examples

src/modules/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

src/modules/bmb/workflows/create-workflow/workflow-template/instructions.md

@@ -0,0 +1,12 @@
+# PRD Workflow Instructions
+
+<workflow>
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/{module-code}/workflows/{workflow}/workflow.yaml</critical>
+
+<step n="1" goal="">
+...
+</step>
+...
+</workflow>

src/modules/bmb/workflows/create-workflow/workflow-template/template.md

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

src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml

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

src/modules/bmb/workflows/create-workflow/workflow.yaml

@@ -0,0 +1,42 @@
+# Build Workflow - Workflow Builder Configuration
+name: build-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"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+src_impact: "{config_source}:src_impact"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# 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/build-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 src_impact=true: Save to src/modules/{{target_module}}/workflows/{{workflow_name}}
+# If src_impact=false: Save to output_folder/workflows/{{workflow_name}}
+default_output_folder: "{output_folder}/workflows/{{workflow_name}}"
+src_output_folder: "{project-root}/src/modules/{{target_module}}/workflows/{{workflow_name}}"
+
+# No special tools required
+required_tools: []

src/modules/bmb/workflows/edit-workflow/README.md

@@ -0,0 +1,63 @@
+# Edit Workflow
+
+## Purpose
+
+An intelligent workflow editor that helps you modify existing BMAD workflows while adhering to all best practices and conventions documented in the workflow creation guide.
+
+## Use Case
+
+When you need to:
+
+- Fix issues in existing workflows
+- Update workflow configuration or metadata
+- Improve instruction clarity and specificity
+- Add new features or capabilities
+- Ensure compliance with BMAD workflow conventions
+
+## How to Invoke
+
+```
+workflow edit-workflow
+```
+
+Or through a BMAD agent:
+
+```
+*edit-workflow
+```
+
+## Expected Inputs
+
+- **Target workflow path**: Path to the workflow.yaml file or workflow folder you want to edit
+- **Edit type selection**: Choice of what aspect to modify
+- **User approval**: For each proposed change
+
+## Generated Outputs
+
+- Modified workflow files (in place)
+- Optional change log at: `{output_folder}/workflow-edit-log-{date}.md`
+
+## Features
+
+1. **Comprehensive Analysis**: Checks workflows against the official creation guide
+2. **Prioritized Issues**: Identifies and ranks issues by importance
+3. **Guided Editing**: Step-by-step process with explanations
+4. **Best Practices**: Ensures all edits follow BMAD conventions
+5. **Validation**: Checks all changes for correctness
+6. **Change Tracking**: Documents what was modified and why
+
+## Workflow Steps
+
+1. Load and analyze target workflow
+2. Check against best practices
+3. Select editing focus
+4. Load relevant documentation
+5. Perform edits with user approval
+6. Validate all changes (optional)
+7. Generate change summary
+
+## Requirements
+
+- Access to workflow creation guide
+- Read/write permissions for target workflow
+- Understanding of BMAD workflow types

src/modules/bmb/workflows/edit-workflow/checklist.md

@@ -0,0 +1,70 @@
+# Edit Workflow - Validation Checklist
+
+## Pre-Edit Analysis
+
+- [ ] Target workflow.yaml file successfully loaded and parsed
+- [ ] All referenced workflow files identified and accessible
+- [ ] Workflow type correctly determined (document/action/interactive/autonomous/meta)
+- [ ] Best practices guide loaded and available for reference
+
+## Edit Execution Quality
+
+- [ ] User clearly informed of identified issues with priority levels
+- [ ] Edit menu presented with all 8 standard options
+- [ ] Selected edit type matches the actual changes made
+- [ ] All proposed changes explained with reasoning before application
+
+## File Integrity
+
+- [ ] All modified files maintain valid YAML/Markdown syntax
+- [ ] No placeholders like {TITLE} or {WORKFLOW_CODE} remain in edited files
+- [ ] File paths use proper variable substitution ({project-root}, {installed_path})
+- [ ] All file references resolve to actual paths
+
+## Convention Compliance
+
+- [ ] Instructions.md contains critical workflow engine reference header
+- [ ] Instructions.md contains workflow.yaml processing reference header
+- [ ] All step numbers are sequential (1, 2, 3... or 1a, 1b, 2a...)
+- [ ] Each step has both n= attribute and goal= attribute
+- [ ] Variable names use snake_case consistently
+- [ ] Template variables (if any) match <template-output> tags exactly
+
+## Instruction Quality
+
+- [ ] Each step has a single, clear goal stated
+- [ ] Instructions are specific with quantities (e.g., "3-5 items" not "several items")
+- [ ] Optional steps marked with optional="true" attribute
+- [ ] Repeating steps use proper repeat syntax (repeat="3" or repeat="until-complete")
+- [ ] User prompts use <ask> tags and wait for response
+- [ ] Actions use <action> tags for required operations
+
+## Validation Criteria (if checklist.md exists)
+
+- [ ] All checklist items are measurable and specific
+- [ ] No vague criteria like "Good documentation" present
+- [ ] Checklist organized into logical sections
+- [ ] Each criterion can be objectively verified as true/false
+
+## Change Documentation
+
+- [ ] All changes logged with description of what and why
+- [ ] Change summary includes list of modified files
+- [ ] Improvements clearly articulated in relation to best practices
+- [ ] Next steps or recommendations provided
+
+## Post-Edit Verification
+
+- [ ] Edited workflow follows patterns from production examples
+- [ ] No functionality broken by the edits
+- [ ] Workflow ready for testing or production use
+- [ ] User given option to test the edited workflow
+
+## Common Issues Resolved
+
+- [ ] Missing critical headers added if they were absent
+- [ ] Broken variable references fixed
+- [ ] Vague instructions made specific
+- [ ] Template-only workflows have template.md file
+- [ ] Action workflows have template: false in workflow.yaml
+- [ ] Step count reasonable (5-10 steps maximum unless justified)

src/modules/bmb/workflows/edit-workflow/instructions.md

@@ -0,0 +1,170 @@
+# Edit Workflow - Workflow Editor Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.md</critical>
+<critical>You MUST have already loaded and processed: {project-root}/bmad/bmb/workflows/edit-workflow/workflow.yaml</critical>
+<critical>Study the workflow creation guide thoroughly at: {workflow_creation_guide}</critical>
+
+<workflow>
+
+<step n="1" goal="Load and analyze target workflow">
+<ask>What is the path to the workflow you want to edit? (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 (template.md, instructions.md, checklist.md, data files)</action>
+<action>Load any existing instructions.md and template.md files if present</action>
+
+Display a summary:
+
+- Workflow name and description
+- Type of workflow
+- Files present
+- Current structure overview
+  </step>
+
+<step n="2" goal="Analyze against best practices">
+<action>Load the complete workflow creation guide from: {workflow_creation_guide}</action>
+<action>Check the workflow against the guide's best practices:</action>
+
+Analyze for:
+
+- **Critical headers**: Are workflow engine references present?
+- **File structure**: Are all expected files present for this workflow type?
+- **Variable consistency**: Do variable names match between files?
+- **Step structure**: Are steps properly numbered and focused?
+- **XML tags**: Are tags used correctly and consistently?
+- **Instructions clarity**: Are instructions specific with examples and limits?
+- **Template variables**: Use snake_case and descriptive names?
+- **Validation criteria**: Are checklist items measurable and specific?
+
+<action>Create a list of identified issues or improvement opportunities</action>
+<action>Prioritize issues by importance (critical, important, nice-to-have)</action>
+</step>
+
+<step n="3" goal="Select editing focus">
+Present the editing menu to the user:
+
+**What aspect would you like to edit?**
+
+1. **Fix critical issues** - Address missing headers, broken references
+2. **Update workflow.yaml** - Modify configuration, paths, metadata
+3. **Refine instructions** - Improve steps, add detail, fix flow
+4. **Update template** - Fix variables, improve structure (if applicable)
+5. **Enhance validation** - Make checklist more specific and measurable
+6. **Add new features** - Add steps, optional sections, or capabilities
+7. **Optimize for clarity** - Improve descriptions, add examples
+8. **Full review and update** - Comprehensive improvements across all files
+
+<ask>Select an option (1-8) or describe a custom edit:</ask>
+</step>
+
+<step n="4" goal="Load relevant documentation">
+Based on the selected edit type, load appropriate reference materials:
+
+<check>If editing instructions or adding features:</check>
+<action>Review the "Writing Instructions" section of the creation guide</action>
+<action>Load example workflows from {project-root}/bmad/bmm/workflows/ for patterns</action>
+
+<check>If editing templates:</check>
+<action>Review the "Templates & Variables" section of the creation guide</action>
+<action>Ensure variable naming conventions are followed</action>
+
+<check>If editing validation:</check>
+<action>Review the "Validation" section and measurable criteria examples</action>
+
+<check>If fixing critical issues:</check>
+<action>Load the workflow execution engine documentation</action>
+<action>Verify all required elements are present</action>
+</step>
+
+<step n="5" goal="Perform edits" repeat="until-complete">
+Based on the selected focus area:
+
+<action>Show the current content that will be edited</action>
+<action>Explain the proposed changes and why they improve the workflow</action>
+<action>Generate the updated content following all conventions from the guide</action>
+
+<ask>Review the proposed changes. Options:
+
+- [a] Accept and apply
+- [e] Edit/modify the changes
+- [s] Skip this change
+- [n] Move to next file/section
+- [d] Done with edits
+  </ask>
+
+<check>If user selects 'a':</check>
+<action>Apply the changes to the file</action>
+<action>Log the change for the summary</action>
+
+<check>If user selects 'e':</check>
+<ask>What modifications would you like to make?</ask>
+<goto step="5">Regenerate with modifications</goto>
+
+<check>If user selects 'd':</check>
+<continue>Proceed to validation</continue>
+</step>
+
+<step n="6" goal="Validate all changes" optional="true">
+<action>Run a comprehensive validation check:</action>
+
+Validation checks:
+
+- [ ] All file paths resolve correctly
+- [ ] Variable names are consistent across files
+- [ ] Step numbering is sequential and logical
+- [ ] Required XML tags are properly formatted
+- [ ] No placeholders remain (like {TITLE} or {WORKFLOW_CODE})
+- [ ] Instructions match the workflow type
+- [ ] Template variables match instruction outputs (if applicable)
+- [ ] Checklist criteria are measurable (if present)
+- [ ] Critical headers are present in instructions
+- [ ] YAML syntax is valid
+
+<check>If any validation fails:</check>
+<ask>Issues found. Would you like to fix them? (y/n)</ask>
+<check>If yes:</check>
+<goto step="5">Return to editing</goto>
+</step>
+
+<step n="7" goal="Generate change summary">
+Create a summary of all changes made:
+
+## Workflow Edit Summary
+
+**Workflow:** {{workflow_name}}
+**Date:** {{date}}
+**Editor:** {{user_name}}
+
+### Changes Made:
+
+<action>List each file that was modified with a brief description of changes</action>
+
+### Improvements:
+
+<action>Summarize how the workflow is now better aligned with best practices</action>
+
+### Files Modified:
+
+<action>List all modified files with their paths</action>
+
+### Next Steps:
+
+<action>Suggest any additional improvements or testing that could be done</action>
+
+<ask>Would you like to:
+
+- Save this summary to: {change_log_output}
+- Test the edited workflow
+- Make additional edits
+- Exit
+  </ask>
+
+<check>If save summary:</check>
+<action>Write the summary to the change log file</action>
+
+<check>If test workflow:</check>
+<invoke-workflow>{{workflow_name}}</invoke-workflow>
+</step>
+
+</workflow>

src/modules/bmb/workflows/edit-workflow/workflow.yaml

@@ -0,0 +1,34 @@
+# Edit Workflow - Workflow Editor Configuration
+name: "edit-workflow"
+description: "Edit existing BMAD workflows while following all best practices and conventions"
+author: "BMad"
+
+# Critical variables load from config_source
+config_source: "{project-root}/bmad/bmb/config.yaml"
+output_folder: "{config_source}:output_folder"
+src_impact: "{config_source}:src_impact"
+communication_language: "{config_source}:communication_language"
+user_name: "{config_source}:user_name"
+date: system-generated
+
+# Required Data Files - Critical for understanding workflow conventions
+workflow_creation_guide: "{project-root}/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md"
+workflow_execution_engine: "{project-root}/bmad/core/tasks/workflow.md"
+
+# Optional docs that can be used to understand the target workflow
+recommended_inputs:
+  - target_workflow: "Path to the workflow.yaml file to edit"
+  - workflow_examples: "{project-root}/bmad/bmm/workflows/"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmb/workflows/edit-workflow"
+template: false # This is an action workflow - no template needed
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# No output file for action workflows
+# But we may generate a change log
+change_log_output: "{output_folder}/workflow-edit-log-{{date}}.md"
+
+# No special tools required for editing workflows
+required_tools: []