agentvibes 2.1.5 → 2.2.0-beta.1

package/.claude/hooks/bmad-tts-injector.sh

@@ -48,24 +48,29 @@ CYAN='\033[0;36m'
 GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
-# Detect BMAD installation
+# Detect BMAD installation and version
+# Supports both v4 (.bmad-core/) and v6-alpha (bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
-  # Check current directory first
-  if [[ -d ".bmad-core" ]]; then
+  # Check for v6-alpha first (newer version)
+  if [[ -d "bmad" ]]; then
+    bmad_core_dir="bmad"
+  elif [[ -d "../bmad" ]]; then
+    bmad_core_dir="../bmad"
+  # Check for v4 (legacy)
+  elif [[ -d ".bmad-core" ]]; then
     bmad_core_dir=".bmad-core"
-  # Check parent directory
   elif [[ -d "../.bmad-core" ]]; then
     bmad_core_dir="../.bmad-core"
-  # Check for bmad-core (without dot prefix)
+  # Check for bmad-core (without dot prefix, legacy variant)
   elif [[ -d "bmad-core" ]]; then
     bmad_core_dir="bmad-core"
   elif [[ -d "../bmad-core" ]]; then
     bmad_core_dir="../bmad-core"
   else
     echo -e "${RED}❌ BMAD installation not found${NC}" >&2
-    echo -e "${GRAY}   Looked for .bmad-core or bmad-core directory${NC}" >&2
+    echo -e "${GRAY}   Looked for bmad/, .bmad-core/, or bmad-core/ directory${NC}" >&2
     return 1
   fi
 

package/.claude/hooks/bmad-voice-manager.sh

@@ -43,9 +43,61 @@ PLUGIN_DIR=".claude/plugins"
 PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
 ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
 
-# AI NOTE: Auto-enable pattern - When BMAD is detected via .bmad-core/install-manifest.yaml,
+# AI NOTE: Auto-enable pattern - When BMAD is detected via install-manifest.yaml,
 # automatically enable the voice plugin to provide seamless multi-agent voice support.
 # This avoids requiring manual plugin activation after BMAD installation.
+# Supports both BMAD v4 (.bmad-core/) and v6-alpha (bmad/) directory structures.
+
+# @function detect_bmad_version
+# @intent Detect BMAD installation and return version number
+# @why Support both v4 and v6-alpha installations with different directory structures
+# @param None
+# @returns Echoes version number (4, 6, or 0 for not installed) to stdout
+# @exitcode 0=detected, 1=not installed
+# @sideeffects None
+# @edgecases Checks v6 first (newer version), falls back to v4
+# @calledby auto_enable_if_bmad_detected, get_bmad_config_path
+# @calls None
+detect_bmad_version() {
+    if [[ -f "bmad/_cfg/manifest.yaml" ]]; then
+        # v6 detected
+        echo "6"
+        return 0
+    elif [[ -f ".bmad-core/install-manifest.yaml" ]]; then
+        # v4 detected
+        echo "4"
+        return 0
+    else
+        # Not installed
+        echo "0"
+        return 1
+    fi
+}
+
+# @function get_bmad_config_path
+# @intent Get BMAD configuration file path based on detected version
+# @why v4 and v6 use different directory structures for config files
+# @param None
+# @returns Echoes config path to stdout, empty string if not installed
+# @exitcode 0=path returned, 1=not installed
+# @sideeffects None
+# @edgecases Returns empty string if BMAD not detected
+# @calledby Commands that need to read BMAD config (future use)
+# @calls detect_bmad_version
+get_bmad_config_path() {
+    local version=$(detect_bmad_version)
+
+    if [[ "$version" == "6" ]]; then
+        echo "bmad/core/config.yaml"
+        return 0
+    elif [[ "$version" == "4" ]]; then
+        echo ".bmad-core/config.yaml"
+        return 0
+    else
+        echo ""
+        return 1
+    fi
+}
 
 # @function auto_enable_if_bmad_detected
 # @intent Automatically enable BMAD voice plugin when BMAD framework is detected
@@ -56,10 +108,12 @@ ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
 # @sideeffects Creates enabled flag file, creates plugin directory
 # @edgecases Only auto-enables if plugin not already enabled, silent operation
 # @calledby get_agent_voice
-# @calls mkdir, touch
+# @calls mkdir, touch, detect_bmad_version
 auto_enable_if_bmad_detected() {
-    # Check if BMAD is installed
-    if [[ -f ".bmad-core/install-manifest.yaml" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
+    local version=$(detect_bmad_version)
+
+    # Check if BMAD is installed (any version) and plugin not already enabled
+    if [[ "$version" != "0" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
         # BMAD detected but plugin not enabled - enable it silently
         mkdir -p "$PLUGIN_DIR"
         touch "$ENABLED_FLAG"

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.1.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.1.5
 
 ---
 
@@ -92,16 +92,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.1.0 - Streamlined Installation & CI Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.1.0)** 🎉
+**[v2.1.5 - Critical macOS Compatibility Fix + GitHub Actions Testing](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.1.5)** 🍎
 
-**NEW: Automatic Piper Installation!** No more manual steps - when you select Piper TTS, AgentVibes now automatically detects if it's installed and offers to install it for you. Plus streamlined CI workflow improvements!
+**CRITICAL macOS FIX!** All shell scripts now use `#!/usr/bin/env bash` instead of `#!/bin/bash`, enabling AgentVibes to work on macOS. The old shebang forced bash 3.2 (from 2007) which doesn't support associative arrays or modern bash syntax. Plus FREE automated macOS testing on Intel and Apple Silicon Macs!
 
 **Key highlights:**
-- 🚀 **Automatic Piper Installation** - Auto-detects missing Piper binary and prompts to install it during setup
-- ⚡ **One-Command Setup** - Runs `.claude/hooks/piper-installer.sh` seamlessly with human approval
-- 🎯 **Fully Unattended Mode** - Support for `--yes` flag for automated installation
-- 🔧 **CI Workflow Cleanup** - Removed deprecated v1 branch references, tests now run on master only
-- ✅ **110 Tests Passing** - Comprehensive test coverage with optimized GitHub Actions workflow
+- 🍎 **macOS Now Supported** - Fixed all 23 shell scripts to work with Homebrew bash 5.x
+- 🔧 **Voice Switching Works** - No more syntax errors on Mac
+- 🤖 **FREE macOS Testing** - GitHub Actions tests on macOS 13/14/15 (Intel + M1/M2/M3)
+- 🚀 **Automated CI** - 13 parallel test jobs on every commit
+- ✅ **All Features Work** - Personalities, providers, speed control now functional on Mac
 
 [→ View Full Release Notes](RELEASE_NOTES.md) | [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 
@@ -137,6 +137,17 @@ Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands
 
 ## 🚀 Quick Start
 
+### 🍎 macOS Users - Read This First!
+
+**REQUIRED:** Install bash 5.x before using AgentVibes:
+```bash
+brew install bash  # One-time setup
+```
+
+macOS ships with bash 3.2 (from 2007) which lacks modern bash features AgentVibes needs. After installing bash 5.x via Homebrew, everything works perfectly!
+
+---
+
 Get AgentVibes running in 3 steps: **Install** → **Choose Provider** (Piper/ElevenLabs) → **Enable Voice**
 
 **[→ View Complete Quick Start Guide](docs/quick-start.md)** - Full installation options, provider setup, and activation steps
@@ -225,6 +236,8 @@ AgentVibes includes **27 unique ElevenLabs voices** with multilingual support.
 
 The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`) and automatically uses the assigned voice for that role.
 
+**Version Support**: AgentVibes supports both BMAD v4 and v6-alpha installations. Version detection is automatic - just install BMAD and AgentVibes will detect and configure itself correctly!
+
 **[→ View Complete BMAD Documentation](docs/bmad-plugin.md)** - All agent mappings, language support, plugin management, and customization
 
 [↑ Back to top](#-table-of-contents)

package/docs/bmad-plugin.md

@@ -38,9 +38,36 @@ The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`)
 /agent-vibes-bmad edit
 ```
 
+## 🔄 BMAD Version Support
+
+AgentVibes automatically detects and supports both BMAD v4 and v6-alpha:
+
+- **v4 (Legacy)**: Uses `.bmad-core/` directory structure
+- **v6-alpha (Current)**: Uses unified `bmad/` directory structure
+
+The plugin automatically detects which version you have installed and configures paths accordingly. **No manual configuration needed!**
+
+### How Detection Works
+
+1. Checks for `bmad/_cfg/manifest.yaml` (v6)
+2. Falls back to `.bmad-core/install-manifest.yaml` (v4)
+3. Resolves configuration paths based on detected version
+
+### Upgrading from v4 to v6
+
+If you upgrade BMAD from v4 to v6-alpha:
+
+1. Reinstall AgentVibes: `npx agentvibes update --yes`
+2. AgentVibes will auto-detect the new v6 structure
+3. All voice mappings will continue working
+
+**No manual intervention required!**
+
+For detailed version support information, see [BMAD v6 Support Documentation](bmad-v6-support.md).
+
 ## How It Works
 
-1. **Auto-Detection**: Plugin checks for `.bmad-core/install-manifest.yaml`
+1. **Auto-Detection**: Plugin checks for BMAD installation (both v4 and v6)
 2. **Auto-Enable**: Enables automatically when BMAD is detected
 3. **Settings Preservation**: Saves your previous voice/personality when enabling
 4. **Restore on Disable**: Restores previous settings when disabling

package/docs/bmad-v6-support.md

@@ -0,0 +1,228 @@
+# BMAD-METHOD v6-Alpha Support
+
+## Overview
+
+AgentVibes now supports both **BMAD-METHOD v4** and **v6-alpha** installations, providing seamless backward compatibility while embracing the new architecture.
+
+## Version Differences
+
+### BMAD v4 (Legacy)
+- **Directory Structure**: Multiple `.bmad-*` directories (`.bmad-core/`, `.bmad-game-dev/`, etc.)
+- **Manifest Location**: `.bmad-core/install-manifest.yaml`
+- **Config Location**: `.bmad-core/config.yaml`
+- **Status**: Fully supported (backward compatible)
+
+### BMAD v6-Alpha (Current)
+- **Directory Structure**: Unified `bmad/` directory with central manifest
+- **Manifest Location**: `bmad/_cfg/manifest.yaml`
+- **Config Location**: `bmad/core/config.yaml`
+- **Features**: Central manifest system, improved organization
+- **Status**: Fully supported
+
+## Automatic Detection
+
+AgentVibes automatically detects which version you have installed:
+
+```bash
+# During installation
+npx agentvibes install
+
+# Output for v6-alpha:
+🎉 BMAD-METHOD v6 (6.0.0-alpha.x) detected!
+   Location: /path/to/bmad
+
+# Output for v4:
+🎉 BMAD-METHOD v4 detected!
+   Location: /path/to/.bmad-core
+```
+
+### Detection Priority
+
+1. **v6-alpha** is checked first (newer version)
+2. **v4** is checked as fallback (legacy version)
+3. If neither is found, BMAD plugin is not enabled
+
+## How It Works
+
+### JavaScript Detection (`src/bmad-detector.js`)
+
+The detector module checks for version-specific markers:
+
+```javascript
+// v6 check
+const v6Manifest = path.join(targetDir, 'bmad/_cfg/manifest.yaml');
+
+// v4 check
+const v4Manifest = path.join(targetDir, '.bmad-core/install-manifest.yaml');
+```
+
+### Bash Detection (`.claude/hooks/bmad-voice-manager.sh`)
+
+Shell scripts include version detection functions:
+
+```bash
+detect_bmad_version() {
+    if [[ -f "bmad/_cfg/manifest.yaml" ]]; then
+        echo "6"  # v6 detected
+    elif [[ -f ".bmad-core/install-manifest.yaml" ]]; then
+        echo "4"  # v4 detected
+    else
+        echo "0"  # Not installed
+    fi
+}
+```
+
+## Configuration Paths
+
+The system resolves configuration paths based on detected version:
+
+| Version | Config Path | Manifest Path |
+|---------|-------------|---------------|
+| v4 | `.bmad-core/config.yaml` | `.bmad-core/install-manifest.yaml` |
+| v6-alpha | `bmad/core/config.yaml` | `bmad/_cfg/manifest.yaml` |
+
+## Upgrading from v4 to v6-Alpha
+
+If you upgrade BMAD from v4 to v6-alpha:
+
+1. **Upgrade BMAD** following the BMAD-METHOD upgrade instructions
+2. **Reinstall AgentVibes**:
+   ```bash
+   npx agentvibes update --yes
+   ```
+3. AgentVibes will automatically detect the new v6 structure
+4. All voice mappings will continue working
+
+**No manual configuration needed!**
+
+## Voice Plugin Compatibility
+
+The BMAD voice plugin works identically on both versions:
+
+- **Auto-Detection**: Plugin auto-enables when BMAD is detected (any version)
+- **Voice Mappings**: Same voice mapping format for both versions
+- **Agent Context**: Same `.bmad-agent-context` file mechanism
+- **Commands**: Same `/agent-vibes:bmad` commands work on both
+
+## Testing Your Installation
+
+After installing or updating AgentVibes, verify BMAD detection:
+
+```bash
+# Check which version is detected
+ls -la | grep bmad
+
+# You should see either:
+# - bmad/           (v6-alpha)
+# - .bmad-core/     (v4)
+
+# Verify plugin is enabled
+ls -la .claude/plugins/bmad-voices-enabled.flag
+
+# Check activation instructions
+cat .claude/activation-instructions
+```
+
+The activation instructions will show the correct version:
+
+```markdown
+# BMAD Agent Activation Instructions (v6)  ← or (v4)
+
+**Configuration Location**: bmad/core/config.yaml  ← or .bmad-core/config.yaml
+```
+
+## Troubleshooting
+
+### "BMAD not detected" but I have BMAD installed
+
+**Check directory structure**:
+```bash
+# For v6-alpha, verify:
+ls -la bmad/_cfg/manifest.yaml
+
+# For v4, verify:
+ls -la .bmad-core/install-manifest.yaml
+```
+
+### Plugin works on v4 but not v6-alpha
+
+1. **Verify v6 installation**:
+   ```bash
+   cat bmad/_cfg/manifest.yaml
+   ```
+
+2. **Reinstall AgentVibes**:
+   ```bash
+   npx agentvibes update --yes
+   ```
+
+3. **Check detection**:
+   ```bash
+   node -e "import('./src/bmad-detector.js').then(m => m.detectBMAD(process.cwd()).then(console.log))"
+   ```
+
+### Wrong version detected
+
+AgentVibes prioritizes v6 over v4. If both exist in your directory:
+
+- **v6** will be detected (correct behavior)
+- Remove old `.bmad-core/` if you've migrated to v6
+
+## Technical Details
+
+### Version Detection Algorithm
+
+```javascript
+export async function detectBMAD(targetDir) {
+  // 1. Check v6 (newest)
+  const v6Manifest = path.join(targetDir, 'bmad/_cfg/manifest.yaml');
+  if (await fileExists(v6Manifest)) {
+    return { version: 6, ... };
+  }
+
+  // 2. Check v4 (legacy)
+  const v4Manifest = path.join(targetDir, '.bmad-core/install-manifest.yaml');
+  if (await fileExists(v4Manifest)) {
+    return { version: 4, ... };
+  }
+
+  // 3. Not installed
+  return { version: null, installed: false };
+}
+```
+
+### Configuration Resolution
+
+```javascript
+// Dynamically resolved based on version
+const configPath = detection.version === 6
+  ? 'bmad/core/config.yaml'
+  : '.bmad-core/config.yaml';
+```
+
+## Benefits
+
+✅ **Future-Proof**: Ready for BMAD v6 general release
+✅ **Zero Breaking Changes**: Existing v4 users unaffected
+✅ **Clean Architecture**: Centralized version detection
+✅ **User-Friendly**: Auto-detects and configures correctly
+✅ **Easy Maintenance**: Single codebase, version-aware logic
+
+## Related Documentation
+
+- [BMAD Plugin Guide](bmad-plugin.md)
+- [Installation Guide](../README.md)
+- [BMAD-METHOD Repository](https://github.com/bmad-code-org/BMAD-METHOD)
+
+## Support
+
+If you encounter issues with version detection:
+
+1. Check this documentation
+2. Verify your BMAD installation
+3. Report issues: https://github.com/paulpreibisch/AgentVibes/issues
+
+Include in your report:
+- AgentVibes version: `npx agentvibes --version`
+- BMAD version and directory structure
+- Output of `ls -la | grep bmad`

package/docs/quick-start.md

@@ -2,6 +2,23 @@
 
 Get AgentVibes up and running in 3 simple steps!
 
+## 🍎 macOS Users - Important Prerequisite
+
+**REQUIRED:** macOS ships with bash 3.2 (from 2007) which is incompatible with AgentVibes. Install bash 5.x first:
+
+```bash
+# One-time setup
+brew install bash
+
+# Verify installation
+bash --version
+# Should show: GNU bash, version 5.x
+```
+
+**Why?** AgentVibes uses modern bash features (associative arrays, advanced string manipulation) that aren't available in bash 3.2. The `#!/usr/bin/env bash` shebang in our scripts will automatically use Homebrew's bash 5.x once installed.
+
+---
+
 ## Step 1: Install AgentVibes
 
 Choose your preferred installation method:

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.1.5",
+  "version": "2.2.0-beta.1",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [
@@ -43,6 +43,7 @@
     "commander": "^10.0.0",
     "figlet": "^1.6.0",
     "inquirer": "^12.0.0",
+    "js-yaml": "^4.1.0",
     "ora": "^6.0.0"
   },
   "engines": {

package/src/bmad-detector.js

@@ -0,0 +1,53 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import yaml from 'js-yaml';
+
+/**
+ * Detect BMAD installation and version
+ * @param {string} targetDir - Directory to check
+ * @returns {Promise<Object>} Detection result with version info
+ */
+export async function detectBMAD(targetDir) {
+  // Check v6 first (newer version)
+  const v6Manifest = path.join(targetDir, 'bmad/_cfg/manifest.yaml');
+  try {
+    await fs.access(v6Manifest);
+    const manifestContent = await fs.readFile(v6Manifest, 'utf8');
+    const manifest = yaml.load(manifestContent);
+
+    return {
+      version: 6,
+      detailedVersion: manifest.installation?.version || '6.0.0-alpha.x',
+      manifestPath: v6Manifest,
+      configPath: path.join(targetDir, 'bmad/core/config.yaml'),
+      bmadPath: path.join(targetDir, 'bmad'),
+      installed: true
+    };
+  } catch {}
+
+  // Check v4 (legacy)
+  const v4Manifest = path.join(targetDir, '.bmad-core/install-manifest.yaml');
+  try {
+    await fs.access(v4Manifest);
+    return {
+      version: 4,
+      detailedVersion: '4.x',
+      manifestPath: v4Manifest,
+      configPath: path.join(targetDir, '.bmad-core/config.yaml'),
+      bmadPath: path.join(targetDir, '.bmad-core'),
+      installed: true
+    };
+  } catch {}
+
+  // Not installed
+  return { version: null, installed: false };
+}
+
+/**
+ * Get BMAD configuration file path for detected version
+ * @param {Object} detection - Result from detectBMAD()
+ * @returns {string|null} Path to config.yaml or null
+ */
+export function getBMADConfigPath(detection) {
+  return detection.installed ? detection.configPath : null;
+}

package/src/installer.js

@@ -47,6 +47,7 @@ import fs from 'node:fs/promises';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import figlet from 'figlet';
+import { detectBMAD } from './bmad-detector.js';
 import boxen from 'boxen';
 import ora from 'ora';
 import { fileURLToPath } from 'node:url';
@@ -103,6 +104,75 @@ function showWelcome() {
   );
 }
 
+/**
+ * Generate BMAD activation instructions based on version
+ * @param {number} version - BMAD version (4 or 6)
+ * @returns {string} Activation instructions content
+ */
+function generateActivationInstructions(version) {
+  const configPathExample = version === 6
+    ? 'bmad/core/config.yaml'
+    : '.bmad-core/config.yaml';
+
+  return `# BMAD Agent Activation Instructions (v${version})
+
+When a BMAD agent activates, follow these steps EXACTLY:
+
+## STEP 3.5a: Create BMAD Context File (CRITICAL)
+
+**IMMEDIATELY after agent identification, create the context file:**
+
+\`\`\`bash
+echo "$AGENT_ID" > .bmad-agent-context
+\`\`\`
+
+Where \`$AGENT_ID\` is one of:
+- \`pm\` (Product Manager)
+- \`dev\` (Developer)
+- \`qa\` (QA)
+- \`architect\` (Architect)
+- \`po\` (Product Owner)
+- \`analyst\` (Analyst)
+- \`sm\` (Scrum Master)
+- \`ux-expert\` (UX Expert)
+- \`bmad-master\` (BMAD Master)
+- \`bmad-orchestrator\` (Orchestrator)
+
+**Example:**
+\`\`\`bash
+# For Product Manager agent
+echo "pm" > .bmad-agent-context
+\`\`\`
+
+**Configuration Location**: ${configPathExample}
+
+This file allows AgentVibes to:
+1. Detect which BMAD agent is active
+2. Look up the correct voice mapping
+3. Automatically speak questions using the agent's assigned voice
+
+## STEP 10: Clean Up on Exit
+
+**Before exiting the agent, remove the context file:**
+
+\`\`\`bash
+rm -f .bmad-agent-context
+\`\`\`
+
+This ensures voice switching only happens when an agent is active.
+
+## Why This Matters
+
+Without the \`.bmad-agent-context\` file:
+- AgentVibes cannot detect which agent is active
+- Questions won't be spoken automatically
+- Voice switching won't work
+- The BMAD voice plugin becomes non-functional
+
+**This is MANDATORY for BMAD voice integration to work!**
+`;
+}
+
 // Installation function
 async function install(options = {}) {
   showWelcome();
@@ -794,16 +864,19 @@ async function install(options = {}) {
       )
     );
 
-    // Check for BMAD installation
-    const bmadManifestPath = path.join(targetDir, '.bmad-core', 'install-manifest.yaml');
-    let bmadDetected = false;
-    try {
-      await fs.access(bmadManifestPath);
-      bmadDetected = true;
-    } catch {}
+    // Check for BMAD installation (both v4 and v6)
+    const bmadDetection = await detectBMAD(targetDir);
+    const bmadDetected = bmadDetection.installed;
 
     // Auto-enable BMAD plugin and create activation-instructions if BMAD detected
     if (bmadDetected) {
+      const versionLabel = bmadDetection.version === 6
+        ? `v6 (${bmadDetection.detailedVersion})`
+        : 'v4';
+
+      console.log(chalk.green(`\n🎉 BMAD-METHOD ${versionLabel} detected!`));
+      console.log(chalk.gray(`   Location: ${bmadDetection.bmadPath}`));
+
       const pluginsDir = path.join(claudeDir, 'plugins');
       const enabledFlagPath = path.join(pluginsDir, 'bmad-voices-enabled.flag');
       const activationInstructionsPath = path.join(claudeDir, 'activation-instructions');
@@ -817,71 +890,21 @@ async function install(options = {}) {
       try {
         await fs.access(activationInstructionsPath);
       } catch {
-        // File doesn't exist - create it
-        const activationContent = `# BMAD Agent Activation Instructions
-
-When a BMAD agent activates, follow these steps EXACTLY:
-
-## STEP 3.5a: Create BMAD Context File (CRITICAL)
-
-**IMMEDIATELY after agent identification, create the context file:**
-
-\`\`\`bash
-echo "$AGENT_ID" > .bmad-agent-context
-\`\`\`
-
-Where \`$AGENT_ID\` is one of:
-- \`pm\` (Product Manager)
-- \`dev\` (Developer)
-- \`qa\` (QA)
-- \`architect\` (Architect)
-- \`po\` (Product Owner)
-- \`analyst\` (Analyst)
-- \`sm\` (Scrum Master)
-- \`ux-expert\` (UX Expert)
-- \`bmad-master\` (BMAD Master)
-- \`bmad-orchestrator\` (Orchestrator)
-
-**Example:**
-\`\`\`bash
-# For Product Manager agent
-echo "pm" > .bmad-agent-context
-\`\`\`
-
-This file allows AgentVibes to:
-1. Detect which BMAD agent is active
-2. Look up the correct voice mapping
-3. Automatically speak questions using the agent's assigned voice
-
-## STEP 10: Clean Up on Exit
-
-**Before exiting the agent, remove the context file:**
-
-\`\`\`bash
-rm -f .bmad-agent-context
-\`\`\`
-
-This ensures voice switching only happens when an agent is active.
-
-## Why This Matters
-
-Without the \`.bmad-agent-context\` file:
-- AgentVibes cannot detect which agent is active
-- Questions won't be spoken automatically
-- Voice switching won't work
-- The BMAD voice plugin becomes non-functional
-
-**This is MANDATORY for BMAD voice integration to work!**
-`;
+        // File doesn't exist - create it with version-specific instructions
+        const activationContent = generateActivationInstructions(bmadDetection.version);
         await fs.writeFile(activationInstructionsPath, activationContent);
         console.log(chalk.green('📝 Created BMAD activation instructions'));
       }
     }
 
     if (bmadDetected) {
+      const versionLabel = bmadDetection.version === 6
+        ? `v${bmadDetection.detailedVersion}`
+        : 'v4';
+
       console.log(
         boxen(
-          chalk.green.bold('🎉 BMAD Detected!\n\n') +
+          chalk.green.bold(`🎉 BMAD-METHOD ${versionLabel} Detected!\n\n`) +
           chalk.white('✅ BMAD Voice Plugin: AUTO-ENABLED\n') +
           chalk.gray('Each BMAD agent will automatically use its assigned voice\n') +
           chalk.gray('and speak when activated!\n\n') +