.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: Discord Community Support
-    url: https://discord.gg/gk8jAdXWmj
-    about: Please join our Discord server for general questions and community discussion before opening an issue.

.github/workflows/manual-release.yaml

@@ -26,7 +26,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          token: ${{ secrets.GH_PAT }}
+          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4

README.md

@@ -1,36 +1,5 @@
 # BMAD-METHOD™: Universal AI Agent Framework
 
-> ## 🚨 **IMPORTANT VERSION ANNOUNCEMENT** 🚨
->
-> ### Current Stable: v4.x | Next Major: v6 Alpha
->
-> - **v4.x** - The current stable release version available via npm
-> - **v5** - Skipped (replaced by v6)
-> - **[v6-alpha](https://github.com/bmad-code-org/BMAD-METHOD/tree/v6-alpha)** - **NOW AVAILABLE FOR EARLY TESTING!**
->
-> ### 🧪 Try v6 Alpha (Early Adopters Only)
->
-> The next major version of BMAD-METHOD is now available for early experimentation and testing. This is a complete rewrite with significant architectural changes.
->
-> **⚠️ WARNING: v6-alpha is for early adopters who are comfortable with:**
->
-> - Potential breaking changes
-> - Daily updates and instability
-> - Incomplete features
-> - Experimental functionality
->
-> **📅 Timeline:** Official beta version will be merged mid-October 2025
->
-> **To try v6-alpha:**
->
-> ```bash
-> git clone https://github.com/bmad-code-org/BMAD-METHOD.git
-> cd BMAD-METHOD
-> git checkout v6-alpha
-> ```
->
-> ---
-
 [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)

bmad-core/checklists/po-master-checklist.md

@@ -15,7 +15,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -33,8 +33,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

bmad-core/templates/brownfield-architecture-tmpl.yaml

@@ -23,7 +23,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 

dist/agents/architect.txt

@@ -1608,7 +1608,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 

dist/agents/bmad-master.txt

@@ -2817,7 +2817,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 
@@ -7114,7 +7114,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -7132,8 +7132,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

dist/agents/po.txt

@@ -933,7 +933,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -951,8 +951,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

dist/teams/team-all.txt

@@ -4528,7 +4528,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 
@@ -8654,7 +8654,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8672,8 +8672,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

dist/teams/team-fullstack.txt

@@ -6407,7 +6407,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 
@@ -8648,7 +8648,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8666,8 +8666,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

dist/teams/team-ide-minimal.txt

@@ -2588,7 +2588,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -2606,8 +2606,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

dist/teams/team-no-ui.txt

@@ -5945,7 +5945,7 @@ sections:
       1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
 
       2. **REQUIRED INPUTS**:
-         - Completed prd.md
+         - Completed brownfield-prd.md
          - Existing project technical documentation (from docs folder or user-provided)
          - Access to existing project structure (IDE or uploaded files)
 
@@ -8186,7 +8186,7 @@ First, determine the project type by checking:
 
 2. Is this a BROWNFIELD project (enhancing existing system)?
    - Look for: References to existing codebase, enhancement/modification language
-   - Check for: prd.md, architecture.md, existing system analysis
+   - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
 
 3. Does the project include UI/UX components?
    - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8204,8 +8204,8 @@ For GREENFIELD projects:
 
 For BROWNFIELD projects:
 
-- prd.md - The brownfield enhancement requirements
+- brownfield-prd.md - The brownfield enhancement requirements
-- architecture.md - The enhancement architecture
+- brownfield-architecture.md - The enhancement architecture
 - Existing project codebase access (CRITICAL - cannot proceed without this)
 - Current deployment configuration and infrastructure details
 - Database schemas, API documentation, monitoring setup

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "4.44.0",
+  "version": "4.43.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",

tools/installer/config/install.config.yaml

@@ -132,15 +132,15 @@ ide-configurations:
 
   qwen-code:
     name: Qwen Code
-    rule-dir: .qwen/commands/BMad/
+    rule-dir: .qwen/bmad-method/
-    format: multi-file
+    format: single-file
-    command-suffix: .toml
+    command-suffix: .md
     instructions: |
       # To use BMad agents with Qwen Code:
-      # 1. The installer creates a `BMad` folder in `.qwen/commands`.
+      # 1. The installer creates a .qwen/bmad-method/ directory in your project.
-      # 2. This adds custom commands for each agent and task.
+      # 2. It concatenates all agent files into a single QWEN.md file.
-      # 3. Type /BMad:agents:<agent-name> (e.g., "/BMad:agents:dev", "/BMad:agents:pm") or /BMad:tasks:<task-name> (e.g., "/BMad:tasks:create-doc").
+      # 3. Simply mention the agent in your prompt (e.g., "As *dev, ...").
-      # 4. The agent will adopt that persona for the conversation or perform the task.
+      # 4. The Qwen Code CLI will automatically have the context for that agent.
 
   auggie-cli:
     name: Auggie CLI (Augment Code)

tools/installer/lib/ide-setup.js

@@ -2184,86 +2184,94 @@ CRITICAL: You are to execute the BMad Task defined below.
   }
 
   async setupQwenCode(installDir, selectedAgent) {
-    const ideConfig = await configLoader.getIdeConfiguration('qwen-code');
+    const qwenDir = path.join(installDir, '.qwen');
-    const bmadCommandsDir = path.join(installDir, ideConfig['rule-dir']);
+    const bmadMethodDir = path.join(qwenDir, 'bmad-method');
+    await fileManager.ensureDirectory(bmadMethodDir);
 
-    const agentCommandsDir = path.join(bmadCommandsDir, 'agents');
+    // Update logic for existing settings.json
-    const taskCommandsDir = path.join(bmadCommandsDir, 'tasks');
+    const settingsPath = path.join(qwenDir, 'settings.json');
-    await fileManager.ensureDirectory(agentCommandsDir);
+    if (await fileManager.pathExists(settingsPath)) {
-    await fileManager.ensureDirectory(taskCommandsDir);
+      try {
+        const settingsContent = await fileManager.readFile(settingsPath);
+        const settings = JSON.parse(settingsContent);
+        let updated = false;
 
-    // Process Agents
+        // Handle contextFileName property
+        if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
+          const originalLength = settings.contextFileName.length;
+          settings.contextFileName = settings.contextFileName.filter(
+            (fileName) => !fileName.startsWith('agents/'),
+          );
+          if (settings.contextFileName.length !== originalLength) {
+            updated = true;
+          }
+        }
+
+        if (updated) {
+          await fileManager.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+          console.log(chalk.green('✓ Updated .qwen/settings.json - removed agent file references'));
+        }
+      } catch (error) {
+        console.warn(chalk.yellow('Could not update .qwen/settings.json'), error);
+      }
+    }
+
+    // Remove old agents directory
+    const agentsDir = path.join(qwenDir, 'agents');
+    if (await fileManager.pathExists(agentsDir)) {
+      await fileManager.removeDirectory(agentsDir);
+      console.log(chalk.green('✓ Removed old .qwen/agents directory'));
+    }
+
+    // Get all available agents
     const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    let concatenatedContent = '';
+
     for (const agentId of agents) {
+      // Find the source agent file
       const agentPath = await this.findAgentPath(agentId, installDir);
-      if (!agentPath) {
+
-        console.log(chalk.yellow(`✗ Agent file not found for ${agentId}, skipping.`));
+      if (agentPath) {
-        continue;
+        const agentContent = await fileManager.readFile(agentPath);
+
+        // Create properly formatted agent rule content (similar to gemini)
+        let agentRuleContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
+        agentRuleContent += `This rule is triggered when the user types \`*${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} agent persona.\n\n`;
+        agentRuleContent += '## Agent Activation\n\n';
+        agentRuleContent +=
+          'CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n';
+        agentRuleContent += '```yaml\n';
+        // Extract just the YAML content from the agent file
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          agentRuleContent += yamlContent;
+        } else {
+          // If no YAML found, include the whole content minus the header
+          agentRuleContent += agentContent.replace(/^#.*$/m, '').trim();
+        }
+        agentRuleContent += '\n```\n\n';
+        agentRuleContent += '## File Reference\n\n';
+        const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+        agentRuleContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
+        agentRuleContent += '## Usage\n\n';
+        agentRuleContent += `When the user types \`*${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+
+        // Add to concatenated content with separator
+        concatenatedContent += agentRuleContent + '\n\n---\n\n';
+        console.log(chalk.green(`✓ Added context for *${agentId}`));
       }
-
-      const agentTitle = await this.getAgentTitle(agentId, installDir);
-      const commandPath = path.join(agentCommandsDir, `${agentId}.toml`);
-
-      // Get relative path from installDir to agent file for @{file} reference
-      const relativeAgentPath = path.relative(installDir, agentPath).replaceAll('\\', '/');
-
-      // Read the agent content
-      const agentContent = await fileManager.readFile(agentPath);
-
-      const tomlContent = `description = " Activates the ${agentTitle} agent from the BMad Method."
-prompt = """
-CRITICAL: You are now the BMad '${agentTitle}' agent. Adopt its persona, follow its instructions, and use its capabilities. 
-
-READ THIS BEFORE ANSWERING AS THE PERSONA!
-
-${agentContent}
-"""`;
-
-      await fileManager.writeFile(commandPath, tomlContent);
-      console.log(chalk.green(`✓ Created agent command: /bmad:agents:${agentId}`));
     }
 
-    // Process Tasks
+    // Write the concatenated content to QWEN.md
-    const tasks = await this.getAllTaskIds(installDir);
+    const qwenMdPath = path.join(bmadMethodDir, 'QWEN.md');
-    for (const taskId of tasks) {
+    await fileManager.writeFile(qwenMdPath, concatenatedContent);
-      const taskPath = await this.findTaskPath(taskId, installDir);
+    console.log(chalk.green(`\n✓ Created QWEN.md in ${bmadMethodDir}`));
-      if (!taskPath) {
-        console.log(chalk.yellow(`✗ Task file not found for ${taskId}, skipping.`));
-        continue;
-      }
-
-      const taskTitle = taskId
-        .split('-')
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(' ');
-      const commandPath = path.join(taskCommandsDir, `${taskId}.toml`);
-
-      // Get relative path from installDir to task file for @{file} reference
-      const relativeTaskPath = path.relative(installDir, taskPath).replaceAll('\\', '/');
-
-      // Read the task content
-      const taskContent = await fileManager.readFile(taskPath);
-
-      const tomlContent = `description = " Executes the BMad Task: ${taskTitle}"
-prompt = """
-CRITICAL: You are to execute the BMad Task defined below.
-
-READ THIS BEFORE EXECUTING THE TASK AS THE INSTRUCTIONS SPECIFIED!
-
-${taskContent}
-"""`;
-
-      await fileManager.writeFile(commandPath, tomlContent);
-      console.log(chalk.green(`✓ Created task command: /bmad:tasks:${taskId}`));
-    }
-
-    console.log(
-      chalk.green(`
-✓ Created Qwen Code extension in ${bmadCommandsDir}`),
-    );
-    console.log(
-      chalk.dim('You can now use commands like /bmad:agents:dev or /bmad:tasks:create-doc.'),
-    );
 
     return true;
   }