bmad-method 4.17.0 → 4.18.0

package/dist/teams/team-no-ui.txt

@@ -560,9 +560,9 @@ Confirm with the user their preferred interaction style:
 
 ### 3. Execute Template
 
-- Load specified template from `templates#*` or the /templates directory
+- Load specified template from `templates#*` or the `{root}/templates directory`
 - Follow ALL embedded LLM instructions within the template
-- Process template markup according to `utils#template-format` conventions
+- Process template markup according to `utils#template-format` or `{root}/utils/template-format` conventions
 
 ### 4. Template Processing Rules
 
@@ -1429,227 +1429,73 @@ Use the **expansion-creator** pack to build your own:
 ==================== START: utils#workflow-management ====================
 # Workflow Management
 
-This utility enables the BMAD orchestrator to manage and execute team workflows.
+Enables BMAD orchestrator to manage and execute team workflows.
 
-## Important: Dynamic Workflow Loading
+## Dynamic Workflow Loading
 
-The BMAD orchestrator MUST read the available workflows from the current team configuration's `workflows` field. Do not use hardcoded workflow lists. Each team bundle defines its own set of supported workflows based on the agents it includes.
+Read available workflows from current team configuration's `workflows` field. Each team bundle defines its own supported workflows.
 
-**Critical Distinction**:
+**Key Commands**:
 
-- When asked "what workflows are available?", show ONLY the workflows defined in the current team bundle's configuration
-- Use `/agent-list` to show agents in the current bundle
-- Use `/workflows` to show workflows in the current bundle, NOT any creation tasks
-
-### Workflow Descriptions
-
-When displaying workflows, use these descriptions based on the workflow ID:
-
-- **greenfield-fullstack**: Build a new full-stack application from concept to development
-- **brownfield-fullstack**: Enhance an existing full-stack application with new features
-- **greenfield-service**: Build a new backend service or API from concept to development
-- **brownfield-service**: Enhance an existing backend service or API
-- **greenfield-ui**: Build a new frontend/UI application from concept to development
-- **brownfield-ui**: Enhance an existing frontend/UI application
+- `/workflows` - List workflows in current bundle or workflows folder
+- `/agent-list` - Show agents in current bundle
 
 ## Workflow Commands
 
 ### /workflows
 
-Lists all available workflows for the current team. The available workflows are determined by the team configuration and may include workflows such as:
-
-- greenfield-fullstack
-- brownfield-fullstack
-- greenfield-service
-- brownfield-service
-- greenfield-ui
-- brownfield-ui
-
-The actual list depends on which team bundle is loaded. When responding to this command, display the workflows that are configured in the current team's `workflows` field.
-
-Example response format:
-
-```text
-Available workflows for [Team Name]:
-1. [workflow-id] - [Brief description based on workflow type]
-2. [workflow-id] - [Brief description based on workflow type]
-[... etc. ...]
-
-Use /workflow-start {number or id} to begin a workflow.
-```
+Lists available workflows with titles and descriptions.
 
 ### /workflow-start {workflow-id}
 
-Starts a specific workflow and transitions to the first agent.
-
-Example: `/workflow-start greenfield-fullstack`
+Starts workflow and transitions to first agent.
 
 ### /workflow-status
 
-Shows current workflow progress, completed artifacts, and next steps.
-
-Example response:
-
-```text
-Current Workflow: Greenfield Full-Stack Development
-Stage: Product Planning (2 of 6)
-Completed:
-  ✓ Discovery & Requirements
-    - project-brief (completed by Mary)
-
-In Progress:
-  ⚡ Product Planning
-    - Create PRD (John) - awaiting input
-
-Next: Technical Architecture
-```
+Shows current progress, completed artifacts, and next steps.
 
 ### /workflow-resume
 
-Resumes a workflow from where it left off, useful when starting a new chat.
-
-User can provide completed artifacts:
-
-```text
-User: /workflow-resume greenfield-fullstack
-      I have completed: project-brief, PRD
-BMad: I see you've completed Discovery and part of Product Planning.
-      Based on the greenfield-fullstack workflow, the next step is:
-      - UX Strategy with Sally (ux-expert)
-
-      Would you like me to load Sally to continue?
-```
+Resumes workflow from last position. User can provide completed artifacts.
 
 ### /workflow-next
 
-Shows the next recommended agent and action in the current workflow.
-
-## Workflow Execution Flow
-
-### 1. Starting a Workflow
+Shows next recommended agent and action.
 
-When a workflow is started:
+## Execution Flow
 
-1. Load the workflow definition
-2. Identify the first stage and step
-3. Transition to the required agent
-4. Provide context about expected inputs/outputs
-5. Guide artifact creation
+1. **Starting**: Load definition → Identify first stage → Transition to agent → Guide artifact creation
 
-### 2. Stage Transitions
+2. **Stage Transitions**: Mark complete → Check conditions → Load next agent → Pass artifacts
 
-After each artifact is completed:
+3. **Artifact Tracking**: Track status, creator, timestamps in workflow_state
 
-1. Mark the step as complete
-2. Check transition conditions
-3. If stage is complete, move to next stage
-4. Load the appropriate agent
-5. Pass relevant artifacts as context
+4. **Interruption Handling**: Analyze provided artifacts → Determine position → Suggest next step
 
-### 3. Artifact Tracking
+## Context Passing
 
-Track all created artifacts:
-
-```yaml
-workflow_state:
-  current_workflow: greenfield-fullstack
-  current_stage: planning
-  current_step: 2
-  artifacts:
-    project-brief:
-      status: completed
-      created_by: analyst
-      timestamp: 2024-01-15T10:30:00.000Z
-    prd:
-      status: in-progress
-      created_by: pm
-      started: 2024-01-15T11:00:00.000Z
-```
+When transitioning, pass:
 
-### 4. Workflow Interruption Handling
-
-When user returns after interruption:
-
-1. Ask if continuing previous workflow
-2. Request any completed artifacts
-3. Analyze provided artifacts
-4. Determine workflow position
-5. Suggest next appropriate step
-
-Example:
-
-```text
-User: I'm working on a new app. Here's my PRD and architecture doc.
-BMad: I see you have a PRD and architecture document. Based on these artifacts,
-      it looks like you're following the greenfield-fullstack workflow and have completed
-      stages 1-3. The next recommended step would be:
-
-      Stage 4: Validation & Refinement
-      - Load Sarah (Product Owner) to validate all artifacts
-
-      Would you like to continue with this workflow?
-```
-
-## Workflow Context Passing
-
-When transitioning between agents, pass:
-
-1. Previous artifacts created
-2. Current workflow stage
-3. Expected outputs
-4. Any decisions or constraints identified
-
-Example transition:
-
-```text
-BMad: Great! John has completed the PRD. According to the greenfield-fullstack workflow,
-      the next step is UX Strategy with Sally.
-
-      /ux-expert
-
-Sally: I see we're in the Product Planning stage of the greenfield-fullstack workflow.
-       I have access to:
-       - Project Brief from Mary
-       - PRD from John
-
-       Let's create the UX strategy and UI specifications. First, let me review
-       the PRD to understand the features we're designing for...
-```
+- Previous artifacts
+- Current workflow stage
+- Expected outputs
+- Decisions/constraints
 
 ## Multi-Path Workflows
 
-Some workflows may have multiple paths:
+Handle conditional paths by asking clarifying questions when needed.
 
-```yaml
-conditional_paths:
-  - condition: project_type == 'mobile'
-    next_stage: mobile-specific-design
-  - condition: project_type == 'web'
-    next_stage: web-architecture
-  - default: fullstack-architecture
-```
+## Best Practices
 
-Handle these by asking clarifying questions when needed.
+1. Show progress
+2. Explain transitions
+3. Preserve context
+4. Allow flexibility
+5. Track state
 
-## Workflow Best Practices
+## Agent Integration
 
-1. **Always show progress** - Users should know where they are
-2. **Explain transitions** - Why moving to next agent
-3. **Preserve context** - Pass relevant information forward
-4. **Allow flexibility** - Users can skip or modify steps
-5. **Track everything** - Maintain complete workflow state
-
-## Integration with Agents
-
-Each agent should be workflow-aware:
-
-- Know which workflow is active
-- Understand their role in the workflow
-- Access previous artifacts
-- Know expected outputs
-- Guide toward workflow goals
-
-This creates a seamless experience where the entire team works together toward the workflow's objectives.
+Agents should be workflow-aware: know active workflow, their role, access artifacts, understand expected outputs.
 ==================== END: utils#workflow-management ====================
 
 ==================== START: utils#template-format ====================
@@ -3733,13 +3579,9 @@ The story creation is successful when:
 
 This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
 
-## Context
-
-The BMAD Method uses various checklists to ensure quality and completeness of different artifacts. Each checklist contains embedded prompts and instructions to guide the LLM through thorough validation and advanced elicitation. The checklists automatically identify their required artifacts and guide the validation process.
-
 ## Available Checklists
 
-If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
+If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the {root}/checklists folder to select the appropriate one to run.
 
 ## Instructions
 
@@ -3748,7 +3590,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
    - If user or the task being run provides a checklist name:
      - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
      - If multiple matches found, ask user to clarify
-     - Load the appropriate checklist from bmad-core/checklists/
+     - Load the appropriate checklist from {root}/checklists/
    - If no checklist specified:
      - Ask the user which checklist they want to use
      - Present the available options from the files in the checklists folder

package/docs/working-in-the-brownfield.md

@@ -116,7 +116,7 @@ The analyst will generate comprehensive documentation of everything.
 
 #### Option A: Full Brownfield Workflow (Recommended for Major Changes)
 
-**1. Create Brownfield PRD**
+**1. Create Brownfield PRD**:
 
 ```bash
 @pm
@@ -143,7 +143,7 @@ The PM agent will:
 - "What are the critical constraints we must respect?"
 - "What is your timeline and team size?"
 
-**2. Create Brownfield Architecture**
+**2. Create Brownfield Architecture**:
 
 ```bash
 @architect

package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md

@@ -436,17 +436,17 @@ IMPORTANT: Work through plan.md checklist systematically!
 
 **Step 2: Copy Core Utilities**
 
-Before proceeding, copy these essential files from bmad-core:
+Before proceeding, copy these essential files from common:
 
 ```bash
 # Copy core task utilities
-cp bmad-core/tasks/create-doc.md expansion-packs/{pack-name}/tasks/
-cp bmad-core/tasks/execute-checklist.md expansion-packs/{pack-name}/tasks/
+cp common/tasks/create-doc.md expansion-packs/{pack-name}/tasks/
+cp common/tasks/execute-checklist.md expansion-packs/{pack-name}/tasks/
 
 # Copy core utility files
 mkdir -p expansion-packs/{pack-name}/utils
-cp bmad-core/utils/template-format.md expansion-packs/{pack-name}/utils/
-cp bmad-core/utils/workflow-management.md expansion-packs/{pack-name}/utils/
+cp common/utils/template-format.md expansion-packs/{pack-name}/utils/
+cp common/utils/workflow-management.md expansion-packs/{pack-name}/utils/
 ```
 
 **Step 3: Technical Implementation**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.17.0",
+  "version": "4.18.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "main": "tools/cli.js",
   "bin": {

package/tools/builders/web-builder.js

@@ -9,8 +9,8 @@ class WebBuilder {
     this.resolver = new DependencyResolver(this.rootDir);
     this.templatePath = path.join(
       this.rootDir,
-      "bmad-core",
-      "utils",
+      "tools",
+      "md-assets",
       "web-agent-startup-instructions.md"
     );
   }
@@ -117,35 +117,39 @@ class WebBuilder {
     const yamlContent = yamlMatch[1];
     const yamlStartIndex = content.indexOf(yamlMatch[0]);
     const yamlEndIndex = yamlStartIndex + yamlMatch[0].length;
-    
+
     // Parse YAML and remove root and IDE-FILE-RESOLUTION properties
     try {
       const yaml = require("js-yaml");
       const parsed = yaml.load(yamlContent);
-      
+
       // Remove the properties if they exist at root level
       delete parsed.root;
-      delete parsed['IDE-FILE-RESOLUTION'];
-      delete parsed['REQUEST-RESOLUTION'];
-      
+      delete parsed["IDE-FILE-RESOLUTION"];
+      delete parsed["REQUEST-RESOLUTION"];
+
       // Also remove from activation-instructions if they exist
-      if (parsed['activation-instructions'] && Array.isArray(parsed['activation-instructions'])) {
-        parsed['activation-instructions'] = parsed['activation-instructions'].filter(instruction => {
-          return !instruction.startsWith('IDE-FILE-RESOLUTION:') && 
-                 !instruction.startsWith('REQUEST-RESOLUTION:');
-        });
+      if (parsed["activation-instructions"] && Array.isArray(parsed["activation-instructions"])) {
+        parsed["activation-instructions"] = parsed["activation-instructions"].filter(
+          (instruction) => {
+            return (
+              !instruction.startsWith("IDE-FILE-RESOLUTION:") &&
+              !instruction.startsWith("REQUEST-RESOLUTION:")
+            );
+          }
+        );
       }
-      
+
       // Reconstruct the YAML
       const cleanedYaml = yaml.dump(parsed, { lineWidth: -1 });
-      
+
       // Get the agent name from the YAML for the header
-      const agentName = parsed.agent?.id || 'agent';
-      
+      const agentName = parsed.agent?.id || "agent";
+
       // Build the new content with just the agent header and YAML
       const newHeader = `# ${agentName}\n\nCRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n`;
       const afterYaml = content.substring(yamlEndIndex);
-      
+
       return newHeader + "```yaml\n" + cleanedYaml.trim() + "\n```" + afterYaml;
     } catch (error) {
       console.warn("Failed to process agent YAML:", error.message);
@@ -156,12 +160,12 @@ class WebBuilder {
 
   formatSection(path, content) {
     const separator = "====================";
-    
+
     // Process agent content if this is an agent file
     if (path.startsWith("agents#")) {
       content = this.processAgentContent(content);
     }
-    
+
     return [
       `${separator} START: ${path} ${separator}`,
       content.trim(),
@@ -341,6 +345,28 @@ class WebBuilder {
                   }
                 }
 
+                // If not found in core, try common folder
+                if (!found) {
+                  for (const ext of extensions) {
+                    const commonPath = path.join(
+                      this.rootDir,
+                      "common",
+                      resourceType,
+                      `${resourceName}${ext}`
+                    );
+                    try {
+                      const commonContent = await fs.readFile(commonPath, "utf8");
+                      sections.push(
+                        this.formatSection(`${resourceType}#${resourceName}`, commonContent)
+                      );
+                      found = true;
+                      break;
+                    } catch (error) {
+                      // Not in common either, continue
+                    }
+                  }
+                }
+
                 if (!found) {
                   console.warn(
                     `    ⚠ Dependency ${resourceType}#${resourceName} not found in expansion pack or core`
@@ -516,6 +542,21 @@ class WebBuilder {
         }
       }
 
+      // If not found in core, try common folder
+      if (!found) {
+        for (const ext of extensions) {
+          const commonPath = path.join(this.rootDir, "common", dep.type, `${dep.name}${ext}`);
+          try {
+            const content = await fs.readFile(commonPath, "utf8");
+            sections.push(this.formatSection(key, content));
+            found = true;
+            break;
+          } catch (error) {
+            // Not in common either, continue
+          }
+        }
+      }
+
       if (!found) {
         console.warn(`    ⚠ Dependency ${key} not found in expansion pack or core`);
       }

package/tools/installer/config/install.config.yml

@@ -8,50 +8,6 @@ installation-options:
     name: Single Agent
     description: Select and install a single agent with its dependencies
     action: copy-agent
-agent-dependencies:
-  core-files:
-    - bmad-core/utils/template-format.md
-  dev:
-    - bmad-core/templates/story-tmpl.md
-    - bmad-core/checklists/story-dod-checklist.md
-  pm:
-    - bmad-core/templates/prd-tmpl.md
-    - bmad-core/templates/brownfield-prd-tmpl.md
-    - bmad-core/checklists/pm-checklist.md
-    - bmad-core/checklists/change-checklist.md
-    - bmad-core/tasks/advanced-elicitation.md
-    - bmad-core/tasks/create-doc.md
-    - bmad-core/tasks/correct-course.md
-    - bmad-core/tasks/create-deep-research-prompt.md
-    - bmad-core/tasks/brownfield-create-epic.md
-    - bmad-core/tasks/brownfield-create-story.md
-    - bmad-core/tasks/execute-checklist.md
-    - bmad-core/tasks/shard-doc.md
-  architect:
-    - bmad-core/templates/architecture-tmpl.md
-    - bmad-core/checklists/architect-checklist.md
-  sm:
-    - bmad-core/templates/story-tmpl.md
-    - bmad-core/checklists/story-draft-checklist.md
-    - bmad-core/workflows/*.yml
-  po:
-    - bmad-core/checklists/po-master-checklist.md
-    - bmad-core/templates/acceptance-criteria-tmpl.md
-  analyst:
-    - bmad-core/templates/prd-tmpl.md
-    - bmad-core/tasks/advanced-elicitation.md
-  qa:
-    - bmad-core/checklists/story-dod-checklist.md
-    - bmad-core/templates/test-plan-tmpl.md
-  ux-expert:
-    - bmad-core/templates/ux-tmpl.md
-  bmad-master:
-    - bmad-core/templates/*.md
-    - bmad-core/tasks/*.md
-    - bmad-core/schemas/*.yml
-  bmad-orchestrator:
-    - bmad-core/agent-teams/*.yml
-    - bmad-core/workflows/*.yml
 ide-configurations:
   cursor:
     name: Cursor
@@ -111,44 +67,3 @@ ide-configurations:
       # 2. It also configures .gemini/settings.json to load all agent files.
       # 3. Simply mention the agent in your prompt (e.g., "As @dev, ...").
       # 4. The Gemini CLI will automatically have the context for that agent.
-available-agents:
-  - id: analyst
-    name: Business Analyst
-    file: bmad-core/agents/analyst.md
-    description: Requirements gathering and analysis
-  - id: pm
-    name: Product Manager
-    file: bmad-core/agents/pm.md
-    description: Product strategy and roadmap planning
-  - id: architect
-    name: Solution Architect
-    file: bmad-core/agents/architect.md
-    description: Technical design and architecture
-  - id: po
-    name: Product Owner
-    file: bmad-core/agents/po.md
-    description: Backlog management and prioritization
-  - id: sm
-    name: Scrum Master
-    file: bmad-core/agents/sm.md
-    description: Agile process and story creation
-  - id: dev
-    name: Developer
-    file: bmad-core/agents/dev.md
-    description: Code implementation and testing
-  - id: qa
-    name: QA Engineer
-    file: bmad-core/agents/qa.md
-    description: Quality assurance and testing
-  - id: ux-expert
-    name: UX Expert
-    file: bmad-core/agents/ux-expert.md
-    description: User experience design
-  - id: bmad-master
-    name: BMAD Master
-    file: bmad-core/agents/bmad-master.md
-    description: BMAD framework expert and guide
-  - id: bmad-orchestrator
-    name: BMAD Orchestrator
-    file: bmad-core/agents/bmad-orchestrator.md
-    description: Multi-agent workflow coordinator

package/tools/installer/lib/config-loader.js

@@ -26,8 +26,47 @@ class ConfigLoader {
   }
 
   async getAvailableAgents() {
-    const config = await this.load();
-    return config['available-agents'] || [];
+    const agentsDir = path.join(this.getBmadCorePath(), 'agents');
+    
+    try {
+      const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+      const agents = [];
+      
+      for (const entry of entries) {
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+          const agentPath = path.join(agentsDir, entry.name);
+          const agentId = path.basename(entry.name, '.md');
+          
+          try {
+            const agentContent = await fs.readFile(agentPath, 'utf8');
+            
+            // Extract YAML block from agent file
+            const yamlMatch = agentContent.match(/```yml\n([\s\S]*?)\n```/);
+            if (yamlMatch) {
+              const yamlContent = yaml.load(yamlMatch[1]);
+              const agentConfig = yamlContent.agent || {};
+              
+              agents.push({
+                id: agentId,
+                name: agentConfig.title || agentConfig.name || agentId,
+                file: `bmad-core/agents/${entry.name}`,
+                description: agentConfig.whenToUse || 'No description available'
+              });
+            }
+          } catch (error) {
+            console.warn(`Failed to read agent ${entry.name}: ${error.message}`);
+          }
+        }
+      }
+      
+      // Sort agents by name for consistent display
+      agents.sort((a, b) => a.name.localeCompare(b.name));
+      
+      return agents;
+    } catch (error) {
+      console.warn(`Failed to read agents directory: ${error.message}`);
+      return [];
+    }
   }
 
   async getAvailableExpansionPacks() {
@@ -72,36 +111,24 @@ class ConfigLoader {
     const DependencyResolver = require('../../lib/dependency-resolver');
     const resolver = new DependencyResolver(path.join(__dirname, '..', '..', '..'));
     
-    try {
-      const agentDeps = await resolver.resolveAgentDependencies(agentId);
-      
-      // Convert to flat list of file paths
-      const depPaths = [];
-      
-      // Core files and utilities are included automatically by DependencyResolver
-      
-      // Add agent file itself is already handled by installer
-      
-      // Add all resolved resources
-      for (const resource of agentDeps.resources) {
-        const filePath = `.bmad-core/${resource.type}/${resource.id}.md`;
-        if (!depPaths.includes(filePath)) {
-          depPaths.push(filePath);
-        }
+    const agentDeps = await resolver.resolveAgentDependencies(agentId);
+    
+    // Convert to flat list of file paths
+    const depPaths = [];
+    
+    // Core files and utilities are included automatically by DependencyResolver
+    
+    // Add agent file itself is already handled by installer
+    
+    // Add all resolved resources
+    for (const resource of agentDeps.resources) {
+      const filePath = `.bmad-core/${resource.type}/${resource.id}.md`;
+      if (!depPaths.includes(filePath)) {
+        depPaths.push(filePath);
       }
-      
-      return depPaths;
-    } catch (error) {
-      console.warn(`Failed to dynamically resolve dependencies for ${agentId}: ${error.message}`);
-      
-      // Fall back to static config
-      const config = await this.load();
-      const dependencies = config['agent-dependencies'] || {};
-      const coreFiles = dependencies['core-files'] || [];
-      const agentDeps = dependencies[agentId] || [];
-      
-      return [...coreFiles, ...agentDeps];
     }
+    
+    return depPaths;
   }
 
   async getIdeConfiguration(ide) {