diff --git a/src/core/tasks/adv-elicit.md b/src/core/tasks/adv-elicit.md index c9622c95..b179c276 100644 --- a/src/core/tasks/adv-elicit.md +++ b/src/core/tasks/adv-elicit.md @@ -8,7 +8,7 @@ MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met - Each <action> within <step> is a REQUIRED action to complete that step + Each action xml tag within step xml tag is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution @@ -44,7 +44,7 @@ - + **Advanced Elicitation Options** diff --git a/src/core/tasks/index-docs.md b/src/core/tasks/index-docs.md index d85ca525..0bb0b7b3 100644 --- a/src/core/tasks/index-docs.md +++ b/src/core/tasks/index-docs.md @@ -8,7 +8,7 @@ MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met - Each <action> within <step> is a REQUIRED action to complete that step + Each action xml tag within step xml tag is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution diff --git a/src/core/tasks/shard-doc.md b/src/core/tasks/shard-doc.md index fb9e9ca2..96b03f3c 100644 --- a/src/core/tasks/shard-doc.md +++ b/src/core/tasks/shard-doc.md @@ -8,7 +8,7 @@ MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met - Each <action> within <step> is a REQUIRED action to complete that step + Each action xml tag within step xml tag is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution diff --git a/src/core/workflows/bmad-init/workflow.yaml b/src/core/workflows/bmad-init/workflow.yaml index 85231d8c..0c76ae26 100644 --- a/src/core/workflows/bmad-init/workflow.yaml +++ b/src/core/workflows/bmad-init/workflow.yaml @@ -11,14 +11,4 @@ date: system-generated 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 +web_bundle: false diff --git a/src/core/workflows/party-mode/workflow.yaml b/src/core/workflows/party-mode/workflow.yaml index 4fb4499e..93de8e6e 100644 --- a/src/core/workflows/party-mode/workflow.yaml +++ b/src/core/workflows/party-mode/workflow.yaml @@ -22,3 +22,5 @@ exit_triggers: - "*exit" - "end party mode" - "stop party mode" + +web_bundle: false diff --git a/src/modules/bmb/_module-installer/install-menu-config.yaml b/src/modules/bmb/_module-installer/install-menu-config.yaml index bb51723d..e7fe0b4d 100644 --- a/src/modules/bmb/_module-installer/install-menu-config.yaml +++ b/src/modules/bmb/_module-installer/install-menu-config.yaml @@ -9,8 +9,3 @@ prompt: "Happy Building - Build the Modules, Workflows and Agents of your dreams ## 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}" diff --git a/src/modules/bmb/workflows/convert-legacy/README.md b/src/modules/bmb/workflows/convert-legacy/README.md index f59edff5..a18849b9 100644 --- a/src/modules/bmb/workflows/convert-legacy/README.md +++ b/src/modules/bmb/workflows/convert-legacy/README.md @@ -8,7 +8,7 @@ The Convert Legacy workflow is a comprehensive migration tool that converts BMAD - **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 +- **Sub-Workflow Integration** - Leverages create-agent, create-workflow, and create-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 @@ -60,7 +60,7 @@ convert-legacy/ ### Phase 1: Legacy Analysis (Steps 1-3) -**Item Identification & Loading** +**Item Identification and Loading** - Accepts file path or directory from user - Loads complete file/folder structure for analysis @@ -91,10 +91,10 @@ convert-legacy/ **Strategy Selection Based on Item Type** - **Simple Agents**: Direct XML conversion with metadata mapping -- **Complex Agents**: Workflow-assisted creation using build-agent +- **Complex Agents**: Workflow-assisted creation using create-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 +- **Modules**: Full module creation using create-module workflow **Workflow Type Determination** @@ -118,9 +118,9 @@ convert-legacy/ - 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 + - `create-agent` for complex agent creation + - `create-workflow` for template/task conversion + - `create-module` for full module migration - Ensures proper v5 structure and conventions **Template-to-Workflow Conversion (5c)** @@ -139,7 +139,7 @@ convert-legacy/ - Maps 1-9 elicitation menus to v5 elicitation patterns - Preserves execution logic and critical notices -### Phase 4: Validation & Finalization (Steps 6-8) +### Phase 4: Validation and Finalization (Steps 6-8) **Comprehensive Validation** @@ -155,7 +155,7 @@ convert-legacy/ - Notes manual adjustments needed - Provides warnings and recommendations -**Cleanup & Archival** +**Cleanup and Archival** - Optional archival of original v4 files - Final location confirmation @@ -182,7 +182,7 @@ Converted items follow v5 conventions: - **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 +- **Sub-Workflow Availability** - create-agent, create-workflow, create-module workflows accessible - **Conversion Mappings** (optional) - v4-to-v5 pattern mappings for complex conversions ## Best Practices @@ -244,7 +244,7 @@ To customize this workflow: - **v1.0.0** - Initial release - Multi-format v4 item detection and conversion - - Integration with build-agent, build-workflow, build-module + - Integration with create-agent, create-workflow, create-module - Comprehensive path normalization - Migration reporting and validation @@ -252,7 +252,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-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 diff --git a/src/modules/bmb/workflows/convert-legacy/instructions.md b/src/modules/bmb/workflows/convert-legacy/instructions.md index acf61cda..168bf247 100644 --- a/src/modules/bmb/workflows/convert-legacy/instructions.md +++ b/src/modules/bmb/workflows/convert-legacy/instructions.md @@ -9,10 +9,10 @@ Ask user for the path to the v4 item to convert (agent, workflow, or module) Load the complete file/folder structure Detect item type based on structure and content patterns: - - Agent: Contains `` or `` XML tags, single file + - 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 `` XML tags + - Task: Contains task XML tags Confirm detected type or allow user to correct: "Detected as [type]. Is this correct? (y/n)" @@ -164,7 +164,7 @@ For Modules: - Any special behaviors - workflow: {project-root}/bmad/bmb/workflows/build-agent/workflow.yaml + workflow: {project-root}/bmad/bmb/workflows/create-agent/workflow.yaml inputs: - agent_name: {{extracted_name}} - agent_purpose: {{extracted_purpose}} @@ -201,7 +201,7 @@ For Modules: - Processing flow → integrate into workflow steps - workflow: {project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml + workflow: {project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml inputs: - workflow_name: {{template_name}} - workflow_type: document @@ -217,7 +217,7 @@ For Modules: Create module blueprint with all components - workflow: {project-root}/bmad/bmb/workflows/build-module/workflow.yaml + workflow: {project-root}/bmad/bmb/workflows/create-module/workflow.yaml inputs: - module_name: {{module_name}} - components: {{component_list}} @@ -259,7 +259,7 @@ For Modules: - Critical notices → workflow.yaml comments - workflow: {project-root}/bmad/bmb/workflows/build-workflow/workflow.yaml + workflow: {project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml inputs: - workflow_name: {{task_name}} - workflow_type: {{confirmed_workflow_type}} diff --git a/src/modules/bmb/workflows/convert-legacy/workflow.yaml b/src/modules/bmb/workflows/convert-legacy/workflow.yaml index 2af909cb..80e89868 100644 --- a/src/modules/bmb/workflows/convert-legacy/workflow.yaml +++ b/src/modules/bmb/workflows/convert-legacy/workflow.yaml @@ -14,7 +14,6 @@ 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" @@ -27,9 +26,8 @@ default_output_folder: "{project-root}/bmad/{{target_module}}/{{item_type}}/{{it # 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" + - create_agent: "{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml" + - create_workflow: "{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml" + - create_module: "{project-root}/bmad/bmb/workflows/create-module/workflow.yaml" -# No special tools required beyond standard BMAD capabilities -required_tools: [] +web_bundle: false diff --git a/src/modules/bmb/workflows/create-agent/README.md b/src/modules/bmb/workflows/create-agent/README.md index 7e754929..b8e04e96 100644 --- a/src/modules/bmb/workflows/create-agent/README.md +++ b/src/modules/bmb/workflows/create-agent/README.md @@ -19,7 +19,7 @@ The Build Agent workflow is an interactive agent builder that guides you through ### Basic Invocation ```bash -workflow build-agent +workflow create-agent ``` ### Through BMad Builder Agent @@ -49,7 +49,7 @@ The workflow includes an optional brainstorming phase (Step -1) that helps you e ### Files Included ``` -build-agent/ +create-agent/ ├── workflow.yaml # Configuration ├── instructions.md # Step-by-step guide ├── checklist.md # Validation criteria diff --git a/src/modules/bmb/workflows/create-agent/agent-command-patterns.md b/src/modules/bmb/workflows/create-agent/agent-command-patterns.md index d7a9b3c3..b9c7c699 100644 --- a/src/modules/bmb/workflows/create-agent/agent-command-patterns.md +++ b/src/modules/bmb/workflows/create-agent/agent-command-patterns.md @@ -318,7 +318,7 @@ Logic embedded in agent persona (Simple agents) Create PRD - Build module + Build module Validate document @@ -490,8 +490,8 @@ The `data` attribute can be added to ANY command type to provide supplementary i ### BMB (Builder) ```xml -Build Agent -Build Module +Build Agent +Build Module Create Workflow Module Brief ``` @@ -511,7 +511,7 @@ The `data` attribute can be added to ANY command type to provide supplementary i ``` 1. *help - Show numbered cmd list 2. *create-prd - Create Product Requirements Document -3. *build-agent - Build new BMAD agent +3. *create-agent - Build new BMAD agent 4. *validate - Validate document 5. *exit - Exit with confirmation ``` diff --git a/src/modules/bmb/workflows/create-agent/brainstorm-context.md b/src/modules/bmb/workflows/create-agent/brainstorm-context.md index 5c1b2ba5..88521186 100644 --- a/src/modules/bmb/workflows/create-agent/brainstorm-context.md +++ b/src/modules/bmb/workflows/create-agent/brainstorm-context.md @@ -20,28 +20,28 @@ An agent is an AI persona that embodies: Explore and define: -### 1. Agent Identity & Personality +### 1. Agent Identity and 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 +### 2. Expertise and 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 +### 3. Commands and 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 +### 4. Agent Type and Context - **Simple Agent?** Self-contained, no dependencies, quick utility - **Expert Agent?** Domain-specific with sidecar data/memory files diff --git a/src/modules/bmb/workflows/create-agent/communication-styles.md b/src/modules/bmb/workflows/create-agent/communication-styles.md index 9f42b8c0..db138057 100644 --- a/src/modules/bmb/workflows/create-agent/communication-styles.md +++ b/src/modules/bmb/workflows/create-agent/communication-styles.md @@ -6,7 +6,7 @@ Agents with distinct communication styles are more memorable, engaging, and fun ## Style Categories -### 🎬 Cinema & TV Inspired +### 🎬 Cinema and TV Inspired **Film Noir Detective** @@ -32,7 +32,7 @@ Whether 'tis nobler in the mind to suffer the slings and arrows of outrageous er Or to take arms against a sea of bugs, and by opposing, end them? ``` -### 🎮 Gaming & Pop Culture +### 🎮 Gaming and Pop Culture **Dungeon Master** @@ -118,7 +118,7 @@ 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 +### 🚀 Sci-Fi and Space **Star Trek Officer** diff --git a/src/modules/bmb/workflows/create-agent/instructions.md b/src/modules/bmb/workflows/create-agent/instructions.md index 52360819..fb73d9e8 100644 --- a/src/modules/bmb/workflows/create-agent/instructions.md +++ b/src/modules/bmb/workflows/create-agent/instructions.md @@ -1,7 +1,7 @@ # Build Agent - Interactive Agent Builder Instructions The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md -You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-agent/workflow.yaml +You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/create-agent/workflow.yaml Study agent examples in: {project_root}/bmad/bmm/agents/ for patterns diff --git a/src/modules/bmb/workflows/create-agent/workflow.yaml b/src/modules/bmb/workflows/create-agent/workflow.yaml index 5e485f73..e78be74d 100644 --- a/src/modules/bmb/workflows/create-agent/workflow.yaml +++ b/src/modules/bmb/workflows/create-agent/workflow.yaml @@ -1,5 +1,5 @@ # Build Agent Workflow Configuration -name: build-agent +name: create-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" @@ -23,7 +23,7 @@ recommended_inputs: - 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" +installed_path: "{project-root}/bmad/bmb/workflows/create-agent" template: false # This is an interactive workflow - no template needed instructions: "{installed_path}/instructions.md" validation: "{installed_path}/checklist.md" @@ -35,5 +35,14 @@ 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: [] +web_bundle: + name: "create-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" + web_bundle_files: + - "bmad/bmb/workflows/create-agent/instructions.md" + - "bmad/bmb/workflows/create-agent/checklist.md" + - "bmad/bmb/workflows/create-agent/agent-types.md" + - "bmad/bmb/workflows/create-agent/agent-architecture.md" + - "bmad/bmb/workflows/create-agent/agent-command-patterns.md" + - "bmad/bmb/workflows/create-agent/communication-styles.md" diff --git a/src/modules/bmb/workflows/create-module/README.md b/src/modules/bmb/workflows/create-module/README.md index 17b0055d..7122c9db 100644 --- a/src/modules/bmb/workflows/create-module/README.md +++ b/src/modules/bmb/workflows/create-module/README.md @@ -8,24 +8,24 @@ The Build Module workflow is an interactive scaffolding system that creates comp - **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 +- **Component Integration** - Seamless integration with create-agent and create-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 +- **Validation and Documentation** - Built-in validation checks and comprehensive README generation ## Usage ### Basic Invocation ```bash -workflow build-module +workflow create-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 +workflow create-module --input module-brief-my-module-2024-09-26.md ``` ### Configuration @@ -41,7 +41,7 @@ The workflow loads critical variables from the BMB configuration: ### Files Included ``` -build-module/ +create-module/ ├── workflow.yaml # Configuration and metadata ├── instructions.md # Step-by-step execution guide ├── checklist.md # Validation criteria @@ -56,7 +56,7 @@ build-module/ ### Phase 1: Concept Definition (Steps 1-2) -**Module Vision & Identity** +**Module Vision and Identity** - Define module concept, purpose, and target audience - Establish module code (kebab-case) and friendly name @@ -87,8 +87,8 @@ build-module/ **Interactive Component Building** -- Optional creation of first agent using build-agent workflow -- Optional creation of first workflow using build-workflow workflow +- Optional creation of first agent using create-agent workflow +- Optional creation of first workflow using create-workflow workflow - Creates placeholders for components to be built later **Workflow Integration** @@ -97,7 +97,7 @@ build-module/ - Ensures proper file placement and structure - Maintains module consistency across components -### Phase 4: Installation & Documentation (Steps 7-9) +### Phase 4: Installation and Documentation (Steps 7-9) **Installer Infrastructure** @@ -111,7 +111,7 @@ build-module/ - Creates development roadmap for remaining components - Provides quick commands for continued development -### Phase 5: Validation & Finalization (Step 10) +### Phase 5: Validation and Finalization (Step 10) **Quality Assurance** @@ -144,7 +144,7 @@ The workflow creates a complete module ready for development: - **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 +- **Build Tools Access** - create-agent and create-workflow workflows must be available ## Best Practices @@ -158,7 +158,7 @@ The workflow creates a complete module ready for development: 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 +3. **Leverage Sub-workflows** - Use create-agent and create-workflow for quality components 4. **Validate Early** - Review generated structure before proceeding to next phases ### After Completion @@ -179,7 +179,7 @@ The workflow creates a complete module ready for development: **Issue**: Sub-workflow invocation fails -- **Solution**: Ensure build-agent and build-workflow workflows are available +- **Solution**: Ensure create-agent and create-workflow workflows are available - **Check**: Validate workflow paths in config.yaml **Issue**: Installation configuration invalid @@ -200,7 +200,7 @@ To customize this workflow: - **v1.0.0** - Initial release - Interactive module scaffolding - - Component integration with build-agent and build-workflow + - Component integration with create-agent and create-workflow - Complete installation infrastructure - Module brief integration support @@ -208,7 +208,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-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 diff --git a/src/modules/bmb/workflows/create-module/brainstorm-context.md b/src/modules/bmb/workflows/create-module/brainstorm-context.md index 7da82fe3..8b0114ad 100644 --- a/src/modules/bmb/workflows/create-module/brainstorm-context.md +++ b/src/modules/bmb/workflows/create-module/brainstorm-context.md @@ -20,7 +20,7 @@ A module is a cohesive package that provides: Explore and define: -### 1. Domain & Purpose +### 1. Domain and Purpose - **What domain/problem space?** (e.g., game development, marketing, personal productivity) - **Who is the target user?** (developers, writers, managers, hobbyists) diff --git a/src/modules/bmb/workflows/create-module/checklist.md b/src/modules/bmb/workflows/create-module/checklist.md index 0b4913ee..c3e9200b 100644 --- a/src/modules/bmb/workflows/create-module/checklist.md +++ b/src/modules/bmb/workflows/create-module/checklist.md @@ -1,6 +1,6 @@ # Build Module Validation Checklist -## Module Identity & Metadata +## Module Identity and Metadata ### Basic Information @@ -165,7 +165,7 @@ - [ ] Component organization is logical - [ ] No hard-coded limits -## Testing & Validation +## Testing and Validation ### Structural Validation diff --git a/src/modules/bmb/workflows/create-module/instructions.md b/src/modules/bmb/workflows/create-module/instructions.md index a0c03012..ef9bf014 100644 --- a/src/modules/bmb/workflows/create-module/instructions.md +++ b/src/modules/bmb/workflows/create-module/instructions.md @@ -1,7 +1,7 @@ # Build Module - Interactive Module Builder Instructions The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md -You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-module/workflow.yaml +You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/create-module/workflow.yaml Study existing modules in: {project_root}/bmad/ for patterns @@ -10,8 +10,8 @@ Do you want to brainstorm module ideas first? [y/n] If yes: -Invoke brainstorming workflow: {project-root}/bmad/cis/workflows/brainstorming/workflow.yaml -Pass context data: {installed_path}/brainstorm-context.md +Invoke brainstorming workflow: {brainstorming-workflow} +Pass context data: {brainstorming_context} Wait for brainstorming session completion Use brainstorming output to inform module concept, agent lineup, and workflow portfolio @@ -215,7 +215,7 @@ If no, create placeholder: ```md # {{primary_agent_name}} Agent - + ``` @@ -402,8 +402,8 @@ Key settings: To extend this module: -1. Add new agents using `build-agent` workflow -2. Add new workflows using `build-workflow` workflow +1. Add new agents using `create-agent` workflow +2. Add new workflows using `create-workflow` workflow 3. Submit improvements via pull request ## Author @@ -428,7 +428,7 @@ Create a development roadmap for remaining components: ## Phase 2: Enhanced Features {{phase2_tasks}} -## Phase 3: Polish & Integration +## Phase 3: Polish and Integration {{phase3_tasks}} ## Quick Commands @@ -436,14 +436,14 @@ Create a development roadmap for remaining components: Create new agent: ```` -workflow build-agent +workflow create-agent ``` Create new workflow: ``` -workflow build-workflow +workflow create-workflow ``` diff --git a/src/modules/bmb/workflows/create-module/workflow.yaml b/src/modules/bmb/workflows/create-module/workflow.yaml index d030c91b..c36fca6e 100644 --- a/src/modules/bmb/workflows/create-module/workflow.yaml +++ b/src/modules/bmb/workflows/create-module/workflow.yaml @@ -1,5 +1,5 @@ # Build Module Workflow Configuration -name: build-module +name: create-module description: "Interactive workflow to build complete BMAD modules with agents, workflows, tasks, and installation infrastructure" author: "BMad" @@ -17,8 +17,10 @@ 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" +agent_builder: "{project-root}/bmad/bmb/workflows/create-agent/workflow.yaml" +workflow_builder: "{project-root}/bmad/bmb/workflows/create-workflow/workflow.yaml" +brainstorming_workflow: "{project-root}/bmad/cis/workflows/brainstorming/workflow.yaml" +brainstorming_context: "{installed_path}/brainstorm-context.md" # Optional docs that help understand module patterns recommended_inputs: @@ -30,7 +32,7 @@ recommended_inputs: - existing_workflows: "{project-root}/bmad/*/workflows/" # Module path and component files -installed_path: "{project-root}/bmad/bmb/workflows/build-module" +installed_path: "{project-root}/bmad/bmb/workflows/create-module" template: false # This is an interactive scaffolding workflow instructions: "{installed_path}/instructions.md" validation: "{installed_path}/checklist.md" @@ -43,5 +45,17 @@ 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: [] +web_bundle: + name: "create-module" + description: "Interactive workflow to build complete BMAD modules with agents, workflows, tasks, and installation infrastructure" + author: "BMad" + web_bundle_files: + - "bmad/bmb/workflows/create-module/instructions.md" + - "bmad/bmb/workflows/create-module/checklist.md" + - "bmad/bmb/workflows/create-module/module-structure.md" + - "bmad/bmb/workflows/create-module/example-modules.md" + - "bmad/bmb/workflows/create-module/brainstorm-context.md" + existing_workflows: + - agent_builder: "bmad/bmb/workflows/create-agent/workflow.yaml" + - workflow_builder: "bmad/bmb/workflows/create-workflow/workflow.yaml" + - brainstorming_workflow: "bmad/cis/workflows/brainstorming/workflow.yaml" diff --git a/src/modules/bmb/workflows/create-workflow/README.md b/src/modules/bmb/workflows/create-workflow/README.md index d72aa64c..45b71a72 100644 --- a/src/modules/bmb/workflows/create-workflow/README.md +++ b/src/modules/bmb/workflows/create-workflow/README.md @@ -19,7 +19,7 @@ The Build Workflow is an interactive workflow builder that guides you through cr ### Basic Invocation ```bash -workflow build-workflow +workflow create-workflow ``` ### Through BMad Builder Agent @@ -42,7 +42,7 @@ workflow build-workflow ### Files Included ``` -build-workflow/ +create-workflow/ ├── workflow.yaml # Configuration and metadata ├── instructions.md # Step-by-step execution guide ├── checklist.md # Validation criteria @@ -87,7 +87,7 @@ The brainstorming phase invokes the CIS brainstorming workflow to: - Generate validation checklist - Create supporting data files (optional) -### Phase 3: Documentation & Validation (Steps 9-11) +### Phase 3: Documentation and Validation (Steps 9-11) - Create comprehensive README.md (MANDATORY) - Test and validate workflow structure @@ -142,7 +142,7 @@ For document workflows, the README documents: ### Creative Workflow Design -The build-workflow now supports a **seamless transition from creative ideation to structured implementation**: +The create-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 @@ -206,9 +206,9 @@ To modify this workflow: For issues or questions: -- Review `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Check existing workflows in `/bmad/bmm/workflows/` for examples -- Validate against `/bmad/bmb/workflows/build-workflow/checklist.md` +- Validate against `/bmad/bmb/workflows/create-workflow/checklist.md` - Consult BMAD Method v6 documentation --- diff --git a/src/modules/bmb/workflows/create-workflow/brainstorm-context.md b/src/modules/bmb/workflows/create-workflow/brainstorm-context.md index 189e3c3d..345c6dc8 100644 --- a/src/modules/bmb/workflows/create-workflow/brainstorm-context.md +++ b/src/modules/bmb/workflows/create-workflow/brainstorm-context.md @@ -20,7 +20,7 @@ A workflow is a structured process that provides: Explore and define: -### 1. Problem & Purpose +### 1. Problem and Purpose - **What task needs structure?** (specific process users struggle with) - **Why is this hard manually?** (complexity, inconsistency, missing steps) @@ -35,14 +35,14 @@ Explore and define: - **What's optional vs required?** (flexibility points) - **What checkpoints matter?** (validation, review, approval points) -### 3. Inputs & Outputs +### 3. Inputs and 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 +### 4. Workflow Type and Style - **Document Workflow?** Creates structured documents (PRDs, specs, reports) - **Action Workflow?** Performs operations (refactoring, deployment, analysis) @@ -78,7 +78,7 @@ A great BMAD workflow should be: 4. **Checkpoints** (where to pause for approval) 5. **Variables** (data passed between steps) -### Quality & Validation +### Quality and Validation 1. **Success criteria** (what defines "done") 2. **Validation checklist** (measurable quality checks) diff --git a/src/modules/bmb/workflows/create-workflow/instructions.md b/src/modules/bmb/workflows/create-workflow/instructions.md index fa249daf..f3b7bd1c 100644 --- a/src/modules/bmb/workflows/create-workflow/instructions.md +++ b/src/modules/bmb/workflows/create-workflow/instructions.md @@ -3,7 +3,7 @@ The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md -You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/build-workflow/workflow.yaml +You MUST have already loaded and processed: {project_root}/bmad/bmb/workflows/create-workflow/workflow.yaml You MUST fully understand the workflow creation guide at: {workflow_creation_guide} Study the guide thoroughly to follow ALL conventions for optimal human-AI collaboration diff --git a/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md b/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md index c8f5a15a..c1c5cd37 100644 --- a/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +++ b/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md @@ -8,7 +8,7 @@ Create structured, repeatable workflows for human-AI collaboration in BMAD v6. 2. [Core Concepts](#core-concepts) 3. [Workflow Structure](#workflow-structure) 4. [Writing Instructions](#writing-instructions) -5. [Templates & Variables](#templates--variables) +5. [Templates and Variables](#templates--variables) 6. [Flow Control](#flow-control) 7. [Validation](#validation) 8. [Examples](#examples) @@ -192,7 +192,7 @@ Write 1-3 bullet points about project success: ``` -## Templates & Variables +## Templates and Variables ### Variable Syntax @@ -257,7 +257,7 @@ _Generated on {{date}}_ ``` -### Branching & Goto +### Branching and Goto ```xml diff --git a/src/modules/bmb/workflows/create-workflow/workflow.yaml b/src/modules/bmb/workflows/create-workflow/workflow.yaml index 2b2dd190..33bccf80 100644 --- a/src/modules/bmb/workflows/create-workflow/workflow.yaml +++ b/src/modules/bmb/workflows/create-workflow/workflow.yaml @@ -1,5 +1,5 @@ # Build Workflow - Workflow Builder Configuration -name: build-workflow +name: create-workflow description: "Interactive workflow builder that guides creation of new BMAD workflows with proper structure and validation for optimal human-AI collaboration. Includes optional brainstorming phase for workflow ideas and design." author: "BMad Builder" @@ -23,7 +23,7 @@ recommended_inputs: - bmm_workflows: "{project-root}/bmad/bmm/workflows/" # Module path and component files -installed_path: "{project-root}/bmad/bmb/workflows/build-workflow" +installed_path: "{project-root}/bmad/bmb/workflows/create-workflow" template: false # This is an action workflow - no template needed instructions: "{installed_path}/instructions.md" validation: "{installed_path}/checklist.md" @@ -38,5 +38,15 @@ workflow_template_path: "{installed_path}/workflow-template" 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: [] +web_bundle: + name: "create-workflow" + description: "Interactive workflow builder that guides creation of new BMAD workflows with proper structure and validation for optimal human-AI collaboration. Includes optional brainstorming phase for workflow ideas and design." + author: "BMad Builder" + web_bundle_files: + - "bmad/bmb/workflows/create-workflow/instructions.md" + - "bmad/bmb/workflows/create-workflow/checklist.md" + - "bmad/bmb/workflows/create-workflow/workflow-creation-guide.md" + - "bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml" + - "bmad/bmb/workflows/create-workflow/workflow-template/instructions.md" + - "bmad/bmb/workflows/create-workflow/workflow-template/template.md" + - "bmad/bmb/workflows/create-workflow/workflow-template/checklist.md" diff --git a/src/modules/bmb/workflows/edit-workflow/instructions.md b/src/modules/bmb/workflows/edit-workflow/instructions.md index f9b33c0d..7a971b61 100644 --- a/src/modules/bmb/workflows/edit-workflow/instructions.md +++ b/src/modules/bmb/workflows/edit-workflow/instructions.md @@ -66,7 +66,7 @@ Based on the selected edit type, load appropriate reference materials: Load example workflows from {project-root}/bmad/bmm/workflows/ for patterns If editing templates: -Review the "Templates & Variables" section of the creation guide +Review the "Templates and Variables" section of the creation guide Ensure variable naming conventions are followed If editing validation: diff --git a/src/modules/bmb/workflows/edit-workflow/workflow.yaml b/src/modules/bmb/workflows/edit-workflow/workflow.yaml index 75d2195e..b820f8b6 100644 --- a/src/modules/bmb/workflows/edit-workflow/workflow.yaml +++ b/src/modules/bmb/workflows/edit-workflow/workflow.yaml @@ -12,7 +12,7 @@ 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_creation_guide: "{project-root}/bmad/bmb/workflows/create-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 @@ -30,5 +30,10 @@ validation: "{installed_path}/checklist.md" # 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: [] +web_bundle: + name: "edit-workflow" + description: "Edit existing BMAD workflows while following all best practices and conventions" + author: "BMad" + web_bundle_files: + - "bmad/bmb/workflows/edit-workflow/instructions.md" + - "bmad/bmb/workflows/edit-workflow/checklist.md" diff --git a/src/modules/bmb/workflows/module-brief/README.md b/src/modules/bmb/workflows/module-brief/README.md index d3a29e63..f65e0d21 100644 --- a/src/modules/bmb/workflows/module-brief/README.md +++ b/src/modules/bmb/workflows/module-brief/README.md @@ -2,7 +2,7 @@ ## Overview -The Module Brief workflow creates comprehensive blueprints for building new BMAD modules using strategic analysis and creative vision. It serves as the essential planning phase that transforms initial ideas into detailed, actionable specifications ready for implementation with the build-module workflow. +The Module Brief workflow creates comprehensive blueprints for building new BMAD modules using strategic analysis and creative vision. It serves as the essential planning phase that transforms initial ideas into detailed, actionable specifications ready for implementation with the create-module workflow. ## Key Features @@ -61,9 +61,9 @@ module-brief/ ## Workflow Process -### Phase 1: Foundation & Context (Steps 1-3) +### Phase 1: Foundation and Context (Steps 1-3) -**Mode Selection & Input Gathering** +**Mode Selection and Input Gathering** - Choose operational mode (Interactive, Express, YOLO) - Check for and optionally load existing brainstorming results @@ -101,7 +101,7 @@ module-brief/ - Define input-process-output flows for each workflow - Assess complexity levels and implementation priorities -### Phase 3: Validation & User Experience (Steps 6-7) +### Phase 3: Validation and User Experience (Steps 6-7) **User Journey Mapping** @@ -110,7 +110,7 @@ module-brief/ - Validate end-to-end functionality and value delivery - Identify potential friction points and optimization opportunities -**Technical Planning & Requirements** +**Technical Planning and Requirements** - Assess data requirements and storage needs - Map integration points with other modules and external systems @@ -133,27 +133,27 @@ module-brief/ - Prioritize features and capabilities by value and complexity - Create clear milestones and success checkpoints -### Phase 5: Enhancement & Risk Management (Steps 10-12) +### Phase 5: Enhancement and Risk Management (Steps 10-12) -**Creative Features & Special Touches** (Optional) +**Creative Features and Special Touches** (Optional) - Design easter eggs and delightful user interactions - Plan module lore and thematic consistency - Add personality quirks and creative responses - Develop backstories and universe building -**Risk Assessment & Mitigation** +**Risk Assessment and Mitigation** - Identify technical, usability, and scope risks - Develop mitigation strategies for each risk category - Plan contingency approaches for potential challenges - Document decision points and alternative paths -**Final Review & Export Preparation** +**Final Review and Export Preparation** - Comprehensive review of all brief sections - Validation against quality and completeness criteria -- Preparation for seamless handoff to build-module workflow +- Preparation for seamless handoff to create-module workflow - Export readiness confirmation with actionable specifications ## Output @@ -161,7 +161,7 @@ module-brief/ ### Generated Files - **Module Brief Document**: Comprehensive planning document at `{output_folder}/module-brief-{module_code}-{date}.md` -- **Strategic Specifications**: Ready-to-implement blueprint for build-module workflow +- **Strategic Specifications**: Ready-to-implement blueprint for create-module workflow ### Output Structure @@ -178,7 +178,7 @@ The module brief contains detailed specifications across multiple sections: 9. **Creative Features** - Special touches, easter eggs, module lore 10. **Risk Assessment** - Technical, usability, scope risks with mitigation 11. **Implementation Notes** - Priority order, design decisions, open questions -12. **Resources & References** - Inspiration sources, similar modules, technical references +12. **Resources and References** - Inspiration sources, similar modules, technical references ## Requirements @@ -203,7 +203,7 @@ The module brief contains detailed specifications across multiple sections: ### After Completion -1. **Use as Blueprint** - Feed the brief directly into build-module workflow for implementation +1. **Use as Blueprint** - Feed the brief directly into create-module workflow for implementation 2. **Review with Stakeholders** - Validate assumptions and gather feedback before building 3. **Update as Needed** - Treat as living document that evolves with implementation learnings 4. **Reference During Development** - Use as north star for design decisions and scope management @@ -254,10 +254,10 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Study existing module examples in `/bmad/` for patterns and inspiration - Validate output using `checklist.md` -- Consult module structure guide at `build-module/module-structure.md` +- Consult module structure guide at `create-module/module-structure.md` --- diff --git a/src/modules/bmb/workflows/module-brief/checklist.md b/src/modules/bmb/workflows/module-brief/checklist.md index 62558ada..36fdb1f5 100644 --- a/src/modules/bmb/workflows/module-brief/checklist.md +++ b/src/modules/bmb/workflows/module-brief/checklist.md @@ -8,7 +8,7 @@ - [ ] Target users are clearly defined - [ ] Unique value proposition is articulated -## Vision & Concept +## Vision and Concept - [ ] Problem being solved is clearly stated - [ ] Solution approach is explained @@ -80,9 +80,9 @@ ## Implementation Readiness -- [ ] Brief provides enough detail for build-module workflow -- [ ] Agent specifications sufficient for build-agent workflow -- [ ] Workflow descriptions ready for build-workflow +- [ ] Brief provides enough detail for create-module workflow +- [ ] Agent specifications sufficient for create-agent workflow +- [ ] Workflow descriptions ready for create-workflow - [ ] Resource requirements are clear - [ ] Success metrics are measurable diff --git a/src/modules/bmb/workflows/module-brief/instructions.md b/src/modules/bmb/workflows/module-brief/instructions.md index 81db3544..2f96fcde 100644 --- a/src/modules/bmb/workflows/module-brief/instructions.md +++ b/src/modules/bmb/workflows/module-brief/instructions.md @@ -249,15 +249,15 @@ For each risk, note mitigation strategy. Review all sections with user -Ensure module brief is ready for build-module workflow +Ensure module brief is ready for create-module workflow Ask if they want to: -1. Proceed directly to build-module workflow +1. Proceed directly to create-module workflow 2. Save and refine later 3. Generate additional planning documents -Highlight that this brief can be fed directly into build-module workflow! +Highlight that this brief can be fed directly into create-module workflow! final_brief diff --git a/src/modules/bmb/workflows/module-brief/template.md b/src/modules/bmb/workflows/module-brief/template.md index 83c9fc3d..0738fe02 100644 --- a/src/modules/bmb/workflows/module-brief/template.md +++ b/src/modules/bmb/workflows/module-brief/template.md @@ -144,7 +144,7 @@ How we'll know the module is successful: **Deliverables:** {{phase2_deliverables}} -### Phase 3: Polish & Optimization +### Phase 3: Polish and Optimization **Timeline:** {{phase3_timeline}} @@ -161,11 +161,11 @@ How we'll know the module is successful: {{creative_features}} -### Easter Eggs & Delighters +### Easter Eggs and Delighters {{easter_eggs}} -### Module Lore & Theming +### Module Lore and Theming {{module_lore}} @@ -209,7 +209,7 @@ How we'll know the module is successful: --- -## Resources & References +## Resources and References ### Inspiration Sources @@ -235,7 +235,7 @@ How we'll know the module is successful: {{detailed_workflow_specs}} -### C. Data Structures & Schemas +### C. Data Structures and Schemas {{data_schemas}} @@ -248,14 +248,14 @@ How we'll know the module is successful: ## Next Steps 1. **Review this brief** with stakeholders -2. **Run build-module workflow** using this brief as input -3. **Create first agent** using build-agent workflow -4. **Develop initial workflows** using build-workflow +2. **Run create-module workflow** using this brief as input +3. **Create first agent** using create-agent workflow +4. **Develop initial workflows** using create-workflow 5. **Test MVP** with target users --- -_This Module Brief is ready to be fed directly into the build-module workflow for scaffolding and implementation._ +_This Module Brief is ready to be fed directly into the create-module workflow for scaffolding and implementation._ **Module Viability Score:** {{viability_score}}/10 **Estimated Development Effort:** {{effort_estimate}} diff --git a/src/modules/bmb/workflows/module-brief/workflow.yaml b/src/modules/bmb/workflows/module-brief/workflow.yaml index ecf2f07a..0dba7fd5 100644 --- a/src/modules/bmb/workflows/module-brief/workflow.yaml +++ b/src/modules/bmb/workflows/module-brief/workflow.yaml @@ -15,7 +15,7 @@ date: system-generated recommended_inputs: - brainstorming_results: "{output_folder}/brainstorming-*.md" - existing_modules: "{project-root}/bmad/" - - module_examples: "{project-root}/bmad/bmb/workflows/build-module/module-structure.md" + - module_examples: "{project-root}/bmad/bmb/workflows/create-module/module-structure.md" # Module path and component files installed_path: "{project-root}/bmad/bmb/workflows/module-brief" @@ -26,5 +26,11 @@ validation: "{installed_path}/checklist.md" # Output configuration default_output_file: "{output_folder}/module-brief-{{module_code}}-{{date}}.md" -# No special tools required -required_tools: [] +web_bundle: + name: "module-brief" + description: "Create a comprehensive Module Brief that serves as the blueprint for building new BMAD modules using strategic analysis and creative vision" + author: "BMad Builder" + web_bundle_files: + - "bmad/bmb/workflows/module-brief/instructions.md" + - "bmad/bmb/workflows/module-brief/template.md" + - "bmad/bmb/workflows/module-brief/checklist.md" diff --git a/src/modules/bmb/workflows/redoc/checklist.md b/src/modules/bmb/workflows/redoc/checklist.md index 0540155c..dd016fec 100644 --- a/src/modules/bmb/workflows/redoc/checklist.md +++ b/src/modules/bmb/workflows/redoc/checklist.md @@ -1,6 +1,6 @@ # ReDoc Workflow Validation Checklist -## Initialization & Setup +## Initialization and Setup - [ ] All BMAD convention documents loaded and understood - [ ] Target path validated and exists @@ -66,7 +66,7 @@ - [ ] Frontmatter syntax is correct and dates are current - [ ] No redundant explanation of standard BMAD patterns -## Validation & Reporting +## Validation and Reporting - [ ] All planned documentation items created/updated - [ ] Frontmatter dates verified as current across all files diff --git a/src/modules/bmb/workflows/redoc/workflow.yaml b/src/modules/bmb/workflows/redoc/workflow.yaml index 069925ea..cc951077 100644 --- a/src/modules/bmb/workflows/redoc/workflow.yaml +++ b/src/modules/bmb/workflows/redoc/workflow.yaml @@ -29,5 +29,10 @@ validation: "{installed_path}/checklist.md" # Configuration autonomous: true # Runs without user checkpoints unless clarification needed -# Tool Requirements - Using built-in file system tools -required_tools: [] +web_bundle: + name: "redoc" + description: "Autonomous documentation system that maintains module, workflow, and agent documentation using a reverse-tree approach (leaf folders first, then parents). Understands BMAD conventions and produces technical writer quality output." + author: "BMad" + web_bundle_files: + - "bmad/bmb/workflows/redoc/instructions.md" + - "bmad/bmb/workflows/redoc/checklist.md" diff --git a/src/modules/bmm/sub-modules/claude-code/readme.md b/src/modules/bmm/sub-modules/claude-code/readme.md index b852779a..385c0811 100644 --- a/src/modules/bmm/sub-modules/claude-code/readme.md +++ b/src/modules/bmm/sub-modules/claude-code/readme.md @@ -30,7 +30,7 @@ When Claude Code is selected during BMAD installation: | **epic-optimizer** | Story breakdown and sizing | PM Agent | Epic details, story sequencing | | **document-reviewer** | Quality checks and validation | PM/Analyst | Final document review before delivery | -### Architecture & Documentation Subagents +### Architecture and Documentation Subagents | Subagent | Purpose | Used By | Recommended For | | -------------------------- | ----------------------------------------- | --------- | ---------------------------------------------- | diff --git a/src/modules/bmm/sub-modules/claude-code/sub-agents/codebase-analyzer.md b/src/modules/bmm/sub-modules/claude-code/sub-agents/codebase-analyzer.md index 7df1145a..439cbd57 100644 --- a/src/modules/bmm/sub-modules/claude-code/sub-agents/codebase-analyzer.md +++ b/src/modules/bmm/sub-modules/claude-code/sub-agents/codebase-analyzer.md @@ -48,7 +48,7 @@ Provide structured analysis with: - **Key Components**: Entry points, core modules, critical services - **Dependencies**: External libraries, internal module relationships - **Configuration**: Environment setup, deployment configurations -- **Build & Deploy**: Build process, test execution, deployment pipeline +- **Build and Deploy**: Build process, test execution, deployment pipeline ## Critical Behaviors diff --git a/src/modules/bmm/sub-modules/claude-code/sub-agents/technical-decisions-curator.md b/src/modules/bmm/sub-modules/claude-code/sub-agents/technical-decisions-curator.md index fe0cca0f..a519314d 100644 --- a/src/modules/bmm/sub-modules/claude-code/sub-agents/technical-decisions-curator.md +++ b/src/modules/bmm/sub-modules/claude-code/sub-agents/technical-decisions-curator.md @@ -8,8 +8,8 @@ Specialized sub-agent for maintaining and organizing the technical-decisions.md ### Primary Functions -1. **Capture & Append**: Add new technical decisions with proper context -2. **Organize & Categorize**: Structure decisions into logical sections +1. **Capture and Append**: Add new technical decisions with proper context +2. **Organize and Categorize**: Structure decisions into logical sections 3. **Deduplicate**: Identify and merge duplicate or conflicting entries 4. **Validate**: Ensure decisions align and don't contradict 5. **Prioritize**: Mark decisions as confirmed vs. preferences vs. constraints diff --git a/src/modules/bmm/tasks/daily-standup.md b/src/modules/bmm/tasks/daily-standup.md index eaea7357..0b3102c9 100644 --- a/src/modules/bmm/tasks/daily-standup.md +++ b/src/modules/bmm/tasks/daily-standup.md @@ -8,7 +8,7 @@ MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met - Each <action> within <step> is a REQUIRED action to complete that step + Each andlt;actionandgt; within andlt;stepandgt; is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution diff --git a/src/modules/bmm/tasks/retrospective.md b/src/modules/bmm/tasks/retrospective.md index 15e53f42..6288f000 100644 --- a/src/modules/bmm/tasks/retrospective.md +++ b/src/modules/bmm/tasks/retrospective.md @@ -8,7 +8,7 @@ MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence HALT immediately when halt-conditions are met - Each <action> within <step> is a REQUIRED action to complete that step + Each andlt;actionandgt; within andlt;stepandgt; is a REQUIRED action to complete that step Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution diff --git a/src/modules/bmm/testarch/README.md b/src/modules/bmm/testarch/README.md index ffa6ec0d..ab0bf433 100644 --- a/src/modules/bmm/testarch/README.md +++ b/src/modules/bmm/testarch/README.md @@ -6,11 +6,11 @@ last-redoc-date: 2025-09-30 ## Overview -- **Persona:** Murat, Master Test Architect & Quality Advisor focused on risk-based testing, fixture architecture, ATDD, and CI/CD governance. +- **Persona:** Murat, Master Test Architect and Quality Advisor focused on risk-based testing, fixture architecture, ATDD, and CI/CD governance. - **Mission:** Deliver actionable quality strategies, automation coverage, and gate decisions that scale with project level and compliance demands. - **Use When:** Project level ≥2, integration risk is non-trivial, brownfield regression risk exists, or compliance/NFR evidence is required. -## Prerequisites & Setup +## Prerequisites and Setup 1. Run the core planning workflows first: - Analyst `*product-brief` @@ -30,7 +30,7 @@ last-redoc-date: 2025-09-30 | Phase | Test Architect | Dev / Team | Outputs | | ------------------ | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | Setup | - | Analyst `*product-brief`, PM `*plan-project`, Architect `*solution-architecture` | `{output_folder}/product-brief*.md`, `PRD.md`, `epics.md`, `solution-architecture.md` | -| Pre-Implementation | Run `*framework` (if harness missing), `*ci`, and `*test-design` | Review risk/design/CI guidance, align backlog | Test scaffold, CI pipeline, risk & coverage strategy | +| Pre-Implementation | Run `*framework` (if harness missing), `*ci`, and `*test-design` | Review risk/design/CI guidance, align backlog | Test scaffold, CI pipeline, risk and coverage strategy | | Story Prep | - | Scrum Master `*create-story`, `*story-context` | Story markdown + context XML | | Implementation | (Optional) Trigger `*atdd` before dev to supply failing tests + checklist | Implement story guided by ATDD checklist | Failing acceptance tests + implementation checklist | | Post-Dev | Execute `*automate`, re-run `*trace` | Address recommendations, update code/tests | Regression specs, refreshed coverage matrix | @@ -53,7 +53,7 @@ last-redoc-date: 2025-09-30 2. **Setup:** TEA checks harness via `*framework`, configures `*ci`, and runs `*test-design` to capture risk/coverage plans. 3. **Story Prep:** Scrum Master generates the story via `*create-story`; PO validates using `*assess-project-ready`. 4. **Implementation:** TEA optionally runs `*atdd`; Dev implements with guidance from failing tests and the plan. -5. **Post-Dev & Release:** TEA runs `*automate`, re-runs `*trace`, and finishes with `*gate` to document the decision. +5. **Post-Dev and Release:** TEA runs `*automate`, re-runs `*trace`, and finishes with `*gate` to document the decision. @@ -85,7 +85,7 @@ last-redoc-date: 2025-09-30 1. **Context Refresh:** Analyst reruns `*product-brief`; PM executes `*plan-project` to update PRD, analysis, and `epics.md`; Architect triggers `*solution-architecture` capturing legacy payment flows. 2. **Baseline Coverage:** TEA executes `*trace` to record current coverage in `docs/qa/assessments/atlas-payment-trace.md`. -3. **Risk & Design:** `*test-design` flags settlement edge cases, plans mitigations, and allocates new API/E2E scenarios with P0 priorities. +3. **Risk and Design:** `*test-design` flags settlement edge cases, plans mitigations, and allocates new API/E2E scenarios with P0 priorities. 4. **Story Prep:** Scrum Master generates `stories/story-1.1.md` via `*create-story`, automatically pulling updated context. 5. **ATDD First:** TEA runs `*atdd`, producing failing Playwright specs under `tests/e2e/payments/` plus an implementation checklist. 6. **Implementation:** Dev pairs with the checklist/tests to deliver the story. @@ -137,7 +137,7 @@ last-redoc-date: 2025-09-30 | `*gate` | `testarch/gate.md` | Gate YAML + summary (PASS/CONCERNS/FAIL/WAIVED) | Deterministic decision rules + rationale |
-Command Guidance & Context Loading +Command Guidance and Context Loading - Each task reads one row from `tea-commands.csv` via `command_key`, expanding pipe-delimited (`|`) values into checklists. - Keep CSV rows lightweight; place in-depth heuristics in `tea-knowledge.md` and reference via `knowledge_tags`. diff --git a/src/modules/bmm/testarch/tea-knowledge.md b/src/modules/bmm/testarch/tea-knowledge.md index bed04407..aeb6c900 100644 --- a/src/modules/bmm/testarch/tea-knowledge.md +++ b/src/modules/bmm/testarch/tea-knowledge.md @@ -15,7 +15,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect - Setup via API, assert via UI. Keep tests user-centric while priming state through fast interfaces. - One test = one concern. Explicit assertions live in the test body, not buried in helpers. -## Patterns & Heuristics +## Patterns and Heuristics - Selector order: `data-cy` / `data-testid` -> ARIA -> text. Avoid brittle CSS, IDs, or index based locators. - Network boundary is the mock boundary. Stub at the edge, never mid-service unless risk demands. @@ -46,7 +46,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect ``` - Visual debugging: keep component/test runner UIs available (Playwright trace viewer, Cypress runner) to accelerate feedback. -## Risk & Coverage +## Risk and Coverage - Risk score = probability (1-3) × impact (1-3). Score 9 => gate FAIL, ≥6 => CONCERNS. Most stories have 0-1 high risks. - Test level ratio: heavy unit/component coverage, but always include E2E for critical journeys and integration seams. @@ -60,7 +60,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect - **Media**: screenshot only-on-failure, video retain-on-failure - **Language Matching**: Tests should match source code language (JS/TS frontend -> JS/TS tests) -## Automation & CI +## Automation and CI - Prefer Playwright for multi-language teams, worker parallelism, rich debugging; Cypress suits smaller DX-first repos or component-heavy spikes. - **Framework Selection**: Large repo + performance = Playwright, Small repo + DX = Cypress @@ -71,7 +71,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect - Burn-in testing: run new or changed specs multiple times (e.g., 3-10x) to flush flakes before they land in main. - Keep helper scripts handy (`scripts/test-changed.sh`, `scripts/burn-in-changed.sh`) so CI and local workflows stay in sync. -## Project Structure & Config +## Project Structure and Config - **Directory structure**: ``` @@ -93,7 +93,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect export default configs[process.env.TEST_ENV || 'local']; ``` -## Test Hygiene & Independence +## Test Hygiene and Independence - Tests must be independent and stateless; never rely on execution order. - Cleanup all data created during tests (afterEach or API cleanup). @@ -127,7 +127,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect "test:component": "cypress run --component", "test:contract": "jest --testMatch='**/pact/*.spec.ts'", "test:debug": "playwright test --headed", - "test:ci": "npm run test:unit && npm run test:e2e", + "test:ci": "npm run test:unit andand npm run test:e2e", "contract:publish": "pact-broker publish" ``` @@ -138,7 +138,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect - Structure: `pact/` directory at root, `pact/config.ts` for broker settings. - Reference repos: pact-js-example-consumer, pact-js-example-provider, pact-js-example-react-consumer. -## Online Resources & Examples +## Online Resources and Examples - Fixture architecture: https://github.com/muratkeremozcan/cy-vs-pw-murats-version - Playwright patterns: https://github.com/muratkeremozcan/pw-book @@ -156,7 +156,7 @@ This brief distills Murat Ozcan's testing philosophy used by the Test Architect - BUS: Business or user harm, revenue-impacting failures, compliance gaps. - OPS: Deployment, infrastructure, or observability gaps that block releases. -## Probability & Impact Scale +## Probability and Impact Scale - Probability 1 = Unlikely (standard implementation, low risk). - Probability 2 = Possible (edge cases, needs attention). diff --git a/src/modules/bmm/testarch/test-design.md b/src/modules/bmm/testarch/test-design.md index 5106763a..d86f9ab8 100644 --- a/src/modules/bmm/testarch/test-design.md +++ b/src/modules/bmm/testarch/test-design.md @@ -1,9 +1,9 @@ -# Risk & Test Design v3.0 (Slim) +# Risk and Test Design v3.0 (Slim) ```xml - + Set command_key="*test-design" Load {project-root}/bmad/bmm/testarch/tea-commands.csv and parse the matching row diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-game/game-context.md b/src/modules/bmm/workflows/1-analysis/brainstorm-game/game-context.md index 0f126a1a..c96f2c72 100644 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-game/game-context.md +++ b/src/modules/bmm/workflows/1-analysis/brainstorm-game/game-context.md @@ -12,10 +12,10 @@ When brainstorming for games, consider exploring: - **Game Dynamics** - Emergent behaviors from mechanic interactions - **Aesthetic Experience** - Emotional responses and feelings evoked - **Progression Systems** - How players grow and unlock content -- **Challenge & Difficulty** - How to create engaging difficulty curves +- **Challenge and Difficulty** - How to create engaging difficulty curves - **Social/Multiplayer Features** - How players interact with each other -- **Narrative & World** - Story, setting, and environmental storytelling -- **Art Direction & Feel** - Visual style and game feel +- **Narrative and World** - Story, setting, and environmental storytelling +- **Art Direction and Feel** - Visual style and game feel - **Monetization** - Business model and revenue approach (if applicable) ## Game Design Frameworks diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-game/workflow.yaml b/src/modules/bmm/workflows/1-analysis/brainstorm-game/workflow.yaml index d8a3a6c3..64e20a73 100644 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-game/workflow.yaml +++ b/src/modules/bmm/workflows/1-analysis/brainstorm-game/workflow.yaml @@ -20,3 +20,14 @@ game_brain_methods: "{installed_path}/game-brain-methods.csv" # CIS brainstorming workflow to invoke cis_brainstorming: "{project-root}/bmad/cis/workflows/brainstorming/workflow.yaml" + +web_bundle: + name: "brainstorm-game" + description: "Facilitate game brainstorming sessions by orchestrating the CIS brainstorming workflow with game-specific context, guidance, and additional game design techniques." + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/1-analysis/brainstorm-game/instructions.md" + - "bmad/bmm/workflows/1-analysis/brainstorm-game/game-context.md" + - "bmad/bmm/workflows/1-analysis/brainstorm-game/game-brain-methods.csv" + existing_workflows: + - cis_brainstorming: "bmad/cis/workflows/brainstorming/workflow.yaml" diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-project/project-context.md b/src/modules/bmm/workflows/1-analysis/brainstorm-project/project-context.md index b046a8cb..3856d446 100644 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/project-context.md +++ b/src/modules/bmm/workflows/1-analysis/brainstorm-project/project-context.md @@ -6,13 +6,13 @@ This context guide provides project-specific considerations for brainstorming se When brainstorming for projects, consider exploring: -- **User Problems & Pain Points** - What challenges do users face? -- **Feature Ideas & Capabilities** - What could the product do? +- **User Problems and Pain Points** - What challenges do users face? +- **Feature Ideas and Capabilities** - What could the product do? - **Technical Approaches** - How might we build it? - **User Experience** - How will users interact with it? -- **Business Model & Value** - How does it create value? +- **Business Model and Value** - How does it create value? - **Market Differentiation** - What makes it unique? -- **Technical Risks & Challenges** - What could go wrong? +- **Technical Risks and Challenges** - What could go wrong? - **Success Metrics** - How will we measure success? ## Integration with Project Workflow diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml b/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml index bab9ba80..9e0210b5 100644 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +++ b/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml @@ -19,3 +19,13 @@ project_context: "{installed_path}/project-context.md" # CIS brainstorming workflow to invoke cis_brainstorming: "{project-root}/bmad/cis/workflows/brainstorming/workflow.yaml" + +web_bundle: + name: "brainstorm-project" + description: "Facilitate project brainstorming sessions by orchestrating the CIS brainstorming workflow with project-specific context and guidance." + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md" + - "bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md" + existing_workflows: + - cis_brainstorming: "bmad/cis/workflows/brainstorming/workflow.yaml" diff --git a/src/modules/bmm/workflows/1-analysis/game-brief/README.md b/src/modules/bmm/workflows/1-analysis/game-brief/README.md index acd92729..2a42f503 100644 --- a/src/modules/bmm/workflows/1-analysis/game-brief/README.md +++ b/src/modules/bmm/workflows/1-analysis/game-brief/README.md @@ -48,7 +48,7 @@ Work through each section collaboratively: 4. Scope and Constraints (platforms, timeline, budget, team) 5. Reference Framework (inspiration, competitors, differentiators) 6. Content Framework (world, narrative, volume) -7. Art & Audio Direction (visual and audio style) +7. Art and Audio Direction (visual and audio style) 8. Risk Assessment (risks, challenges, mitigation) 9. Success Criteria (MVP, metrics, launch goals) 10. Next Steps (immediate actions, research, questions) diff --git a/src/modules/bmm/workflows/1-analysis/game-brief/checklist.md b/src/modules/bmm/workflows/1-analysis/game-brief/checklist.md index 6dc13f0c..80fe7a63 100644 --- a/src/modules/bmm/workflows/1-analysis/game-brief/checklist.md +++ b/src/modules/bmm/workflows/1-analysis/game-brief/checklist.md @@ -45,13 +45,13 @@ Use this checklist to ensure your game brief is complete and ready for GDD creat ## Content Framework ✓ -- [ ] **World & Setting** is defined +- [ ] **World and Setting** is defined - [ ] **Narrative Approach** matches game type - [ ] **Content Volume** is estimated (rough order of magnitude) - [ ] Playtime expectations are set - [ ] Replayability approach is clear -## Art & Audio Direction ✓ +## Art and Audio Direction ✓ - [ ] **Visual Style** is described with references - [ ] 2D vs. 3D is decided diff --git a/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md b/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md index d0c80932..d5a1a72e 100644 --- a/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md +++ b/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md @@ -225,7 +225,7 @@ What makes your game unique? Let's scope your content needs. -**World & Setting:** +**World and Setting:** - Where/when does your game take place? - How much world-building is needed? @@ -459,7 +459,7 @@ What are you still uncertain about? 4. Scope and Constraints 5. Reference Framework 6. Content Framework -7. Art & Audio Direction +7. Art and Audio Direction 8. Risk Assessment 9. Success Criteria 10. Next Steps diff --git a/src/modules/bmm/workflows/1-analysis/game-brief/template.md b/src/modules/bmm/workflows/1-analysis/game-brief/template.md index a61e853e..79453077 100644 --- a/src/modules/bmm/workflows/1-analysis/game-brief/template.md +++ b/src/modules/bmm/workflows/1-analysis/game-brief/template.md @@ -102,7 +102,7 @@ ## Content Framework -### World & Setting +### World and Setting {{world_setting}} @@ -116,7 +116,7 @@ --- -## Art & Audio Direction +## Art and Audio Direction ### Visual Style diff --git a/src/modules/bmm/workflows/1-analysis/game-brief/workflow.yaml b/src/modules/bmm/workflows/1-analysis/game-brief/workflow.yaml index 5eaa474a..babee8d3 100644 --- a/src/modules/bmm/workflows/1-analysis/game-brief/workflow.yaml +++ b/src/modules/bmm/workflows/1-analysis/game-brief/workflow.yaml @@ -26,9 +26,15 @@ validation: "{installed_path}/checklist.md" # Output configuration default_output_file: "{output_folder}/game-brief-{{game_name}}-{{date}}.md" -# Required tools -required_tools: [] - # Workflow settings autonomous: false # This is an interactive workflow requiring user collaboration brief_format: "comprehensive" # Options: "comprehensive" (full detail) or "executive" (3-page limit) + +web_bundle: + name: "game-brief" + description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/1-analysis/game-brief/template.md" + - "bmad/bmm/workflows/1-analysis/game-brief/instructions.md" + - "bmad/bmm/workflows/1-analysis/game-brief/checklist.md" diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/README.md b/src/modules/bmm/workflows/1-analysis/product-brief/README.md index f7d11713..24f5de77 100644 --- a/src/modules/bmm/workflows/1-analysis/product-brief/README.md +++ b/src/modules/bmm/workflows/1-analysis/product-brief/README.md @@ -95,14 +95,14 @@ product-brief/ 2. **Problem Statement** - Detailed problem analysis with evidence 3. **Proposed Solution** - Core approach and key differentiators 4. **Target Users** - Primary and secondary user segments with personas -5. **Goals & Success Metrics** - Business objectives and measurable KPIs +5. **Goals and Success Metrics** - Business objectives and measurable KPIs 6. **MVP Scope** - Must-have features and out-of-scope items 7. **Post-MVP Vision** - Phase 2 features and long-term roadmap 8. **Financial Impact** - Investment requirements and ROI projections 9. **Strategic Alignment** - Connection to company OKRs and initiatives 10. **Technical Considerations** - Platform requirements and preferences -11. **Constraints & Assumptions** - Resource limits and key assumptions -12. **Risks & Open Questions** - Risk assessment and research needs +11. **Constraints and Assumptions** - Resource limits and key assumptions +12. **Risks and Open Questions** - Risk assessment and research needs 13. **Supporting Materials** - Research summaries and references ## Requirements @@ -170,7 +170,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Validate output using `checklist.md` - Consider running market research workflow first if lacking business context - Consult BMAD documentation for product planning methodology diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/checklist.md b/src/modules/bmm/workflows/1-analysis/product-brief/checklist.md index d4547cd7..d582d037 100644 --- a/src/modules/bmm/workflows/1-analysis/product-brief/checklist.md +++ b/src/modules/bmm/workflows/1-analysis/product-brief/checklist.md @@ -41,7 +41,7 @@ - [ ] Secondary segment (if applicable) is equally detailed - [ ] Avoids generic personas like "busy professionals" -## Goals & Metrics +## Goals and Metrics - [ ] Business objectives include measurable outcomes with targets - [ ] User success metrics focus on behaviors, not features @@ -67,7 +67,7 @@ - [ ] Technology preferences are marked as preferences, not decisions - [ ] Integration requirements with existing systems are identified -## Constraints & Assumptions +## Constraints and Assumptions - [ ] Budget constraints are documented if known - [ ] Timeline or deadline pressures are specified diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md b/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md index e35bfb6e..e861362d 100644 --- a/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +++ b/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md @@ -299,13 +299,13 @@ Being honest about unknowns helps us prepare. 1. Problem Statement 2. Proposed Solution 3. Target Users -4. Goals & Metrics +4. Goals and Metrics 5. MVP Scope 6. Post-MVP Vision -7. Financial Impact & Strategic Alignment +7. Financial Impact and Strategic Alignment 8. Technical Considerations -9. Constraints & Assumptions -10. Risks & Questions +9. Constraints and Assumptions +10. Risks and Questions 11. Save and continue Work with user to refine selected section diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/template.md b/src/modules/bmm/workflows/1-analysis/product-brief/template.md index c95ded5b..f8992424 100644 --- a/src/modules/bmm/workflows/1-analysis/product-brief/template.md +++ b/src/modules/bmm/workflows/1-analysis/product-brief/template.md @@ -36,7 +36,7 @@ --- -## Goals & Success Metrics +## Goals and Success Metrics ### Business Objectives @@ -52,7 +52,7 @@ --- -## Strategic Alignment & Financial Impact +## Strategic Alignment and Financial Impact ### Financial Impact @@ -116,7 +116,7 @@ --- -## Constraints & Assumptions +## Constraints and Assumptions ### Constraints @@ -128,7 +128,7 @@ --- -## Risks & Open Questions +## Risks and Open Questions ### Key Risks diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml b/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml index 0aa21bf2..0b6f0077 100644 --- a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +++ b/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml @@ -25,9 +25,15 @@ validation: "{installed_path}/checklist.md" # Output configuration default_output_file: "{output_folder}/product-brief-{{project_name}}-{{date}}.md" -# Required tools -required_tools: [] - # Workflow settings autonomous: false # This is an interactive workflow requiring user collaboration brief_format: "comprehensive" # Options: "comprehensive" (full detail) or "executive" (3-page limit) + +web_bundle: + name: "product-brief" + description: "Interactive product brief creation workflow that guides users through defining their product vision with multiple input sources and conversational collaboration" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/1-analysis/product-brief/template.md" + - "bmad/bmm/workflows/1-analysis/product-brief/instructions.md" + - "bmad/bmm/workflows/1-analysis/product-brief/checklist.md" diff --git a/src/modules/bmm/workflows/1-analysis/research/README.md b/src/modules/bmm/workflows/1-analysis/research/README.md index 2bc87800..c3359593 100644 --- a/src/modules/bmm/workflows/1-analysis/research/README.md +++ b/src/modules/bmm/workflows/1-analysis/research/README.md @@ -146,7 +146,7 @@ research/ ## Workflow Process -### Phase 1: Research Type Selection & Setup +### Phase 1: Research Type Selection and Setup 1. Router presents research type menu 2. User selects research type (market, deep_prompt, technical, competitive, user, domain) @@ -196,7 +196,7 @@ research/ - Adapts questions and frameworks to research type - Customizes output format for target audience -### Phase 3: Validation & Delivery +### Phase 3: Validation and Delivery 1. Review outputs against checklist 2. Validate completeness and quality @@ -428,7 +428,7 @@ Add to `workflow.yaml` `frameworks` section under appropriate research type. For issues or questions: -- Review workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Check validation against `checklist.md` - Examine router logic in `instructions-router.md` - Review research type-specific instructions diff --git a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md index 07ec6fc6..51ad8b7b 100644 --- a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md +++ b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md @@ -207,7 +207,7 @@ Competitive Threat: ### Innovation Pipeline Assessment - Patent filing analysis -- R&D investment signals +- RandD investment signals - Acquisition patterns - Partnership strategies - Beta/preview features diff --git a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md index 974f387d..a9013db8 100644 --- a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md +++ b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md @@ -77,7 +77,7 @@ You are a specialized Market Research Expert with deep expertise in gathering, a - Market share estimates - Business model analysis - Competitive dynamics -- M&A activity +- MandA activity **Customer Research** @@ -87,7 +87,7 @@ You are a specialized Market Research Expert with deep expertise in gathering, a - Decision criteria - Price sensitivity -### Phase 3: Synthesis & Insights +### Phase 3: Synthesis and Insights **Pattern Recognition** diff --git a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md index d5b5d985..14e5a2e3 100644 --- a/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md +++ b/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md @@ -58,9 +58,9 @@ When analyzing trends: For each identified trend, provide: -- **Trend Name & Description** +- **Trend Name and Description** - **Current Stage** (Emerging/Growing/Mainstream/Declining) -- **Evidence & Signals** (3-5 specific indicators) +- **Evidence and Signals** (3-5 specific indicators) - **Timeline** (When mainstream adoption expected) - **Impact Assessment** (Market size, disruption potential) - **Opportunities** (How to capitalize) diff --git a/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md b/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md index 76ecc3d1..18f97d14 100644 --- a/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md +++ b/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md @@ -62,7 +62,7 @@ --- -## Complete Research Prompt (Copy & Paste) +## Complete Research Prompt (Copy and Paste) ``` {{deep_research_prompt}} diff --git a/src/modules/bmm/workflows/1-analysis/research/template-market.md b/src/modules/bmm/workflows/1-analysis/research/template-market.md index d55bcb3a..452918b7 100644 --- a/src/modules/bmm/workflows/1-analysis/research/template-market.md +++ b/src/modules/bmm/workflows/1-analysis/research/template-market.md @@ -22,7 +22,7 @@ --- -## 1. Research Objectives & Methodology +## 1. Research Objectives and Methodology ### Research Objectives diff --git a/src/modules/bmm/workflows/1-analysis/research/workflow.yaml b/src/modules/bmm/workflows/1-analysis/research/workflow.yaml index bb8fc66f..dae2b697 100644 --- a/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +++ b/src/modules/bmm/workflows/1-analysis/research/workflow.yaml @@ -147,3 +147,17 @@ data_sources: - "Social media and communities" - "Patent databases" - "Benchmarking studies" + +web_bundle: + name: "research" + description: "Adaptive research workflow supporting multiple research types: market research, deep research prompt generation, technical/architecture evaluation, competitive intelligence, user research, and domain analysis" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/1-analysis/research/instructions-router.md" + - "bmad/bmm/workflows/1-analysis/research/instructions-market.md" + - "bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md" + - "bmad/bmm/workflows/1-analysis/research/instructions-technical.md" + - "bmad/bmm/workflows/1-analysis/research/template-market.md" + - "bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md" + - "bmad/bmm/workflows/1-analysis/research/template-technical.md" + - "bmad/bmm/workflows/1-analysis/research/checklist.md" diff --git a/src/modules/bmm/workflows/2-plan/README.md b/src/modules/bmm/workflows/2-plan/README.md index a2a8896d..b75e3556 100644 --- a/src/modules/bmm/workflows/2-plan/README.md +++ b/src/modules/bmm/workflows/2-plan/README.md @@ -193,7 +193,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Validate output using `checklist.md` - Consult project assessment in `project-workflow-analysis.md` - Check continuation status in existing output documents diff --git a/src/modules/bmm/workflows/2-plan/gdd/README.md b/src/modules/bmm/workflows/2-plan/gdd/README.md index 973b4a8f..3be0b5dc 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/README.md +++ b/src/modules/bmm/workflows/2-plan/gdd/README.md @@ -20,12 +20,12 @@ The GDD workflow creates a comprehensive Game Design Document that captures: `gdd-template.md` contains sections common to ALL game types: - Executive Summary -- Goals & Context +- Goals and Context - Core Gameplay - Win/Loss Conditions -- Progression & Balance +- Progression and Balance - Level Design Framework -- Art & Audio Direction +- Art and Audio Direction - Technical Specs - Development Epics - Success Metrics @@ -53,15 +53,15 @@ Located in `game-types/` folder, these markdown files contain sections specific - Movement System (jump mechanics, air control, special moves) - Combat System (attack types, combos, enemy AI) - Level Design Patterns (platforming challenges, combat arenas) -- Player Abilities & Unlocks +- Player Abilities and Unlocks **rpg.md**: - Character System (stats, classes, leveling) -- Inventory & Equipment +- Inventory and Equipment - Quest System -- World & Exploration -- NPC & Dialogue +- World and Exploration +- NPC and Dialogue - Combat System **puzzle.md**: @@ -76,8 +76,8 @@ Located in `game-types/` folder, these markdown files contain sections specific - Run Structure - Procedural Generation -- Permadeath & Progression -- Item & Upgrade System +- Permadeath and Progression +- Item and Upgrade System - Character Selection - Difficulty Modifiers @@ -98,15 +98,15 @@ Located in `game-types/` folder, these markdown files contain sections specific - Stores `game_type` for injection 3. **Universal GDD Sections** (Steps 2-5, 7-13): - - Platform & target audience - - Goals & context + - Platform and target audience + - Goals and context - Core gameplay (pillars, loop, win/loss) - - Mechanics & controls - - Progression & balance + - Mechanics and controls + - Progression and balance - Level design - - Art & audio + - Art and audio - Technical specs - - Epics & metrics + - Epics and metrics 4. **Game-Type Injection** (Step 6): - Loads fragment from `game-types/{game_type}.md` diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/action-platformer.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/action-platformer.md index 15b0be48..9305f8ab 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/action-platformer.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/action-platformer.md @@ -33,7 +33,7 @@ - Checkpoint placement - Difficulty spikes and pacing -### Player Abilities & Unlocks +### Player Abilities and Unlocks {{player_abilities}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/adventure.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/adventure.md index c7904b35..2de824a5 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/adventure.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/adventure.md @@ -59,7 +59,7 @@ This game type is **narrative-heavy**. Consider running the Narrative Design wor - Companion mechanics (if applicable) - Memorable character moments -### Inventory & Items +### Inventory and Items {{inventory_items}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/card-game.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/card-game.md index 57b0b916..24dacd7f 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/card-game.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/card-game.md @@ -1,6 +1,6 @@ ## Card Game Specific Elements -### Card Types & Effects +### Card Types and Effects {{card_types}} @@ -50,7 +50,7 @@ - Time limits per turn - Match length targets -### Card Collection & Progression +### Card Collection and Progression {{collection_progression}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/fighting.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/fighting.md index ab44a48e..d2158493 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/fighting.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/fighting.md @@ -12,7 +12,7 @@ - Complexity tiers (beginner vs. expert characters) - Balance philosophy (everyone viable vs. tier system) -### Move Lists & Frame Data +### Move Lists and Frame Data {{moves_frame_data}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/horror.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/horror.md index c225579a..a525cbd2 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/horror.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/horror.md @@ -9,7 +9,7 @@ This game type is **narrative-important**. Consider running the Narrative Design - Tension pacing and narrative beats -### Atmosphere & Tension Building +### Atmosphere and Tension Building {{atmosphere}} @@ -61,7 +61,7 @@ This game type is **narrative-important**. Consider running the Narrative Design - Inventory constraints - Risk vs. reward of exploration -### Safe Zones & Respite +### Safe Zones and Respite {{safe_zones}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/idle-incremental.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/idle-incremental.md index e20b992f..afade143 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/idle-incremental.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/idle-incremental.md @@ -38,7 +38,7 @@ - Automation tiers - Balance between active and idle play -### Prestige & Reset Mechanics +### Prestige and Reset Mechanics {{prestige_reset}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/moba.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/moba.md index ba0bd70e..9eb49b74 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/moba.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/moba.md @@ -13,7 +13,7 @@ - Visual and thematic diversity - Counter-pick dynamics -### Lane Structure & Map +### Lane Structure and Map {{lane_map}} @@ -25,7 +25,7 @@ - Spawn points and fountains - Vision mechanics (wards, fog of war) -### Item & Build System +### Item and Build System {{item_build}} @@ -37,7 +37,7 @@ - Situational itemization - Starting items vs. late-game items -### Team Composition & Roles +### Team Composition and Roles {{team_composition}} @@ -61,7 +61,7 @@ - Phase transition mechanics - Comeback mechanics -### Objectives & Win Conditions +### Objectives and Win Conditions {{objectives_victory}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/party-game.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/party-game.md index f83ccb5c..f1749088 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/party-game.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/party-game.md @@ -52,7 +52,7 @@ - Player join/drop mechanics - Tutorial integration for new players -### Accessibility & Skill Range +### Accessibility and Skill Range {{accessibility}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/racing.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/racing.md index 8e1cc551..667684c8 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/racing.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/racing.md @@ -1,6 +1,6 @@ ## Racing Game Specific Elements -### Vehicle Handling & Physics +### Vehicle Handling and Physics {{vehicle_physics}} @@ -50,7 +50,7 @@ - Pit stops (if applicable) - Weather and time-of-day effects -### Powerups & Boost +### Powerups and Boost {{powerups_boost}} @@ -75,7 +75,7 @@ - Career/campaign mode - Online multiplayer modes -### Progression & Unlocks +### Progression and Unlocks {{progression}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/rhythm.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/rhythm.md index eb97e89e..f173ec1e 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/rhythm.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/rhythm.md @@ -13,7 +13,7 @@ - Lane systems (4-key, 6-key, circular, etc.) - Offset calibration -### Note Charts & Patterns +### Note Charts and Patterns {{note_charts}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/roguelike.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/roguelike.md index a87644d9..b4221066 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/roguelike.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/roguelike.md @@ -23,7 +23,7 @@ - Biome/theme variation - Seed system (if deterministic) -### Permadeath & Progression +### Permadeath and Progression {{permadeath_progression}} @@ -34,7 +34,7 @@ - Meta-progression systems - Unlock conditions -### Item & Upgrade System +### Item and Upgrade System {{item_upgrade_system}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/rpg.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/rpg.md index be77f5e8..1b856205 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/rpg.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/rpg.md @@ -11,7 +11,7 @@ - Leveling system - Skill trees -### Inventory & Equipment +### Inventory and Equipment {{inventory_equipment}} @@ -34,7 +34,7 @@ - Branching questlines - Quest rewards -### World & Exploration +### World and Exploration {{world_exploration}} @@ -46,7 +46,7 @@ - Fast travel system - Points of interest -### NPC & Dialogue +### NPC and Dialogue {{npc_dialogue}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/sandbox.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/sandbox.md index e4914c9f..98c15685 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/sandbox.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/sandbox.md @@ -13,7 +13,7 @@ - Undo/redo system - Import/export functionality -### Physics & Building Systems +### Physics and Building Systems {{physics_building}} @@ -26,7 +26,7 @@ - Constraint systems (joints, hinges, motors) - Interactive simulations -### Sharing & Community +### Sharing and Community {{sharing_community}} @@ -39,7 +39,7 @@ - Modding support - User-generated content moderation -### Constraints & Rules +### Constraints and Rules {{constraints_rules}} @@ -52,7 +52,7 @@ - Rulesets and game modes - Victory conditions (if applicable) -### Tools & Editing +### Tools and Editing {{tools_editing}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/shooter.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/shooter.md index faa04956..20ca0a6e 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/shooter.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/shooter.md @@ -12,7 +12,7 @@ - Weapon feel (recoil patterns, sound design, impact feedback) - Balance considerations (risk/reward, situational use) -### Aiming & Combat Mechanics +### Aiming and Combat Mechanics {{aiming_combat}} @@ -24,7 +24,7 @@ - Critical hits / weak points - Melee integration (if applicable) -### Enemy Design & AI +### Enemy Design and AI {{enemy_ai}} @@ -36,7 +36,7 @@ - Difficulty scaling (health, damage, AI sophistication) - Enemy tells and telegraphing -### Arena & Level Design +### Arena and Level Design {{arena_level_design}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/simulation.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/simulation.md index 32164da9..efb5f78c 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/simulation.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/simulation.md @@ -24,7 +24,7 @@ - Delegation systems (if applicable) - Efficiency optimization -### Building & Construction +### Building and Construction {{building_construction}} @@ -36,7 +36,7 @@ - Upgrade/demolition mechanics - Space constraints and planning -### Economic & Resource Loops +### Economic and Resource Loops {{economic_loops}} @@ -48,7 +48,7 @@ - Market dynamics - Economic balance and pacing -### Progression & Unlocks +### Progression and Unlocks {{progression_unlocks}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/sports.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/sports.md index 42e3123b..47cc414c 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/sports.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/sports.md @@ -12,7 +12,7 @@ - Rule variations (if applicable) - Simulation vs. arcade rule adherence -### Team & Player Systems +### Team and Player Systems {{team_player}} @@ -37,7 +37,7 @@ - Overtime/extra time rules - Post-match results and stats -### Physics & Realism +### Physics and Realism {{physics_realism}} @@ -49,7 +49,7 @@ - Collision detection - Weather/field condition effects -### Career & Season Modes +### Career and Season Modes {{career_season}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/strategy.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/strategy.md index 1e49c0b4..5f7e04a3 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/strategy.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/strategy.md @@ -12,7 +12,7 @@ - Economic balance (income vs. expenses) - Scarcity and strategic choices -### Unit Types & Stats +### Unit Types and Stats {{unit_types}} @@ -24,7 +24,7 @@ - Counter systems (rock-paper-scissors dynamics) - Unit production (cost, build time, prerequisites) -### Technology & Progression +### Technology and Progression {{tech_progression}} @@ -35,7 +35,7 @@ - Upgrade paths (unit upgrades, building improvements) - Unlock conditions (progression gates, achievements) -### Map & Terrain +### Map and Terrain {{map_terrain}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/survival.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/survival.md index 0f1c37e4..b83773ce 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/survival.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/survival.md @@ -1,6 +1,6 @@ ## Survival Game Specific Elements -### Resource Gathering & Crafting +### Resource Gathering and Crafting {{resource_crafting}} @@ -52,7 +52,7 @@ - Defensive structures - Automation (if applicable) -### Progression & Technology +### Progression and Technology {{progression_tech}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/text-based.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/text-based.md index c493ca54..f2d086b9 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/text-based.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/text-based.md @@ -36,7 +36,7 @@ This game type is **narrative-critical**. You MUST run the Narrative Design work - Landmarks and navigation aids - Fast travel or mapping system -### Item & Inventory System +### Item and Inventory System {{item_inventory}} @@ -62,7 +62,7 @@ This game type is **narrative-critical**. You MUST run the Narrative Design work - Puzzle integration with story - Non-linear puzzle solving -### Narrative & Writing +### Narrative and Writing {{narrative_writing}} @@ -77,7 +77,7 @@ This game type is **narrative-critical**. You MUST run the Narrative Design work **Note:** All narrative content must be written in the Narrative Design Document. -### Game Flow & Pacing +### Game Flow and Pacing {{game_flow}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/tower-defense.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/tower-defense.md index 143c2dcf..98f85daa 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/tower-defense.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/tower-defense.md @@ -1,6 +1,6 @@ ## Tower Defense Specific Elements -### Tower Types & Upgrades +### Tower Types and Upgrades {{tower_types}} @@ -26,7 +26,7 @@ - Boss encounters - Endless mode scaling (if applicable) -### Path & Placement Strategy +### Path and Placement Strategy {{path_placement}} @@ -39,7 +39,7 @@ - Multiple paths (if applicable) - Line of sight and range visualization -### Economy & Resources +### Economy and Resources {{economy}} @@ -52,7 +52,7 @@ - Special currencies (if applicable) - Economic optimization strategies -### Abilities & Powers +### Abilities and Powers {{abilities_powers}} @@ -65,7 +65,7 @@ - Strategic timing - Resource cost vs. cooldown -### Difficulty & Replayability +### Difficulty and Replayability {{difficulty_replay}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/turn-based-tactics.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/turn-based-tactics.md index 5fa3116c..52d2effb 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/turn-based-tactics.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/turn-based-tactics.md @@ -8,7 +8,7 @@ This game type is **narrative-moderate to heavy**. Consider running the Narrativ - Mission narratives -### Grid System & Movement +### Grid System and Movement {{grid_movement}} @@ -21,7 +21,7 @@ This game type is **narrative-moderate to heavy**. Consider running the Narrativ - Zone of control - Pathfinding visualization -### Unit Types & Classes +### Unit Types and Classes {{unit_classes}} @@ -47,7 +47,7 @@ This game type is **narrative-moderate to heavy**. Consider running the Narrativ - Turn order (initiative, simultaneous, alternating) - Time limits per turn (if applicable) -### Positioning & Tactics +### Positioning and Tactics {{positioning_tactics}} @@ -61,7 +61,7 @@ This game type is **narrative-moderate to heavy**. Consider running the Narrativ - Chokepoint tactics - Line of sight and vision -### Terrain & Environmental Effects +### Terrain and Environmental Effects {{terrain_effects}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/game-types/visual-novel.md b/src/modules/bmm/workflows/2-plan/gdd/game-types/visual-novel.md index eb1cbc89..9221e1bf 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/game-types/visual-novel.md +++ b/src/modules/bmm/workflows/2-plan/gdd/game-types/visual-novel.md @@ -62,7 +62,7 @@ This game type is **narrative-critical**. You MUST run the Narrative Design work - Multiple romance options (if applicable) - Platonic vs. romantic paths -### Save/Load & Flowchart +### Save/Load and Flowchart {{save_flowchart}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/gdd-template.md b/src/modules/bmm/workflows/2-plan/gdd/gdd-template.md index 4c3af3fc..1f8404bd 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/gdd-template.md +++ b/src/modules/bmm/workflows/2-plan/gdd/gdd-template.md @@ -28,7 +28,7 @@ {{goals}} -### Background & Rationale +### Background and Rationale {{context}} @@ -56,7 +56,7 @@ {{primary_mechanics}} -### Controls & Input +### Controls and Input {{controls}} @@ -66,7 +66,7 @@ --- -## Progression & Balance +## Progression and Balance ### Player Progression @@ -76,7 +76,7 @@ {{difficulty_curve}} -### Economy & Resources +### Economy and Resources {{economy_resources}} @@ -94,13 +94,13 @@ --- -## Art & Audio Direction +## Art and Audio Direction ### Art Style {{art_style}} -### Audio & Music +### Audio and Music {{audio_music}} diff --git a/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md b/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md index 2535a089..67a40cbf 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md +++ b/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md @@ -407,7 +407,7 @@ Since this is a Level {{project_level}} game project, you need solutioning for p Generate comprehensive checklist based on project analysis -### Phase 1: Solution Architecture & Engine Selection +### Phase 1: Solution Architecture and Engine Selection - [ ] **Run solutioning workflow** (REQUIRED) - Command: `workflow solution-architecture` @@ -415,7 +415,7 @@ Since this is a Level {{project_level}} game project, you need solutioning for p - Output: solution-architecture.md with engine/platform specifics - Note: Registry.csv will provide engine-specific guidance -### Phase 2: Prototype & Playtesting +### Phase 2: Prototype and Playtesting - [ ] **Create core mechanic prototype** - Validate game feel diff --git a/src/modules/bmm/workflows/2-plan/narrative/narrative-template.md b/src/modules/bmm/workflows/2-plan/narrative/narrative-template.md index d18796b5..4a703ff9 100644 --- a/src/modules/bmm/workflows/2-plan/narrative/narrative-template.md +++ b/src/modules/bmm/workflows/2-plan/narrative/narrative-template.md @@ -16,7 +16,7 @@ {{core_themes}} -### Tone & Atmosphere +### Tone and Atmosphere {{tone_atmosphere}} @@ -38,7 +38,7 @@ {{story_beats}} -### Pacing & Flow +### Pacing and Flow {{pacing_flow}} @@ -64,17 +64,17 @@ --- -## World & Lore +## World and Lore ### World Overview {{world_overview}} -### History & Backstory +### History and Backstory {{history_backstory}} -### Factions & Organizations +### Factions and Organizations {{factions_organizations}} @@ -102,7 +102,7 @@ {{branching_dialogue}} -### Voice & Characterization +### Voice and Characterization {{voice_characterization}} @@ -130,7 +130,7 @@ ## Narrative Delivery -### Cutscenes & Cinematics +### Cutscenes and Cinematics {{cutscenes}} @@ -190,6 +190,6 @@ {{timeline}} -### References & Inspirations +### References and Inspirations {{references}} diff --git a/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md b/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md index f0651396..e32fb89c 100644 --- a/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md +++ b/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md @@ -193,7 +193,7 @@ Since this is a Level {{project_level}} project, you need architecture before st Generate comprehensive checklist based on project analysis -### Phase 1: Architecture & Design +### Phase 1: Architecture and Design - [ ] **Run architecture workflow** (REQUIRED) - Command: `workflow architecture` @@ -239,7 +239,7 @@ Since this is a Level {{project_level}} project, you need architecture before st - Sprint boundaries - Resource allocation -- [ ] **Establish monitoring & metrics** +- [ ] **Establish monitoring and metrics** - Success metrics from PRD - Technical monitoring - User analytics diff --git a/src/modules/bmm/workflows/2-plan/prd/instructions-med.md b/src/modules/bmm/workflows/2-plan/prd/instructions-med.md index 73893e3e..2cb33dc3 100644 --- a/src/modules/bmm/workflows/2-plan/prd/instructions-med.md +++ b/src/modules/bmm/workflows/2-plan/prd/instructions-med.md @@ -187,7 +187,7 @@ Since this is a Level {{project_level}} project, you need solutioning before imp Generate comprehensive checklist based on project analysis -### Phase 1: Solution Architecture & Design +### Phase 1: Solution Architecture and Design - [ ] **Run solutioning workflow** (REQUIRED) - Command: `workflow solution-architecture` diff --git a/src/modules/bmm/workflows/2-plan/ux/ux-spec-template.md b/src/modules/bmm/workflows/2-plan/ux/ux-spec-template.md index 62d9794c..40ba161d 100644 --- a/src/modules/bmm/workflows/2-plan/ux/ux-spec-template.md +++ b/src/modules/bmm/workflows/2-plan/ux/ux-spec-template.md @@ -8,7 +8,7 @@ _Generated on {{date}} by {{user_name}}_ --- -## 1. UX Goals & Principles +## 1. UX Goals and Principles ### 1.1 Target User Personas @@ -50,7 +50,7 @@ _Generated on {{date}} by {{user_name}}_ --- -## 4. Component Library & Design System +## 4. Component Library and Design System ### 4.1 Design System Approach @@ -76,7 +76,7 @@ _Generated on {{date}} by {{user_name}}_ **Type Scale:** {{type_scale}} -### 5.3 Spacing & Layout +### 5.3 Spacing and Layout {{spacing_layout}} @@ -106,7 +106,7 @@ _Generated on {{date}} by {{user_name}}_ --- -## 8. Interaction & Motion +## 8. Interaction and Motion ### 8.1 Motion Principles @@ -118,7 +118,7 @@ _Generated on {{date}} by {{user_name}}_ --- -## 9. Design Files & Wireframes +## 9. Design Files and Wireframes ### 9.1 Design Files diff --git a/src/modules/bmm/workflows/2-plan/workflow.yaml b/src/modules/bmm/workflows/2-plan/workflow.yaml index d4f7e07b..a0adf91f 100644 --- a/src/modules/bmm/workflows/2-plan/workflow.yaml +++ b/src/modules/bmm/workflows/2-plan/workflow.yaml @@ -58,3 +58,50 @@ instructions_ux: "{installed_path}/ux/instructions-ux.md" instructions_gdd: "{installed_path}/gdd/instructions-gdd.md" instructions_narrative: "{installed_path}/narrative/instructions-narrative.md" validation: "{installed_path}/checklist.md" + +web_bundle: + name: "plan-project" + description: "Scale-adaptive project planning workflow for all project levels (0-4). Automatically adjusts outputs based on project scope - from single atomic changes (Level 0: tech-spec only) to enterprise platforms (Level 4: full PRD + epics). Level 2-4 route to 3-solutioning workflow for architecture and tech specs. Generates appropriate planning artifacts for each level." + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/2-plan/instructions-router.md" + - "bmad/bmm/workflows/2-plan/tech-spec/instructions-sm.md" + - "bmad/bmm/workflows/2-plan/prd/instructions-med.md" + - "bmad/bmm/workflows/2-plan/prd/instructions-lg.md" + - "bmad/bmm/workflows/2-plan/prd/prd-template.md" + - "bmad/bmm/workflows/2-plan/prd/analysis-template.md" + - "bmad/bmm/workflows/2-plan/prd/epics-template.md" + - "bmad/bmm/workflows/2-plan/tech-spec/tech-spec-template.md" + - "bmad/bmm/workflows/2-plan/ux/ux-spec-template.md" + - "bmad/bmm/workflows/2-plan/ux/instructions-ux.md" + - "bmad/bmm/workflows/2-plan/gdd/gdd-template.md" + - "bmad/bmm/workflows/2-plan/gdd/instructions-gdd.md" + - "bmad/bmm/workflows/2-plan/gdd/instructions-narrative.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types.csv" + - "bmad/bmm/workflows/2-plan/gdd/game-types/action-platformer.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/adventure.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/card-game.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/fighting.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/horror.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/idle-incremental.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/metroidvania.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/moba.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/party-game.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/puzzle.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/racing.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/rhythm.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/roguelike.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/rpg.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/sandbox.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/shooter.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/simulation.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/sports.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/strategy.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/survival.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/text-based.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/tower-defense.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/turn-based-tactics.md" + - "bmad/bmm/workflows/2-plan/gdd/game-types/visual-novel.md" + - "bmad/bmm/workflows/2-plan/narrative/narrative-template.md" + - "bmad/bmm/workflows/2-plan/narrative/instructions-narrative.md" + - "bmad/bmm/workflows/2-plan/checklist.md" diff --git a/src/modules/bmm/workflows/3-solutioning/README.md b/src/modules/bmm/workflows/3-solutioning/README.md index a7c0f0b8..9f47f2f0 100644 --- a/src/modules/bmm/workflows/3-solutioning/README.md +++ b/src/modules/bmm/workflows/3-solutioning/README.md @@ -69,7 +69,7 @@ workflow solution-architecture --- -## Project Types & Templates +## Project Types and Templates ### 12 Project Types Supported @@ -108,7 +108,7 @@ Each row maps to: ## Architecture Flow -### Step 0: Prerequisites & Scale Check +### Step 0: Prerequisites and Scale Check Load `project-workflow-analysis.md`: @@ -234,7 +234,7 @@ Validate architecture quality: ├── instructions.md # Main workflow logic ├── checklist.md # Validation checklist ├── ADR-template.md # ADR document template -├── templates/ # Architecture templates & guides +├── templates/ # Architecture templates and guides │ ├── registry.csv # 171 tech combinations → templates │ ├── game-engine-architecture.md # Complete game architecture doc │ ├── game-engine-unity-guide.md # Unity-specific guidance @@ -250,7 +250,7 @@ Validate architecture quality: │ ├── desktop-app-architecture.md │ ├── library-package-architecture.md │ └── infrastructure-architecture.md -└── project-types/ # Project type detection & questions +└── project-types/ # Project type detection and questions ├── project-types.csv # 12 project types + detection keywords ├── game-questions.md ├── web-questions.md @@ -269,17 +269,17 @@ Each template in `templates/` is a **complete** architecture document structure: **Standard Sections (all templates):** 1. Executive Summary -2. Technology Stack & Decisions (required table) +2. Technology Stack and Decisions (required table) 3. Architecture Overview -4. Repository & Service Strategy +4. Repository and Service Strategy 5. Data Architecture -6. Component & Integration Overview +6. Component and Integration Overview 7-N. **Pattern-Specific Sections** (varies by template) N+1. Proposed Source Tree N+2. Getting Started (Human Setup) - N+3. Implementation Patterns & Conventions (Agent Guidance) + N+3. Implementation Patterns and Conventions (Agent Guidance) N+4. Testing Strategy - N+5. Deployment & Operations + N+5. Deployment and Operations N+6. Security N+7. Specialist Sections @@ -472,7 +472,7 @@ Specialists are documented with: --- -## Validation & Quality Gates +## Validation and Quality Gates ### Cohesion Check (Step 7) diff --git a/src/modules/bmm/workflows/3-solutioning/checklist.md b/src/modules/bmm/workflows/3-solutioning/checklist.md index b1641e4b..f91e6380 100644 --- a/src/modules/bmm/workflows/3-solutioning/checklist.md +++ b/src/modules/bmm/workflows/3-solutioning/checklist.md @@ -54,7 +54,7 @@ Use this checklist during workflow execution and review. - [ ] Template sections determined dynamically - [ ] User approved section list - [ ] architecture.md generated with ALL sections -- [ ] Technology & Library Decision Table included with specific versions +- [ ] Technology and Library Decision Table included with specific versions - [ ] Proposed Source Tree included - [ ] Design-level only (no extensive code) - [ ] Output adapted to user skill level @@ -103,7 +103,7 @@ Use this checklist during workflow execution and review. ## Quality Gates -### Technology & Library Decision Table +### Technology and Library Decision Table - [ ] Table exists in architecture.md - [ ] ALL technologies have specific versions (e.g., "pino 8.17.0") diff --git a/src/modules/bmm/workflows/3-solutioning/instructions.md b/src/modules/bmm/workflows/3-solutioning/instructions.md index 85fb98bd..fee73e29 100644 --- a/src/modules/bmm/workflows/3-solutioning/instructions.md +++ b/src/modules/bmm/workflows/3-solutioning/instructions.md @@ -371,7 +371,7 @@ Sub-step 6.2: Fill Template Placeholders 8. Generate final architecture.md document CRITICAL REQUIREMENTS: -- MUST include "Technology & Library Decisions" section with table: +- MUST include "Technology and Library Decisions" section with table: | Category | Technology | Version | Rationale | - ALL technologies with SPECIFIC versions (e.g., "pino 8.17.0") - NO vagueness ("a logging library" = FAIL) @@ -391,13 +391,13 @@ CRITICAL REQUIREMENTS: Common sections (adapt per project): 1. Executive Summary -2. Technology Stack & Decisions (TABLE REQUIRED) -3. Repository & Service Architecture (mono/poly, monolith/microservices) +2. Technology Stack and Decisions (TABLE REQUIRED) +3. Repository and Service Architecture (mono/poly, monolith/microservices) 4. System Architecture (diagrams) 5. Data Architecture 6. API/Interface Design (adapts: REST for web, protocols for embedded, etc.) 7. Cross-Cutting Concerns -8. Component & Integration Overview (NOT epic alignment - that's cohesion check) +8. Component and Integration Overview (NOT epic alignment - that's cohesion check) 9. Architecture Decision Records 10. Implementation Guidance 11. Proposed Source Tree (REQUIRED) @@ -421,7 +421,7 @@ Run cohesion check validation inline (NO separate workflow for now): - Every epic has technical foundation? - Every story can be implemented with current architecture? -2. Technology & Library Table Validation: +2. Technology and Library Table Validation: - Table exists? - All entries have specific versions? - No vague entries ("a library", "some framework")? @@ -622,7 +622,7 @@ For monorepo projects: Final validation checklist: - [x] architecture.md exists and is complete -- [x] Technology & Library Decision Table has specific versions +- [x] Technology and Library Decision Table has specific versions - [x] Proposed Source Tree section included - [x] Cohesion check passed (or issues addressed) - [x] Epic Alignment Matrix generated diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/backend-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/backend-questions.md index e98c5b56..290440fe 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/backend-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/backend-questions.md @@ -1,6 +1,6 @@ # Backend/API Service Architecture Questions -## Service Type & Architecture +## Service Type and Architecture 1. **Service architecture:** - Monolithic API (single service) @@ -25,7 +25,7 @@ - Webhooks - Multiple patterns -## Framework & Language +## Framework and Language 4. **Backend language/framework:** - Node.js (Express, Fastify, NestJS, Hono) @@ -52,7 +52,7 @@ - Language-specific gRPC libraries - Not using gRPC -## Database & Data Layer +## Database and Data Layer 7. **Primary database:** - PostgreSQL @@ -91,7 +91,7 @@ - No (single database) - Planned for scale -## Authentication & Authorization +## Authentication and Authorization 12. **Authentication method:** - JWT (stateless) @@ -118,7 +118,7 @@ - Okta - Other: **\_\_\_** -## Message Queue & Event Streaming +## Message Queue and Event Streaming 15. **Message queue (if needed):** - RabbitMQ @@ -167,7 +167,7 @@ - Event bus - Not applicable -## API Design & Documentation +## API Design and Documentation 21. **API versioning:** - URL versioning (/v1/, /v2/) @@ -189,7 +189,7 @@ - cURL examples - Multiple tools -## Rate Limiting & Throttling +## Rate Limiting and Throttling 24. **Rate limiting:** - Per-user/API key @@ -204,7 +204,7 @@ - Redis-based - None -## Data Validation & Processing +## Data Validation and Processing 26. **Request validation:** - Schema validation (Zod, Joi, Yup, Pydantic) @@ -225,7 +225,7 @@ - Presigned URLs (client direct upload) - None needed -## Error Handling & Resilience +## Error Handling and Resilience 29. **Error handling strategy:** - Standard HTTP status codes @@ -264,7 +264,7 @@ - Loki + Grafana - None (local logs) -35. **Metrics & Monitoring:** +35. **Metrics and Monitoring:** - Prometheus - Datadog - New Relic @@ -335,7 +335,7 @@ - PCI DSS - None -## Deployment & Infrastructure +## Deployment and Infrastructure 45. **Deployment platform:** - AWS (ECS, EKS, Lambda, Elastic Beanstalk) @@ -438,7 +438,7 @@ - Fastly - None (dynamic only) -## Data & Storage +## Data and Storage 58. **File storage (if needed):** - AWS S3 diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/cli-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/cli-questions.md index 83945980..dfa29497 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/cli-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/cli-questions.md @@ -1,6 +1,6 @@ # Command-Line Tool Architecture Questions -## Language & Runtime +## Language and Runtime 1. **Primary language:** - Go (compiled, single binary, great for CLIs) @@ -128,7 +128,7 @@ - Used for runtime behavior - Not used -## Data & Storage +## Data and Storage 17. **Persistent data:** - Cache (temporary, can be deleted) @@ -208,7 +208,7 @@ - Configurable verbosity (--verbose, --quiet) - No logging (simple tool) -## Piping & Integration +## Piping and Integration 28. **Stdin support:** - Reads from stdin (pipe input) @@ -229,7 +229,7 @@ - All shells - None -## Distribution & Installation +## Distribution and Installation 31. **Package managers:** - Homebrew (macOS/Linux) diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/data-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/data-questions.md index 4e36d575..3d68025d 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/data-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/data-questions.md @@ -1,6 +1,6 @@ # Data/Analytics/ML Project Architecture Questions -## Project Type & Scope +## Project Type and Scope 1. **Primary project focus:** - ETL/Data Pipeline (move and transform data) @@ -25,7 +25,7 @@ - Real-time streaming (milliseconds) - Mix -## Programming Language & Environment +## Programming Language and Environment 4. **Primary language:** - Python (pandas, numpy, sklearn, pytorch, tensorflow) @@ -109,7 +109,7 @@ - Delete after X months/years - Compliance-driven retention -## Data Processing & Transformation +## Data Processing and Transformation 14. **Data processing framework:** - pandas (single machine) @@ -192,7 +192,7 @@ 22. **Experiment tracking:** - MLflow - - Weights & Biases + - Weights and Biases - Neptune.ai - Comet - TensorBoard @@ -260,7 +260,7 @@ - Azure AutoML - Not using AutoML -## Orchestration & Workflow +## Orchestration and Workflow 30. **Workflow orchestration:** - Apache Airflow @@ -293,7 +293,7 @@ - Simple sequential - None (independent tasks) -## Data Analytics & Visualization +## Data Analytics and Visualization 34. **BI/Visualization tool:** - Tableau @@ -321,7 +321,7 @@ - Notebooks - Multiple interfaces -## Data Governance & Security +## Data Governance and Security 37. **Data catalog:** - Amundsen @@ -360,7 +360,7 @@ - Manual snapshots - None -## Testing & Validation +## Testing and Validation 42. **Data testing:** - Unit tests (transformation logic) @@ -378,7 +378,7 @@ - A/B testing in production - None -## Deployment & CI/CD +## Deployment and CI/CD 44. **Deployment strategy:** - GitOps (version-controlled config) @@ -396,7 +396,7 @@ - Docker - Not containerized (native environments) -## Monitoring & Observability +## Monitoring and Observability 47. **Pipeline monitoring:** - Orchestrator built-in (Airflow UI, Prefect) @@ -429,7 +429,7 @@ - Cost monitoring dashboards - Not a priority -## Collaboration & Documentation +## Collaboration and Documentation 51. **Team collaboration:** - Git for code @@ -451,7 +451,7 @@ - Peer review (optional) - No formal review -## Performance & Scale +## Performance and Scale 54. **Performance requirements:** - Near real-time (< 1 minute latency) diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/desktop-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/desktop-questions.md index 5d355d7d..a6d1c1ef 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/desktop-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/desktop-questions.md @@ -1,6 +1,6 @@ # Desktop Application Architecture Questions -## Framework & Platform +## Framework and Platform 1. **Primary framework:** - Electron (JavaScript/TypeScript, web tech, cross-platform) @@ -93,7 +93,7 @@ - Full disk access - None (sandboxed app) -## Updates & Distribution +## Updates and Distribution 11. **Auto-update mechanism:** - Electron's autoUpdater @@ -124,7 +124,7 @@ - Required (public distribution) - Not needed (internal only) -## Packaging & Installation +## Packaging and Installation 15. **Windows installer:** - NSIS @@ -152,7 +152,7 @@ - AUR (Arch) - Multiple formats -## Configuration & Settings +## Configuration and Settings 18. **Settings storage:** - OS-specific (Registry on Windows, plist on macOS, config files on Linux) @@ -184,7 +184,7 @@ - Custom protocol - None -## Authentication & Security +## Authentication and Security 22. **Authentication (if applicable):** - OAuth2 (Google, Microsoft, etc.) @@ -204,7 +204,7 @@ - Partially sandboxed - Not sandboxed (legacy/compatibility) -## Performance & Resources +## Performance and Resources 25. **Performance requirements:** - Lightweight (minimal resource usage) @@ -221,7 +221,7 @@ - Single instance only - Single instance with IPC (communicate between instances) -## Development & Build +## Development and Build 28. **Build tooling:** - electron-builder diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/extension-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/extension-questions.md index 86201452..87125555 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/extension-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/extension-questions.md @@ -21,7 +21,7 @@ - Chrome + Firefox (minor differences) - All major browsers (requires polyfills/adapters) -## Extension Type & Architecture +## Extension Type and Architecture 4. **Primary extension type:** - Browser Action (icon in toolbar) @@ -47,7 +47,7 @@ - User-activated (inject on demand) - Not needed -## UI & Framework +## UI and Framework 7. **UI framework:** - Vanilla JS (no framework) @@ -119,7 +119,7 @@ - declarativeNetRequest (MV3 alternative) - None -## Data & Storage +## Data and Storage 16. **Data storage:** - chrome.storage.local @@ -236,7 +236,7 @@ - Stripe integration - No purchases -## Privacy & Security +## Privacy and Security 34. **User privacy:** - No data collection @@ -271,7 +271,7 @@ - Automated tests in CI - Manual testing only -## Updates & Deployment +## Updates and Deployment 40. **Update strategy:** - Auto-update (store handles) @@ -322,7 +322,7 @@ - Multiple languages - English only -## Analytics & Monitoring +## Analytics and Monitoring 51. **Analytics:** - Google Analytics (with privacy considerations) @@ -356,7 +356,7 @@ - Moderate (1-5MB) - Large (> 5MB, media/assets) -## Compliance & Review +## Compliance and Review 56. **Chrome Web Store review:** - Standard review (automated + manual) diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/game-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/game-questions.md index 5bea1426..5e4812bf 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/game-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/game-questions.md @@ -1,6 +1,6 @@ # Game Architecture Questions -## Engine & Platform +## Engine and Platform 1. **Game engine:** - Unity (C#, versatile, large ecosystem) @@ -109,7 +109,7 @@ - Aseprite (pixel art) - Other: **\_\_\_** -## Analytics & LiveOps +## Analytics and LiveOps 16. **Analytics:** - Unity Analytics diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/infra-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/infra-questions.md index 5a63b1e7..40e95041 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/infra-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/infra-questions.md @@ -116,7 +116,7 @@ - Composite action (reusable workflow) - Not using GitHub Actions -## Configuration & State Management +## Configuration and State Management 14. **Configuration approach:** - Configuration files (YAML, JSON, HCL) @@ -195,7 +195,7 @@ - DAG-based (topological sort) - None (independent resources) -## Language & Framework +## Language and Framework 23. **Implementation language:** - Go (common for K8s, CLI tools) @@ -217,7 +217,7 @@ - Custom libraries - Other: **\_\_\_** -## API & Integration +## API and Integration 25. **API exposure:** - REST API @@ -235,7 +235,7 @@ - Version control (Git) - Other: **\_\_\_** -## Idempotency & Safety +## Idempotency and Safety 27. **Idempotency:** - Fully idempotent (safe to run multiple times) @@ -350,7 +350,7 @@ - Calendar versioning - API version compatibility -## Updates & Lifecycle +## Updates and Lifecycle 44. **Update mechanism:** - Manual download/install @@ -395,7 +395,7 @@ - Dependency scanning - None -## Compliance & Governance +## Compliance and Governance 51. **Compliance focus:** - Policy enforcement (OPA, Kyverno) @@ -417,7 +417,7 @@ - CloudTrail/Activity logs - Not applicable -## Performance & Scale +## Performance and Scale 54. **Performance requirements:** - Fast execution (seconds) @@ -436,7 +436,7 @@ - Configurable rate limits - Not applicable -## CI/CD & Automation +## CI/CD and Automation 57. **CI/CD for the tool itself:** - GitHub Actions @@ -457,7 +457,7 @@ - Security scans - None -## Community & Ecosystem +## Community and Ecosystem 60. **Open source:** - Fully open source diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/library-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/library-questions.md index 56236d86..0b6d8004 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/library-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/library-questions.md @@ -1,6 +1,6 @@ # Library/SDK Architecture Questions -## Language & Platform +## Language and Platform 1. **Primary language:** - TypeScript/JavaScript @@ -62,7 +62,7 @@ - @types package (DefinitelyTyped) - Not applicable -## Build & Distribution +## Build and Distribution 9. **Build tool:** - tsup (TypeScript, simple) @@ -119,7 +119,7 @@ - Moderate (50-80%) - Critical paths only -## Versioning & Releases +## Versioning and Releases 17. **Versioning:** - Semantic versioning (semver) diff --git a/src/modules/bmm/workflows/3-solutioning/project-types/mobile-questions.md b/src/modules/bmm/workflows/3-solutioning/project-types/mobile-questions.md index 60990387..92269750 100644 --- a/src/modules/bmm/workflows/3-solutioning/project-types/mobile-questions.md +++ b/src/modules/bmm/workflows/3-solutioning/project-types/mobile-questions.md @@ -18,7 +18,7 @@ - Expo (managed, easier, some limitations) - React Native CLI (bare workflow, full control) -## Backend & Data +## Backend and Data 4. **Backend approach:** - Firebase (BaaS, real-time, easy) diff --git a/src/modules/bmm/workflows/3-solutioning/tech-spec/README.md b/src/modules/bmm/workflows/3-solutioning/tech-spec/README.md index 14e7a117..14745643 100644 --- a/src/modules/bmm/workflows/3-solutioning/tech-spec/README.md +++ b/src/modules/bmm/workflows/3-solutioning/tech-spec/README.md @@ -185,7 +185,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Validate output using `checklist.md` - Ensure PRD and architecture documents are complete before starting - Consult BMAD documentation for technical specification standards diff --git a/src/modules/bmm/workflows/3-solutioning/tech-spec/workflow.yaml b/src/modules/bmm/workflows/3-solutioning/tech-spec/workflow.yaml index ab903d1a..e433ddf3 100644 --- a/src/modules/bmm/workflows/3-solutioning/tech-spec/workflow.yaml +++ b/src/modules/bmm/workflows/3-solutioning/tech-spec/workflow.yaml @@ -49,3 +49,12 @@ execution_hints: # Variables variables: non_interactive: true + +web_bundle: + name: "tech-spec" + description: "Generate a comprehensive Technical Specification from PRD and Architecture with acceptance criteria and traceability mapping" + author: "BMAD BMM" + web_bundle_files: + - "bmad/bmm/workflows/3-solutioning/tech-spec/template.md" + - "bmad/bmm/workflows/3-solutioning/tech-spec/instructions.md" + - "bmad/bmm/workflows/3-solutioning/tech-spec/checklist.md" diff --git a/src/modules/bmm/workflows/3-solutioning/templates/backend-service-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/backend-service-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/backend-service-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/backend-service-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-architecture.md index 54e81bc1..b4641da4 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table | Category | Technology | Version | Justification | | ------------------ | ---------------------- | ---------------------- | ---------------------------- | @@ -25,7 +25,7 @@ {{additional_tech_stack_rows}} -## 2. Engine & Platform +## 2. Engine and Platform ### 2.1 Game Engine Choice @@ -57,7 +57,7 @@ {{state_machine}} -## 4. Scene & Level Architecture +## 4. Scene and Level Architecture ### 4.1 Scene Organization @@ -125,7 +125,7 @@ {{model_import}} -### 7.2 Textures & Materials +### 7.2 Textures and Materials {{textures_materials}} @@ -141,7 +141,7 @@ {{animation_system}} -## 9. Physics & Collision +## 9. Physics and Collision {{physics_collision}} @@ -171,7 +171,7 @@ {{audio_specialist_section}} -## 15. Component & Integration Overview +## 15. Component and Integration Overview {{component_overview}} @@ -212,7 +212,7 @@ - {{critical_folder_2}}: {{critical_folder_2_description}} - {{critical_folder_3}}: {{critical_folder_3_description}} -## 19. Performance & Optimization +## 19. Performance and Optimization {{performance_optimization}} @@ -222,7 +222,7 @@ {{testing_strategy}} -## 21. Build & Distribution +## 21. Build and Distribution {{build_distribution}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md index e977c48f..37c4ae80 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md @@ -6,7 +6,7 @@ This guide provides Godot-specific guidance for solution architecture generation ## Godot-Specific Questions -### 1. Godot Version & Language Strategy +### 1. Godot Version and Language Strategy **Ask:** @@ -276,7 +276,7 @@ project/ --- -### Deployment & Build +### Deployment and Build **Platform-specific:** diff --git a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md index f676b693..c695dd07 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md @@ -6,7 +6,7 @@ This guide provides Unity-specific guidance for solution architecture generation ## Unity-Specific Questions -### 1. Unity Version & Render Pipeline +### 1. Unity Version and Render Pipeline **Ask:** @@ -102,7 +102,7 @@ public class EnemyData : ScriptableObject --- -### Unity Events & Communication +### Unity Events and Communication **Ask:** @@ -216,7 +216,7 @@ Assets/ --- -### Deployment & Build +### Deployment and Build **Platform-specific:** diff --git a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md index c3d81839..ad73364c 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md @@ -6,7 +6,7 @@ This guide provides web game engine-specific guidance (Phaser, PixiJS, Three.js, ## Web Game-Specific Questions -### 1. Engine & Technology Selection +### 1. Engine and Technology Selection **Ask:** @@ -312,7 +312,7 @@ describe('Player', () => { --- -### Deployment & Build +### Deployment and Build **Build for production:** @@ -321,7 +321,7 @@ describe('Player', () => { { "scripts": { "dev": "vite", - "build": "tsc && vite build", + "build": "tsc andand vite build", "preview": "vite preview", "test": "jest" } diff --git a/src/modules/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/library-package-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/library-package-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/library-package-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/library-package-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/web-api-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/web-api-architecture.md index e4aebc2c..8d58e102 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/web-api-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/web-api-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table {{technology_table}} @@ -22,7 +22,7 @@ {{data_architecture}} -## 4. Component & Integration Overview +## 4. Component and Integration Overview {{component_overview}} @@ -45,7 +45,7 @@ {{testing_strategy}} {{testing_specialist_section}} -## 9. Deployment & Operations +## 9. Deployment and Operations {{deployment_operations}} {{devops_specialist_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md b/src/modules/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md index 6e7a41d2..4c92ff67 100644 --- a/src/modules/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md +++ b/src/modules/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md @@ -8,9 +8,9 @@ {{executive_summary}} -## 1. Technology Stack & Decisions +## 1. Technology Stack and Decisions -### 1.1 Technology & Library Decision Table +### 1.1 Technology and Library Decision Table | Category | Technology | Version | Justification | | ---------------- | -------------- | ---------------------- | ---------------------------- | @@ -35,7 +35,7 @@ {{ssr_strategy}} -### 2.3 Page Routing & Navigation +### 2.3 Page Routing and Navigation {{routing_navigation}} @@ -49,7 +49,7 @@ {{database_schema}} -### 3.2 Data Models & Relationships +### 3.2 Data Models and Relationships {{data_models}} @@ -67,11 +67,11 @@ {{api_routes}} -### 4.3 Form Actions & Mutations +### 4.3 Form Actions and Mutations {{form_actions}} -## 5. Authentication & Authorization +## 5. Authentication and Authorization ### 5.1 Auth Strategy @@ -143,7 +143,7 @@ {{code_splitting}} -## 9. SEO & Meta Tags +## 9. SEO and Meta Tags ### 9.1 Meta Tag Strategy @@ -175,7 +175,7 @@ {{environment_config}} -## 11. Component & Integration Overview +## 11. Component and Integration Overview ### 11.1 Major Modules @@ -254,7 +254,7 @@ {{testing_specialist_section}} -## 16. DevOps & CI/CD +## 16. DevOps and CI/CD {{devops_section}} diff --git a/src/modules/bmm/workflows/3-solutioning/workflow.yaml b/src/modules/bmm/workflows/3-solutioning/workflow.yaml index 5e227b41..c7bf9e3a 100644 --- a/src/modules/bmm/workflows/3-solutioning/workflow.yaml +++ b/src/modules/bmm/workflows/3-solutioning/workflow.yaml @@ -61,5 +61,37 @@ default_output_file: "{output_folder}/solution-architecture.md" # Additional workflow dependencies tech_spec_workflow: "{project-root}/bmad/bmm/workflows/3-solutioning/tech-spec" -# No special tools required -required_tools: [] +web_bundle: + name: "solution-architecture" + description: "Scale-adaptive solution architecture generation with dynamic template sections. Replaces legacy HLA workflow with modern BMAD Core compliance." + author: "BMad Builder" + web_bundle_files: + - "bmad/bmm/workflows/3-solutioning/instructions.md" + - "bmad/bmm/workflows/3-solutioning/checklist.md" + - "bmad/bmm/workflows/3-solutioning/ADR-template.md" + - "bmad/bmm/workflows/3-solutioning/templates/registry.csv" + - "bmad/bmm/workflows/3-solutioning/templates/backend-service-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/game-engine-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md" + - "bmad/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md" + - "bmad/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md" + - "bmad/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/library-package-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/web-api-architecture.md" + - "bmad/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md" + - "bmad/bmm/workflows/3-solutioning/project-types/backend-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/cli-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/data-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/desktop-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/embedded-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/extension-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/game-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/infra-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/library-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/mobile-questions.md" + - "bmad/bmm/workflows/3-solutioning/project-types/web-questions.md" diff --git a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml b/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml index 1833f56e..db8a4242 100644 --- a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml @@ -33,3 +33,11 @@ halt_conditions: execution_modes: - incremental: "Recommended - Refine each edit with user collaboration" - batch: "Present all changes at once for review" + +web_bundle: + name: "correct-course" + description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation" + author: "BMad Method" + web_bundle_files: + - "bmad/bmm/workflows/4-implementation/correct-course/instructions.md" + - "bmad/bmm/workflows/4-implementation/correct-course/checklist.md" diff --git a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml index 7809081f..eb32af30 100644 --- a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml @@ -70,3 +70,12 @@ execution_hints: interactive: false autonomous: true iterative: true + +web_bundle: + name: "create-story" + description: "Create the next user story markdown from epics/PRD and architecture, using a standard template and saving to the stories folder" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/create-story/template.md" + - "bmad/bmm/workflows/create-story/instructions.md" + - "bmad/bmm/workflows/create-story/checklist.md" diff --git a/src/modules/bmm/workflows/4-implementation/dev-story/checklist.md b/src/modules/bmm/workflows/4-implementation/dev-story/checklist.md index c4226ca4..9bfa982b 100644 --- a/src/modules/bmm/workflows/4-implementation/dev-story/checklist.md +++ b/src/modules/bmm/workflows/4-implementation/dev-story/checklist.md @@ -17,7 +17,7 @@ validation-rules: - [ ] All tasks and subtasks for this story are marked complete with [x] - [ ] Implementation aligns with every Acceptance Criterion in the story -## Tests & Quality +## Tests and Quality - [ ] Unit tests added/updated for core functionality changed by this story - [ ] Integration tests added/updated when component interactions are affected diff --git a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml index e44b7279..15e9f063 100644 --- a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml @@ -51,3 +51,11 @@ execution_hints: interactive: false # Minimize prompts; intended to run to completion autonomous: true # Proceed without user input unless blocked iterative: true + +web_bundle: + name: "dev-story" + description: "Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/dev-story/instructions.md" + - "bmad/bmm/workflows/dev-story/checklist.md" diff --git a/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md b/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md index e7d7a844..fba518c1 100644 --- a/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +++ b/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md @@ -113,7 +113,7 @@ Delivery Metrics: - Duration: {{actual_sprints}} sprints (planned: {{planned_sprints}}) - Average velocity: {{points_per_sprint}} points/sprint -Quality & Technical: +Quality and Technical: - Blockers encountered: {{blocker_count}} - Technical debt items: {{debt_count}} - Test coverage: {{coverage_info}} diff --git a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml b/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml index ae3db28d..5d3add07 100644 --- a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml @@ -39,3 +39,10 @@ validation_required: - business_validation: "Have stakeholders reviewed and accepted deliverables?" - technical_health: "Is codebase in stable, maintainable state?" - blocker_resolution: "Any unresolved blockers that will impact next epic?" + +web_bundle: + name: "retrospective" + description: "Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/4-implementation/retrospective/instructions.md" diff --git a/src/modules/bmm/workflows/4-implementation/review-story/README.md b/src/modules/bmm/workflows/4-implementation/review-story/README.md index 557d2508..7ba80052 100644 --- a/src/modules/bmm/workflows/4-implementation/review-story/README.md +++ b/src/modules/bmm/workflows/4-implementation/review-story/README.md @@ -40,7 +40,7 @@ Perform an AI-driven Senior Developer Review on a story flagged "Ready for Revie - Adds a Change Log entry: "Senior Developer Review notes appended" - If enabled, updates `Status` based on outcome -## Persistence & Backlog +## Persistence and Backlog To ensure review findings become actionable work, the workflow can persist action items to multiple targets (configurable): diff --git a/src/modules/bmm/workflows/4-implementation/review-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/review-story/workflow.yaml index 1fd1d029..af59ed8f 100644 --- a/src/modules/bmm/workflows/4-implementation/review-story/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/review-story/workflow.yaml @@ -97,3 +97,11 @@ execution_hints: interactive: false # Minimize prompts; intended to run deterministically autonomous: true # Proceed without user input unless blocked iterative: true + +web_bundle: + name: "review-story" + description: "Perform a Senior Developer Review on a completed story flagged Ready for Review, leveraging story-context, epic tech-spec, repo docs, MCP servers for latest best-practices, and web search as fallback. Appends structured review notes to the story." + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/review-story/instructions.md" + - "bmad/bmm/workflows/review-story/checklist.md" diff --git a/src/modules/bmm/workflows/4-implementation/story-context/README.md b/src/modules/bmm/workflows/4-implementation/story-context/README.md index 0ca56a1f..e3cb2665 100644 --- a/src/modules/bmm/workflows/4-implementation/story-context/README.md +++ b/src/modules/bmm/workflows/4-implementation/story-context/README.md @@ -224,7 +224,7 @@ To customize this workflow: For issues or questions: -- Review the workflow creation guide at `/bmad/bmb/workflows/build-workflow/workflow-creation-guide.md` +- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Validate output using `checklist.md` - Ensure story files follow expected markdown structure - Check that repository structure supports automated discovery diff --git a/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml b/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml index fc44aebb..e900539a 100644 --- a/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +++ b/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml @@ -54,3 +54,12 @@ execution_hints: interactive: false autonomous: true iterative: true + +web_bundle: + name: "story-context" + description: "Assemble a dynamic Story Context XML by pulling latest documentation and existing code/library artifacts relevant to a drafted story" + author: "BMad" + web_bundle_files: + - "bmad/bmm/workflows/story-context/context-template.xml" + - "bmad/bmm/workflows/story-context/instructions.md" + - "bmad/bmm/workflows/story-context/checklist.md" diff --git a/src/modules/cis/workflows/brainstorming/README.md b/src/modules/cis/workflows/brainstorming/README.md index 44f48fd2..505fb0e4 100644 --- a/src/modules/cis/workflows/brainstorming/README.md +++ b/src/modules/cis/workflows/brainstorming/README.md @@ -180,7 +180,7 @@ The workflow includes 36 techniques organized into 7 categories: 2. **Technique Sessions** - Detailed capture of each technique's ideation process 3. **Idea Categorization** - Immediate opportunities, future innovations, moonshots, insights 4. **Action Planning** - Top 3 priorities with rationale, steps, resources, timelines -5. **Reflection & Follow-up** - Session analysis, recommendations, next steps planning +5. **Reflection and Follow-up** - Session analysis, recommendations, next steps planning ## Requirements @@ -268,4 +268,4 @@ For issues or questions: --- -_Part of the BMad Method v5 - Creative Ideation & Synthesis (CIS) Module_ +_Part of the BMad Method v5 - Creative Ideation and Synthesis (CIS) Module_ diff --git a/src/modules/cis/workflows/brainstorming/template.md b/src/modules/cis/workflows/brainstorming/template.md index e68b4444..62283ce7 100644 --- a/src/modules/cis/workflows/brainstorming/template.md +++ b/src/modules/cis/workflows/brainstorming/template.md @@ -42,7 +42,7 @@ _Ambitious, transformative concepts_ {{moonshots}} -### Insights & Learnings +### Insights and Learnings _Key realizations from the session_ @@ -73,7 +73,7 @@ _Key realizations from the session_ - Resources needed: {{priority_3_resources}} - Timeline: {{priority_3_timeline}} -## Reflection & Follow-up +## Reflection and Follow-up ### What Worked Well diff --git a/src/modules/cis/workflows/brainstorming/workflow.yaml b/src/modules/cis/workflows/brainstorming/workflow.yaml index dfa1db7d..6bfa7b2d 100644 --- a/src/modules/cis/workflows/brainstorming/workflow.yaml +++ b/src/modules/cis/workflows/brainstorming/workflow.yaml @@ -22,9 +22,17 @@ installed_path: "{project-root}/bmad/cis/workflows/brainstorming" template: "{installed_path}/template.md" instructions: "{installed_path}/instructions.md" validation: "{installed_path}/checklist.md" - -# Required Data Files brain_techniques: "{installed_path}/brain-methods.csv" # Output configuration default_output_file: "{output_folder}/brainstorming-session-results-{{date}}.md" + +web_bundle: + name: "brainstorming" + description: "Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions." + author: "BMad" + web_bundle_files: + - "bmad/cis/workflows/brainstorming/instructions.md" + - "bmad/cis/workflows/brainstorming/checklist.md" + - "bmad/cis/workflows/brainstorming/brain-methods.csv" + - "bmad/cis/workflows/brainstorming/template.md" diff --git a/src/modules/cis/workflows/design-thinking/workflow.yaml b/src/modules/cis/workflows/design-thinking/workflow.yaml index 94e57b7f..b5732138 100644 --- a/src/modules/cis/workflows/design-thinking/workflow.yaml +++ b/src/modules/cis/workflows/design-thinking/workflow.yaml @@ -27,3 +27,12 @@ design_methods: "{installed_path}/design-methods.csv" # Output configuration default_output_file: "{output_folder}/design-thinking-{{date}}.md" + +web_bundle: + name: "design-thinking" + description: "Guide human-centered design processes using empathy-driven methodologies. This workflow walks through the design thinking phases - Empathize, Define, Ideate, Prototype, and Test - to create solutions deeply rooted in user needs." + author: "BMad" + web_bundle_files: + - "bmad/cis/workflows/design-thinking/instructions.md" + - "bmad/cis/workflows/design-thinking/template.md" + - "bmad/cis/workflows/design-thinking/design-methods.csv" diff --git a/src/modules/cis/workflows/innovation-strategy/innovation-frameworks.csv b/src/modules/cis/workflows/innovation-strategy/innovation-frameworks.csv index 7b2d602a..e2f0cd43 100644 --- a/src/modules/cis/workflows/innovation-strategy/innovation-frameworks.csv +++ b/src/modules/cis/workflows/innovation-strategy/innovation-frameworks.csv @@ -27,5 +27,5 @@ value_chain,Partnership Strategy,Design strategic partnerships and ecosystem pla technology,Technology Adoption Lifecycle,Understand how innovations diffuse through society from innovators to laggards to time market entry,Who are the innovators?|Who are early adopters?|What's our adoption strategy?|How do we cross chasms?|What's our current stage? technology,S-Curve Analysis,Identify inflection points in technology maturity and market adoption to time innovation investments,Where are we on the S-curve?|What's the next curve?|When should we jump curves?|What's the tipping point?|What should we invest in now? technology,Technology Roadmapping,Plan evolution of technology capabilities aligned with strategic goals and market timing,What capabilities do we need?|What's the sequence?|What dependencies exist?|What's the timeline?|Where do we invest first? -technology,Open Innovation Strategy,Leverage external ideas technologies and paths to market to accelerate innovation beyond internal R&D,What could we source externally?|Who has relevant innovation?|How do we collaborate?|What IP strategy?|How do we integrate external innovation? +technology,Open Innovation Strategy,Leverage external ideas technologies and paths to market to accelerate innovation beyond internal R and D,What could we source externally?|Who has relevant innovation?|How do we collaborate?|What IP strategy?|How do we integrate external innovation? technology,Digital Transformation Framework,Reimagine business models operations and customer experiences through digital technology enablers,What digital capabilities exist?|How could they transform our model?|What customer experience improvements?|What operational efficiencies?|What new business models? \ No newline at end of file diff --git a/src/modules/cis/workflows/innovation-strategy/template.md b/src/modules/cis/workflows/innovation-strategy/template.md index c9c809dc..1c6d6908 100644 --- a/src/modules/cis/workflows/innovation-strategy/template.md +++ b/src/modules/cis/workflows/innovation-strategy/template.md @@ -48,7 +48,7 @@ {{value_proposition}} -### Revenue & Cost Structure +### Revenue and Cost Structure {{revenue_cost_structure}} @@ -92,7 +92,7 @@ {{value_chain_opportunities}} -### Partnership & Ecosystem Plays +### Partnership and Ecosystem Plays {{partnership_opportunities}} @@ -152,7 +152,7 @@ {{phase_2}} -### Phase 3: Scale & Optimize (9-18 months) +### Phase 3: Scale and Optimize (9-18 months) {{phase_3}} @@ -174,7 +174,7 @@ --- -## ⚠️ RISKS & MITIGATION +## ⚠️ RISKS AND MITIGATION ### Key Risks diff --git a/src/modules/cis/workflows/innovation-strategy/workflow.yaml b/src/modules/cis/workflows/innovation-strategy/workflow.yaml index f8227675..f065cd75 100644 --- a/src/modules/cis/workflows/innovation-strategy/workflow.yaml +++ b/src/modules/cis/workflows/innovation-strategy/workflow.yaml @@ -27,3 +27,12 @@ innovation_frameworks: "{installed_path}/innovation-frameworks.csv" # Output configuration default_output_file: "{output_folder}/innovation-strategy-{{date}}.md" + +web_bundle: + name: "innovation-strategy" + description: "Identify disruption opportunities and architect business model innovation. This workflow guides strategic analysis of markets, competitive dynamics, and business model innovation to uncover sustainable competitive advantages and breakthrough opportunities." + author: "BMad" + web_bundle_files: + - "bmad/cis/workflows/innovation-strategy/instructions.md" + - "bmad/cis/workflows/innovation-strategy/template.md" + - "bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv" diff --git a/src/modules/cis/workflows/problem-solving/solving-methods.csv b/src/modules/cis/workflows/problem-solving/solving-methods.csv index 6c2a26cd..4c7bd94d 100644 --- a/src/modules/cis/workflows/problem-solving/solving-methods.csv +++ b/src/modules/cis/workflows/problem-solving/solving-methods.csv @@ -12,7 +12,7 @@ analysis,Failure Mode Analysis,Anticipate how solutions could fail and engineer synthesis,TRIZ Contradiction Matrix,Resolve technical contradictions using 40 inventive principles from pattern analysis of patents,What improves?|What worsens?|What's the contradiction?|What principles apply?|How to resolve? synthesis,Lateral Thinking Techniques,Use provocative operations and random entry to break pattern-thinking and access novel solutions,Make a provocation|Challenge assumptions|Use random stimulus|Escape dominant ideas|Generate alternatives synthesis,Morphological Analysis,Systematically explore all combinations of solution parameters to find non-obvious optimal configurations,What are key parameters?|What options exist for each?|Try different combinations|What patterns emerge?|What's optimal? -synthesis,Biomimicry Problem Solving,Learn from nature's 3.8 billion years of R&D to find elegant solutions to engineering challenges,How does nature solve this?|What biological analogy?|What principles transfer?|How to adapt? +synthesis,Biomimicry Problem Solving,Learn from nature's 3.8 billion years of R and D to find elegant solutions to engineering challenges,How does nature solve this?|What biological analogy?|What principles transfer?|How to adapt? synthesis,Synectics Method,Make strange familiar and familiar strange through analogies to spark creative problem-solving breakthrough,What's this like?|How are they similar?|What metaphor fits?|What does that suggest?|What insight emerges? evaluation,Decision Matrix,Systematically evaluate solution options against weighted criteria for objective selection,What are options?|What criteria matter?|What weights?|Rate each option|Calculate scores|What wins? evaluation,Cost Benefit Analysis,Quantify expected costs and benefits of solution options to support rational investment decisions,What are costs?|What are benefits?|Quantify each|What's payback period?|What's ROI?|What's recommended? diff --git a/src/modules/cis/workflows/problem-solving/template.md b/src/modules/cis/workflows/problem-solving/template.md index 6d56b61d..1231373d 100644 --- a/src/modules/cis/workflows/problem-solving/template.md +++ b/src/modules/cis/workflows/problem-solving/template.md @@ -26,7 +26,7 @@ --- -## 🔍 DIAGNOSIS & ROOT CAUSE ANALYSIS +## 🔍 DIAGNOSIS AND ROOT CAUSE ANALYSIS ### Problem Boundaries (Is/Is Not) @@ -112,7 +112,7 @@ {{action_steps}} -### Timeline & Milestones +### Timeline and Milestones {{timeline}} @@ -126,7 +126,7 @@ --- -## 📈 MONITORING & VALIDATION +## 📈 MONITORING AND VALIDATION ### Success Metrics diff --git a/src/modules/cis/workflows/problem-solving/workflow.yaml b/src/modules/cis/workflows/problem-solving/workflow.yaml index 59f60cef..8412dfff 100644 --- a/src/modules/cis/workflows/problem-solving/workflow.yaml +++ b/src/modules/cis/workflows/problem-solving/workflow.yaml @@ -27,3 +27,12 @@ solving_methods: "{installed_path}/solving-methods.csv" # Output configuration default_output_file: "{output_folder}/problem-solution-{{date}}.md" + +web_bundle: + name: "problem-solving" + description: "Apply systematic problem-solving methodologies to crack complex challenges. This workflow guides through problem diagnosis, root cause analysis, creative solution generation, evaluation, and implementation planning using proven frameworks." + author: "BMad" + web_bundle_files: + - "bmad/cis/workflows/problem-solving/instructions.md" + - "bmad/cis/workflows/problem-solving/template.md" + - "bmad/cis/workflows/problem-solving/solving-methods.csv" diff --git a/src/modules/cis/workflows/storytelling/instructions.md b/src/modules/cis/workflows/storytelling/instructions.md index 25b18503..23aae4fc 100644 --- a/src/modules/cis/workflows/storytelling/instructions.md +++ b/src/modules/cis/workflows/storytelling/instructions.md @@ -245,7 +245,7 @@ Provide strategic guidance for story deployment: - + Polish and plan forward: diff --git a/src/modules/cis/workflows/storytelling/template.md b/src/modules/cis/workflows/storytelling/template.md index 609b4fc1..ea157bca 100644 --- a/src/modules/cis/workflows/storytelling/template.md +++ b/src/modules/cis/workflows/storytelling/template.md @@ -62,7 +62,7 @@ {{key_messages}} -## Variations & Adaptations +## Variations AND Adaptations ### Short Version (Tweet/Social) @@ -86,7 +86,7 @@ {{audience_considerations}} -### Tone & Voice Notes +### Tone AND Voice Notes {{tone_notes}} diff --git a/src/modules/cis/workflows/storytelling/workflow.yaml b/src/modules/cis/workflows/storytelling/workflow.yaml index f528ed9a..2bd69e15 100644 --- a/src/modules/cis/workflows/storytelling/workflow.yaml +++ b/src/modules/cis/workflows/storytelling/workflow.yaml @@ -27,3 +27,12 @@ story_frameworks: "{installed_path}/story-types.csv" # Output configuration default_output_file: "{output_folder}/story-{{date}}.md" + +web_bundle: + name: "storytelling" + description: "Craft compelling narratives using proven story frameworks and techniques. This workflow guides users through structured narrative development, applying appropriate story frameworks to create emotionally resonant and engaging stories for any purpose." + author: "BMad" + web_bundle_files: + - "bmad/cis/workflows/storytelling/instructions.md" + - "bmad/cis/workflows/storytelling/template.md" + - "bmad/cis/workflows/storytelling/story-frameworks.csv" diff --git a/tools/cli/bundlers/web-bundler.js b/tools/cli/bundlers/web-bundler.js index 0a812f7e..f0863f57 100644 --- a/tools/cli/bundlers/web-bundler.js +++ b/tools/cli/bundlers/web-bundler.js @@ -212,7 +212,7 @@ class WebBundler { if (await fs.pathExists(agentsPath)) { const files = await fs.readdir(agentsPath); for (const file of files) { - if (file.endsWith('.md')) { + if (file.endsWith('.md') && !file.toLowerCase().includes('readme')) { const agentPath = path.join(agentsPath, file); const content = await fs.readFile(agentPath, 'utf8'); const agentXml = this.extractAgentXml(content); @@ -732,7 +732,7 @@ class WebBundler { const files = await fs.readdir(agentsPath); for (const file of files) { - if (file.endsWith('.md')) { + if (file.endsWith('.md') && !file.toLowerCase().includes('readme')) { agents.push(file); } }