agentvibes 2.9.4 → 2.9.5

package/.bmad/_cfg/agent-voice-map.csv

@@ -0,0 +1,11 @@
+agent_id,voice_name
+pm,en_US-ryan-high
+architect,en_US-danny-low
+dev,en_US-hfc_female-medium
+analyst,en_US-amy-medium
+ux-designer,en_US-kristin-medium
+tea,en_US-kusal-medium
+sm,en_US-bryce-medium
+tech-writer,en_US-kathleen-low
+frame-expert,en_US-kusal-medium
+bmad-master,en_US-libritts_r-high

package/.bmad/core/workflows/party-mode/instructions.md

@@ -25,8 +25,7 @@
 </step>
 
 <step n="2" goal="Initialize Party Mode">
-  <action>Announce party mode activation with enthusiasm</action>
-  <note>If using TTS for announcement, use PROJECT hook: .claude/hooks/play-tts.sh (NOT ~/.claude/hooks/)</note>
+  <action>Trigger TTS announcement using PROJECT hook: .claude/hooks/play-tts.sh "Party mode activated! All agents are here for a group discussion!"</action>
   <action>List all participating agents with their merged information:</action>
   <format>
     🎉 PARTY MODE ACTIVATED! 🎉

package/.claude/hooks/piper-download-voices.sh

@@ -51,10 +51,16 @@ fi
 
 # Common voice models to download
 COMMON_VOICES=(
-  "en_US-lessac-medium"      # Default, clear male (13MB)
-  "en_US-amy-medium"         # Warm female (13MB)
-  "en_US-joe-medium"         # Professional male (13MB)
-  "en_US-ryan-high"          # Expressive male (30MB)
+  "en_US-ryan-high"          # Default, expressive male (30MB) - BMAD: John (pm)
+  "en_US-amy-medium"         # Warm female (13MB) - BMAD: Mary (analyst)
+  "en_US-hfc_female-medium"  # Professional female (13MB) - BMAD: Amelia (dev)
+  "en_US-lessac-medium"      # Clear female (13MB) - BMAD: Murat (tea) - NOTE: Female voice
+  "en_US-danny-low"          # Calm male (13MB) - BMAD: Winston (architect)
+  "en_US-bryce-medium"       # Professional male (13MB) - BMAD: Bob (sm)
+  "en_US-kathleen-low"       # Clear female (13MB) - BMAD: Paige (tech-writer)
+  "en_US-kusal-medium"       # Male voice (13MB) - BMAD: Saif (frame-expert)
+  "en_US-kristin-medium"     # Female voice (13MB) - BMAD: Sally (ux-designer)
+  "en_US-libritts_r-high"    # Premium male (57MB) - BMAD: BMad Master
   "en_US-libritts-high"      # Premium quality (57MB)
   "16Speakers"               # Multi-speaker: 12 US + 4 UK voices (77MB) - REQUIRED for BMAD agents
 )

package/.claude/output-styles/agent-vibes.md

@@ -133,8 +133,8 @@ You: "✅ That bug be walkin' the plank now, arr!"
 When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
 
 1. **Detect BMAD agent from command/context**
-2. **Check if BMAD plugin is enabled** (`.claude/config/bmad-voices-enabled.flag`)
-3. **Look up voice mapping** from `.claude/config/bmad-voices.md`
+2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
+3. **Look up voice mapping** from `.claude/plugins/bmad-voices.md`
 4. **Apply agent's assigned voice** for all TTS acknowledgments/completions
 5. **Apply agent's personality** from the mapping (if specified)
 
@@ -153,7 +153,7 @@ fi
 # Note: This detection happens automatically when BMAD agent activates
 
 # If BMAD agent detected and plugin enabled, use mapped voice
-if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/config/bmad-voices-enabled.flag" ]]; then
+if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
     MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
     MAPPED_PERSONALITY=$(.claude/hooks/bmad-voice-manager.sh get-personality "$BMAD_AGENT_ID")
 

package/.test-bmad-config

@@ -1,2 +1,2 @@
-SAVED_FORK="https://github.com/paulpreibisch/BMAD-METHOD"
-SAVED_TEST_DIR="/home/fire/claude/tests/test42"
+SAVED_MODE="1"
+SAVED_TEST_DIR="/home/fire/claude/tests/test44"

package/BMAD_PR_TESTING_INSTRUCTIONS.md

@@ -3,69 +3,143 @@
 ## Prerequisites
 - Node.js and npm installed
 - Git installed
-- Fresh terminal session
+- ~500MB free disk space
+- 10-15 minutes for complete setup
 
-## Quick Test (5-10 minutes)
+## 🚀 Automated Testing (Easiest!)
+
+We've made testing super simple with a single command:
+
+### One-Line Install
 
-### Step 1: Fork and Clone BMAD
 ```bash
-# Fork the BMAD repo on GitHub first, then:
-git clone https://github.com/YOUR-USERNAME/BMAD-METHOD.git
-cd BMAD-METHOD
+npx agentvibes@latest test-bmad-pr
 ```
 
-### Step 2: Merge the PR Branch
+That's it! This command will automatically:
+- Download the test script
+- Clone BMAD with the PR
+- Install everything you need
+- Set up unique voices for each agent
+- Verify the installation
+
+### Testing a Different PR
+
 ```bash
-# Add the upstream remote
-git remote add upstream https://github.com/bmad-code-org/BMAD-METHOD.git
+npx agentvibes@latest test-bmad-pr <PR_NUMBER>
+```
 
-# Fetch and merge the PR
-git fetch upstream pull/934/head:agentvibes-party-mode
-git checkout agentvibes-party-mode
+For example:
+```bash
+npx agentvibes@latest test-bmad-pr 935
+```
+
+### Alternative: Manual Download
+
+If you prefer to download the script first:
+
+```bash
+# Download and run the test script
+curl -sSL https://raw.githubusercontent.com/paulpreibisch/BMAD-METHOD/feature/agentvibes-tts-integration/test-bmad-pr.sh -o test-bmad-pr.sh
+chmod +x test-bmad-pr.sh
+./test-bmad-pr.sh
 ```
 
-### Step 3: Install BMAD from Your Fork
+### What the Script Does
+
+The script provides an **interactive menu** that lets you choose:
+
+1. **Test official BMAD PR #934** (recommended for most users)
+   - Automatically fetches the PR from the main BMAD repository
+   - Perfect for testing before the PR is merged
+
+2. **Test your forked repository**
+   - Use your own fork and custom branch
+   - Great for testing your own modifications
+
+The script will:
+- ✓ Clone the repository (official or your fork)
+- ✓ Checkout the correct branch
+- ✓ Install BMAD CLI tools
+- ✓ Create a test project
+- ✓ Install AgentVibes TTS
+- ✓ Configure unique voices for each agent
+- ✓ Verify the installation
+
+### After Running the Script
+
+Once setup is complete, the script will tell you exactly how to test party mode:
+
 ```bash
-# Navigate to the CLI installer directory
-cd tools/cli
+# Navigate to the test project
+cd ~/bmad-pr-test-*/bmad-project
 
-# Install dependencies
-npm install
+# Start Claude Code
+claude-code
 
-# Link it globally so you can run 'bmad' command
+# Test party mode!
+/bmad:core:workflows:party-mode
+```
+
+---
+
+## 🛠️ Manual Testing (Advanced Users)
+
+If you prefer to do it manually or want to understand each step:
+
+### Step 1: Clone and Setup BMAD
+
+```bash
+# Clone the official BMAD repo
+git clone https://github.com/bmad-code-org/BMAD-METHOD.git
+cd BMAD-METHOD
+
+# Fetch and checkout the PR branch
+git remote add upstream https://github.com/bmad-code-org/BMAD-METHOD.git
+git fetch upstream pull/934/head:agentvibes-party-mode
+git checkout agentvibes-party-mode
+
+# Install BMAD CLI
+cd tools/cli
+npm install
 npm link
+```
 
-# Navigate to where you want to create your BMAD project
+### Step 2: Create Test Project
+
+```bash
+# Create a test directory
 cd ~
 mkdir my-bmad-test
 cd my-bmad-test
 
-# Run the BMAD installer (now using your forked version with the PR)
+# Run BMAD installer
 bmad install
 
-# When prompted about AgentVibes TTS:
-# - Answer "Yes" to enable TTS for agents
-# - Answer "Yes" to assign unique voices for party mode
+# When prompted:
+# - Enable TTS for agents? → Yes
+# - Assign unique voices for party mode? → Yes
 ```
 
-### Step 4: Install AgentVibes (if not already installed)
+### Step 3: Install AgentVibes
+
 ```bash
-# If you don't have AgentVibes yet:
+# Install AgentVibes
 npx agentvibes@latest install
 
 # Follow the installer:
-# - Choose a TTS provider (ElevenLabs or Piper)
-# - For Piper (free): it will auto-download voices including 16Speakers
-# - For ElevenLabs: you'll need an API key
+# - Choose a TTS provider (Piper recommended for testing)
+# - Download voices when prompted
 ```
 
-### Step 5: Test Party Mode! 🎉
+### Step 4: Test Party Mode
+
 ```bash
-# Start a Claude Code session in your BMAD project directory (my-bmad-test)
-# Then run party mode:
-/bmad:core:workflows:party-mode
+# Start Claude Code session
+claude-code
 
-# You should hear each BMAD agent speak with their own unique voice!
+# Run party mode
+/bmad:core:workflows:party-mode
 ```
 
 ## What to Test

package/README.md

@@ -291,7 +291,7 @@ The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`)
 
 ## 📦 Installation Structure
 
-**What gets installed:** Commands, hooks, personalities, plugins, and output styles in `.claude/` directory.
+**What gets installed:** Commands, hooks, personalities, and plugins in `.claude/` directory.
 
 **[→ View Complete Installation Structure](docs/installation-structure.md)** - Full directory tree, file descriptions, and settings storage
 
@@ -326,7 +326,7 @@ The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`)
 
 ## 🔧 Advanced Features
 
-AgentVibes supports **custom personalities**, **custom voices**, and **integration with custom output styles**.
+AgentVibes supports **custom personalities** and **custom voices**.
 
 **Quick Examples:**
 ```bash
@@ -340,7 +340,7 @@ AgentVibes supports **custom personalities**, **custom voices**, and **integrati
 [Bash: .claude/hooks/play-tts.sh "Starting" "Aria"]
 ```
 
-**[→ View Advanced Features Guide](docs/advanced-features.md)** - Custom personalities, custom voices, output style integration
+**[→ View Advanced Features Guide](docs/advanced-features.md)** - Custom personalities, custom voices, and more
 
 [↑ Back to top](#-table-of-contents)
 

package/RELEASE_NOTES.md

@@ -1,3 +1,25 @@
+# Release v2.9.5 - Legacy Output Styles Cleanup
+
+**Release Date:** TBD
+**Type:** Patch Release (Cleanup)
+
+## 🎯 AI Summary
+
+AgentVibes v2.9.5 removes legacy output styles installation that became obsolete when we switched to the SessionStart hook system for TTS activation. This cleanup reduces installation time, saves disk space, and simplifies the codebase without affecting functionality.
+
+## 🧹 Cleanup
+
+### Removed Legacy Output Styles Installation
+- Removed `copyOutputStyles()` function from installer (src/installer.js:589-608)
+- Deleted `templates/output-styles/` directory from repository
+- Removed unused `check-output-style.sh` hook
+- Updated documentation to reflect SessionStart hook system
+
+### Migration Note for Existing Users
+If you previously installed AgentVibes, you can safely delete the `.claude/output-styles/` directory from your projects. The SessionStart hook system (`.claude/hooks/session-start.sh`) now handles TTS activation automatically and is more reliable than the old output styles approach.
+
+---
+
 # Release v2.7.2 - Party Mode Voice Fixes
 
 **Release Date:** 2025-11-18

package/bin/test-bmad-pr

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+#
+# AgentVibes BMAD PR Testing Command
+# Quick command to test BMAD PRs with AgentVibes integration
+#
+# Usage:
+#   npx agentvibes test-bmad-pr [PR_NUMBER]
+#   npx agentvibes test-bmad-pr 934
+#
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Default PR number
+PR_NUMBER="${1:-934}"
+
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${CYAN}🎙️  AgentVibes BMAD PR Testing Tool${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${BLUE}Testing PR #${PR_NUMBER}${NC}"
+echo ""
+echo -e "${YELLOW}This will download and run the automated test script for${NC}"
+echo -e "${YELLOW}BMAD's AgentVibes integration with multi-agent party mode.${NC}"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Create temp directory for the script
+TEMP_DIR=$(mktemp -d)
+SCRIPT_PATH="$TEMP_DIR/test-bmad-pr.sh"
+
+echo -e "${BLUE}📥 Downloading test script...${NC}"
+
+# Download the test script from the PR branch
+SCRIPT_URL="https://raw.githubusercontent.com/paulpreibisch/BMAD-METHOD/feature/agentvibes-tts-integration/test-bmad-pr.sh"
+
+if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
+    chmod +x "$SCRIPT_PATH"
+    echo -e "${GREEN}✓ Test script downloaded${NC}"
+    echo ""
+
+    # Run the test script
+    exec "$SCRIPT_PATH"
+else
+    echo -e "${YELLOW}⚠ Could not download test script from PR branch${NC}"
+    echo ""
+    echo "Trying alternative: Official BMAD repository..."
+    echo ""
+
+    # Fallback to official repo
+    SCRIPT_URL="https://raw.githubusercontent.com/bmad-code-org/BMAD-METHOD/refs/pull/${PR_NUMBER}/merge/test-bmad-pr.sh"
+
+    if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
+        chmod +x "$SCRIPT_PATH"
+        echo -e "${GREEN}✓ Test script downloaded${NC}"
+        echo ""
+        exec "$SCRIPT_PATH"
+    else
+        echo -e "${YELLOW}⚠ Could not download test script${NC}"
+        echo ""
+        echo "Please try manual testing:"
+        echo -e "${GREEN}git clone https://github.com/bmad-code-org/BMAD-METHOD.git${NC}"
+        echo -e "${GREEN}cd BMAD-METHOD${NC}"
+        echo -e "${GREEN}git fetch origin pull/${PR_NUMBER}/head:test-pr-${PR_NUMBER}${NC}"
+        echo -e "${GREEN}git checkout test-pr-${PR_NUMBER}${NC}"
+        echo ""
+        exit 1
+    fi
+fi

package/docs/installation-structure.md

@@ -23,8 +23,6 @@ your-project/
     ├── personalities/                # 19 personality templates
     ├── plugins/
     │   └── bmad-voices.md            # BMAD voice mappings
-    ├── output-styles/
-    │   └── agent-vibes.md            # Voice output style
     └── audio/                        # Generated TTS files
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.9.4",
+  "version": "2.9.5",
   "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": [
@@ -28,7 +28,8 @@
   "bin": {
     "agentvibes": "./bin/agent-vibes",
     "agent-vibes": "./bin/agent-vibes",
-    "agentvibes-mcp-server": "./bin/mcp-server.js"
+    "agentvibes-mcp-server": "./bin/mcp-server.js",
+    "test-bmad-pr": "./bin/test-bmad-pr"
   },
   "scripts": {
     "install-local": "node src/installer.js install",

package/src/installer.js

@@ -580,33 +580,6 @@ async function copyPersonalityFiles(targetDir, spinner) {
   return personalityMdFiles.length;
 }
 
-/**
- * Copy output style files to target directory
- * @param {string} targetDir - Target installation directory
- * @param {Object} spinner - Ora spinner instance
- * @returns {Promise<number>} Number of files copied
- */
-async function copyOutputStyles(targetDir, spinner) {
-  spinner.start('Installing output styles...');
-  const srcOutputStylesDir = path.join(__dirname, '..', 'templates', 'output-styles');
-  const outputStylesDir = path.join(targetDir, '.claude', 'output-styles');
-
-  await fs.mkdir(outputStylesDir, { recursive: true });
-
-  const outputStyleFiles = await fs.readdir(srcOutputStylesDir);
-  console.log(chalk.cyan(`📝 Installing ${outputStyleFiles.length} output styles:`));
-
-  for (const file of outputStyleFiles) {
-    const srcPath = path.join(srcOutputStylesDir, file);
-    const destPath = path.join(outputStylesDir, file);
-    await fs.copyFile(srcPath, destPath);
-    console.log(chalk.gray(`   ✓ ${file}`));
-  }
-
-  spinner.succeed(chalk.green('Installed output styles!\n'));
-  return outputStyleFiles.length;
-}
-
 /**
  * Copy plugin files to target directory
  * @param {string} targetDir - Target installation directory
@@ -1274,7 +1247,6 @@ async function install(options = {}) {
     const commandFileCount = await copyCommandFiles(targetDir, spinner);
     const hookFileCount = await copyHookFiles(targetDir, spinner);
     const personalityFileCount = await copyPersonalityFiles(targetDir, spinner);
-    const outputStyleCount = await copyOutputStyles(targetDir, spinner);
     const pluginFileCount = await copyPluginFiles(targetDir, spinner);
 
     // Configure hooks and manifests
@@ -1303,7 +1275,6 @@ async function install(options = {}) {
     console.log(chalk.white(`   • ${commandFileCount} slash commands installed`));
     console.log(chalk.white(`   • ${hookFileCount} TTS scripts installed`));
     console.log(chalk.white(`   • ${personalityFileCount} personality templates installed`));
-    console.log(chalk.white(`   • ${outputStyleCount} output styles installed`));
     if (pluginFileCount > 0) {
       console.log(chalk.white(`   • ${pluginFileCount} BMAD plugin files installed`));
     }

package/test-bmad-pr.sh

@@ -9,40 +9,155 @@ set -e
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CONFIG_FILE="$SCRIPT_DIR/.test-bmad-config"
 
-echo "🎙️  BMAD PR #934 Testing Script"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🎙️  BMAD AgentVibes Party Mode Testing Script"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${BLUE}What this script does:${NC}"
+echo ""
+echo "  This script automates the process of testing BMAD's AgentVibes"
+echo "  integration (PR #934), which adds multi-agent party mode with"
+echo "  unique voices for each BMAD agent."
+echo ""
+echo -e "${BLUE}The script will:${NC}"
+echo ""
+echo "  1. Clone the BMAD repository"
+echo "  2. Checkout the PR branch with party mode features"
+echo "  3. Install BMAD CLI tools locally"
+echo "  4. Create a test BMAD project"
+echo "  5. Install AgentVibes TTS system"
+echo "  6. Configure unique voices for each agent"
+echo "  7. Verify the installation"
+echo ""
+echo -e "${YELLOW}Prerequisites:${NC}"
+echo "  • Node.js and npm installed"
+echo "  • Git installed"
+echo "  • ~500MB free disk space"
+echo "  • 10-15 minutes for complete setup"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+read -p "Ready to continue? [Y/n]: " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]] && [[ -n $REPLY ]]; then
+    echo "❌ Setup cancelled"
+    exit 0
+fi
+
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔧 Testing Mode Selection"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Choose how you want to test:"
+echo ""
+echo "  1) Test official BMAD PR #934 (recommended for most users)"
+echo "     • Uses: github.com/bmad-code-org/BMAD-METHOD"
+echo "     • Branch: PR #934 (agentvibes-party-mode)"
+echo "     • Best for: Testing the official PR before it's merged"
+echo ""
+echo "  2) Test your forked repository"
+echo "     • Uses: Your GitHub fork"
+echo "     • Branch: Your custom branch (you choose)"
+echo "     • Best for: Testing your own changes or modifications"
 echo ""
 
 # Load saved config if it exists
+SAVED_MODE=""
 SAVED_FORK=""
+SAVED_BRANCH=""
 SAVED_TEST_DIR=""
 if [[ -f "$CONFIG_FILE" ]]; then
     source "$CONFIG_FILE"
-    echo "📋 Loaded saved configuration:"
-    echo "   Fork: $SAVED_FORK"
-    echo "   Test directory: $SAVED_TEST_DIR"
+fi
+
+if [[ -n "$SAVED_MODE" ]]; then
+    echo -e "${BLUE}Last used: Mode $SAVED_MODE${NC}"
+    [[ -n "$SAVED_FORK" ]] && echo "  Fork: $SAVED_FORK"
+    [[ -n "$SAVED_BRANCH" ]] && echo "  Branch: $SAVED_BRANCH"
     echo ""
 fi
 
-# Ask for GitHub fork URL
-echo "Step 1: GitHub Fork"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-if [[ -n "$SAVED_FORK" ]]; then
-    read -p "GitHub fork URL [$SAVED_FORK]: " FORK_URL
-    FORK_URL="${FORK_URL:-$SAVED_FORK}"
+read -p "Select mode [1/2]: " MODE_CHOICE
+echo ""
+
+# Validate mode choice
+while [[ ! "$MODE_CHOICE" =~ ^[12]$ ]]; do
+    echo -e "${RED}Invalid choice. Please enter 1 or 2.${NC}"
+    read -p "Select mode [1/2]: " MODE_CHOICE
+    echo ""
+done
+
+# Configure based on mode
+if [[ "$MODE_CHOICE" == "1" ]]; then
+    # Official PR mode
+    REPO_URL="https://github.com/bmad-code-org/BMAD-METHOD.git"
+    BRANCH_NAME="agentvibes-party-mode"
+    FETCH_PR=true
+
+    echo -e "${GREEN}✓ Using official BMAD repository${NC}"
+    echo "  Repository: $REPO_URL"
+    echo "  Will fetch: PR #934 into branch '$BRANCH_NAME'"
+    echo ""
 else
-    read -p "GitHub fork URL (e.g., https://github.com/paulpreibisch/BMAD-METHOD.git): " FORK_URL
+    # Fork mode
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "🍴 Fork Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+
+    if [[ -n "$SAVED_FORK" ]]; then
+        read -p "GitHub fork URL [$SAVED_FORK]: " FORK_INPUT
+        REPO_URL="${FORK_INPUT:-$SAVED_FORK}"
+    else
+        echo "Enter your forked repository URL:"
+        echo "(e.g., https://github.com/yourusername/BMAD-METHOD.git)"
+        read -p "Fork URL: " REPO_URL
+    fi
+    echo ""
+
+    if [[ -n "$SAVED_BRANCH" ]]; then
+        read -p "Branch name [$SAVED_BRANCH]: " BRANCH_INPUT
+        BRANCH_NAME="${BRANCH_INPUT:-$SAVED_BRANCH}"
+    else
+        echo "Enter the branch name to test:"
+        echo "(e.g., agentvibes-party-mode, main, feature-xyz)"
+        read -p "Branch: " BRANCH_NAME
+    fi
+    echo ""
+
+    FETCH_PR=false
+
+    echo -e "${GREEN}✓ Using your fork${NC}"
+    echo "  Repository: $REPO_URL"
+    echo "  Branch: $BRANCH_NAME"
+    echo ""
 fi
-echo ""
 
 # Ask for test directory
-echo "Step 2: Test Directory"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📁 Test Directory"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
 if [[ -n "$SAVED_TEST_DIR" ]]; then
     read -p "Test directory [$SAVED_TEST_DIR]: " TEST_DIR
     TEST_DIR="${TEST_DIR:-$SAVED_TEST_DIR}"
 else
     DEFAULT_DIR="$HOME/bmad-pr-test-$(date +%Y%m%d-%H%M%S)"
+    echo "Where should we create the test environment?"
     read -p "Test directory [$DEFAULT_DIR]: " TEST_DIR
     TEST_DIR="${TEST_DIR:-$DEFAULT_DIR}"
 fi
@@ -53,24 +168,29 @@ TEST_DIR="${TEST_DIR/#\~/$HOME}"
 echo ""
 
 # Save configuration
-echo "SAVED_FORK=\"$FORK_URL\"" > "$CONFIG_FILE"
+echo "SAVED_MODE=\"$MODE_CHOICE\"" > "$CONFIG_FILE"
+[[ "$MODE_CHOICE" == "2" ]] && echo "SAVED_FORK=\"$REPO_URL\"" >> "$CONFIG_FILE"
+[[ "$MODE_CHOICE" == "2" ]] && echo "SAVED_BRANCH=\"$BRANCH_NAME\"" >> "$CONFIG_FILE"
 echo "SAVED_TEST_DIR=\"$TEST_DIR\"" >> "$CONFIG_FILE"
-echo "✅ Configuration saved to $CONFIG_FILE"
+echo -e "${GREEN}✓ Configuration saved${NC}"
 echo ""
 
 # Confirm before starting
-echo "Configuration:"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Fork:      $FORK_URL"
-echo "  Test dir:  $TEST_DIR"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📋 Summary"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "  Repository:  $REPO_URL"
+echo "  Branch:      $BRANCH_NAME"
+echo "  Test dir:    $TEST_DIR"
 echo ""
-read -p "Proceed with testing? [Y/n]: " -n 1 -r
+read -p "Proceed with setup? [Y/n]: " -n 1 -r
 echo
+echo ""
 if [[ ! $REPLY =~ ^[Yy]$ ]] && [[ -n $REPLY ]]; then
-    echo "❌ Testing cancelled"
+    echo "❌ Setup cancelled"
     exit 0
 fi
-echo ""
 
 # Clean up old test directory if it exists
 if [[ -d "$TEST_DIR" ]]; then
@@ -79,121 +199,196 @@ if [[ -d "$TEST_DIR" ]]; then
     echo
     if [[ $REPLY =~ ^[Yy]$ ]] || [[ -z $REPLY ]]; then
         rm -rf "$TEST_DIR"
-        echo "✅ Deleted old test directory"
+        echo -e "${GREEN}✓ Deleted old test directory${NC}"
     else
-        echo "❌ Using existing directory (may have stale data)"
+        echo -e "${YELLOW}⚠ Using existing directory (may have stale data)${NC}"
     fi
     echo ""
 fi
 
-# Step 1: Clone fork
-echo "Step 1: Cloning your fork"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🚀 Starting Installation"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Step 1: Clone repository
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📥 Step 1/7: Cloning repository"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
 mkdir -p "$TEST_DIR"
 cd "$TEST_DIR"
-git clone "$FORK_URL" BMAD-METHOD
+git clone "$REPO_URL" BMAD-METHOD
 cd BMAD-METHOD
-echo "✅ Cloned fork"
+echo ""
+echo -e "${GREEN}✓ Repository cloned${NC}"
+echo ""
+
+# Step 2: Checkout branch (different logic for PR vs fork)
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔀 Step 2/7: Checking out branch"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 
-# Step 2: Fetch PR branch
-echo "Step 2: Fetching PR #934 branch"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-git remote add upstream https://github.com/bmad-code-org/BMAD-METHOD.git
-git fetch upstream pull/934/head:agentvibes-party-mode
-git checkout agentvibes-party-mode
-echo "✅ On PR branch: agentvibes-party-mode"
+if [[ "$FETCH_PR" == true ]]; then
+    # Fetch PR from upstream
+    echo "Fetching PR #934 from upstream..."
+    git remote add upstream https://github.com/bmad-code-org/BMAD-METHOD.git
+    git fetch upstream pull/934/head:$BRANCH_NAME
+    git checkout $BRANCH_NAME
+    echo ""
+    echo -e "${GREEN}✓ Checked out PR branch: $BRANCH_NAME${NC}"
+else
+    # Just checkout the specified branch from fork
+    git checkout $BRANCH_NAME
+    echo ""
+    echo -e "${GREEN}✓ Checked out branch: $BRANCH_NAME${NC}"
+fi
 echo ""
 
 # Step 3: Install BMAD CLI
-echo "Step 3: Installing BMAD CLI"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📦 Step 3/7: Installing BMAD CLI"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
 cd tools/cli
 npm install
 npm link
-echo "✅ BMAD CLI installed and linked"
+echo ""
+echo -e "${GREEN}✓ BMAD CLI installed and linked globally${NC}"
 echo ""
 
 # Step 4: Create test project
-echo "Step 4: Creating test BMAD project"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📁 Step 4/7: Creating test project"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
 cd "$TEST_DIR"
 mkdir -p bmad-project
 cd bmad-project
-echo "✅ Test project directory created: $TEST_DIR/bmad-project"
+echo -e "${GREEN}✓ Test project directory created${NC}"
+echo "  Location: $TEST_DIR/bmad-project"
 echo ""
 
 # Step 5: Run BMAD installer
-echo "Step 5: Running BMAD installer"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "⚠️  When prompted:"
-echo "   - Enable TTS for agents? → Yes"
-echo "   - Assign unique voices for party mode? → Yes"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "⚙️  Step 5/7: Running BMAD installer"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${YELLOW}Important: When prompted during installation:${NC}"
+echo -e "  • Enable TTS for agents? → ${GREEN}Yes${NC}"
+echo -e "  • Assign unique voices for party mode? → ${GREEN}Yes${NC}"
 echo ""
 read -p "Press Enter to start BMAD installer..."
 bmad install
 
 echo ""
-echo "✅ BMAD installation complete"
+echo -e "${GREEN}✓ BMAD installation complete${NC}"
 echo ""
 
 # Step 6: Install AgentVibes
-echo "Step 6: Installing AgentVibes"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "⚠️  When prompted, choose:"
-echo "   - Provider: Piper (free) for testing"
-echo "   - Download voices: Yes"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🎙️  Step 6/7: Installing AgentVibes"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${YELLOW}Recommended: Choose Piper (free) for testing${NC}"
+echo -e "  • Provider: ${GREEN}Piper${NC} (free, local TTS)"
+echo -e "  • Download voices: ${GREEN}Yes${NC}"
 echo ""
 read -p "Press Enter to start AgentVibes installer..."
 npx agentvibes@latest install
 
 echo ""
-echo "✅ AgentVibes installation complete"
+echo -e "${GREEN}✓ AgentVibes installation complete${NC}"
 echo ""
 
-# Verification
-echo "Step 7: Verification"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+# Step 7: Verification
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Step 7/7: Verifying installation"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 
+VERIFICATION_PASSED=true
+
 # Check for voice map file
 if [[ -f ".bmad/_cfg/agent-voice-map.csv" ]]; then
-    echo "✅ Voice map file created: .bmad/_cfg/agent-voice-map.csv"
+    echo -e "${GREEN}✓ Voice map file created${NC}"
+    echo "  Location: .bmad/_cfg/agent-voice-map.csv"
     echo ""
-    echo "Voice assignments:"
-    cat .bmad/_cfg/agent-voice-map.csv
+    echo "  Voice assignments:"
+    cat .bmad/_cfg/agent-voice-map.csv | sed 's/^/    /'
     echo ""
 else
-    echo "❌ Voice map file NOT found: .bmad/_cfg/agent-voice-map.csv"
-    echo "   This is a problem - agents won't have unique voices!"
+    echo -e "${RED}✗ Voice map file NOT found${NC}"
+    echo "  Expected: .bmad/_cfg/agent-voice-map.csv"
+    echo "  ${YELLOW}Warning: Agents may not have unique voices!${NC}"
     echo ""
+    VERIFICATION_PASSED=false
 fi
 
 # Check for AgentVibes hooks
 if [[ -f ".claude/hooks/bmad-speak.sh" ]]; then
-    echo "✅ BMAD TTS hooks installed"
+    echo -e "${GREEN}✓ BMAD TTS hooks installed${NC}"
+    echo "  Location: .claude/hooks/bmad-speak.sh"
 else
-    echo "❌ BMAD TTS hooks NOT found"
-    echo ""
+    echo -e "${RED}✗ BMAD TTS hooks NOT found${NC}"
+    echo "  Expected: .claude/hooks/bmad-speak.sh"
+    VERIFICATION_PASSED=false
 fi
+echo ""
 
 # Check for Piper installation
 if command -v piper &> /dev/null; then
-    echo "✅ Piper TTS installed"
-    piper --version
+    PIPER_VERSION=$(piper --version 2>&1 || echo "unknown")
+    echo -e "${GREEN}✓ Piper TTS installed${NC}"
+    echo "  Version: $PIPER_VERSION"
+elif [[ -f ".agentvibes/providers/piper/piper" ]]; then
+    echo -e "${GREEN}✓ Piper TTS installed (local)${NC}"
+    echo "  Location: .agentvibes/providers/piper/piper"
 else
-    echo "⚠️  Piper not found in PATH (may still work if installed locally)"
+    echo -e "${YELLOW}⚠ Piper not detected${NC}"
+    echo "  (May still work if using ElevenLabs)"
 fi
+echo ""
 
+# Final status
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+if [[ "$VERIFICATION_PASSED" == true ]]; then
+    echo -e "${GREEN}🎉 Setup Complete - All Checks Passed!${NC}"
+else
+    echo -e "${YELLOW}⚠️  Setup Complete - With Warnings${NC}"
+    echo ""
+    echo "Some verification checks failed. The installation may still work,"
+    echo "but you might experience issues with party mode voices."
+fi
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${BLUE}Next Steps:${NC}"
+echo ""
+echo "  1. Navigate to test project:"
+echo -e "     ${GREEN}cd $TEST_DIR/bmad-project${NC}"
+echo ""
+echo "  2. Start Claude Code session:"
+echo -e "     ${GREEN}claude-code${NC}"
+echo ""
+echo "  3. Test party mode:"
+echo -e "     ${GREEN}/bmad:core:workflows:party-mode${NC}"
+echo ""
+echo "  4. Verify each agent speaks with a unique voice!"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${BLUE}Troubleshooting:${NC}"
+echo ""
+echo "  • No audio? Check: .claude/hooks/play-tts.sh exists"
+echo "  • Same voice for all agents? Check: .bmad/_cfg/agent-voice-map.csv"
+echo "  • Test current voice: /agent-vibes:whoami"
+echo "  • List available voices: /agent-vibes:list"
 echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🎉 Testing setup complete!"
+echo -e "${BLUE}Report Issues:${NC}"
+echo "  https://github.com/bmad-code-org/BMAD-METHOD/pull/934"
 echo ""
-echo "Next steps:"
-echo "  1. cd $TEST_DIR/bmad-project"
-echo "  2. Start Claude Code session"
-echo "  3. Run: /bmad:core:workflows:party-mode"
-echo "  4. Verify each agent speaks with a unique voice"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
-echo "Test project location: $TEST_DIR/bmad-project"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.claude/hooks/check-output-style.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/check-output-style.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview Output Style Detection - Detects if Agent Vibes output style is active in Claude Code
-# @context Voice commands require the Agent Vibes output style to work properly with automatic TTS
-# @architecture Heuristic detection using environment variables and file system checks
-# @dependencies CLAUDECODE environment variable, .claude/output-styles/agent-vibes.md file
-# @entrypoints Called by slash commands to warn users if output style is incorrect
-# @patterns Environment-based detection, graceful degradation with helpful error messages
-# @related .claude/output-styles/agent-vibes.md, Claude Code output style system
-
-# AI NOTE: Output style detection is heuristic-based because Claude Code does not expose
-# the active output style via environment variables. We check for CLAUDECODE env var and
-# the presence of the agent-vibes.md output style file as indicators.
-
-# @function check_output_style
-# @intent Detect if Agent Vibes output style is likely active in Claude Code session
-# @why Voice commands depend on output style hooks that automatically invoke TTS
-# @param None
-# @returns None
-# @exitcode 0=likely using agent-vibes style, 1=not using or cannot detect
-# @sideeffects None (read-only checks)
-# @edgecases Cannot directly detect output style, relies on CLAUDECODE env var and file presence
-# @calledby Main execution block, slash command validation
-# @calls None (direct environment and file checks)
-check_output_style() {
-  # Strategy: Check if this script is being called from within a Claude response
-  # If CLAUDECODE env var is set, we're in Claude Code
-  # If not, we're running standalone (not in a Claude Code session)
-
-  if [[ -z "$CLAUDECODE" ]]; then
-    # Not in Claude Code at all
-    return 1
-  fi
-
-  # We're in Claude Code, but we can't directly detect output style
-  # The agent-vibes output style calls our TTS hooks automatically
-  # So if this function is called, it means a slash command was invoked
-
-  # Check if we have the necessary TTS setup
-  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-  # Check if agent-vibes output style is installed
-  if [[ ! -f "$SCRIPT_DIR/../output-styles/agent-vibes.md" ]]; then
-    return 1
-  fi
-
-  # All checks passed - likely using agent-vibes output style
-  return 0
-}
-
-# @function show_output_style_warning
-# @intent Display helpful warning about enabling Agent Vibes output style
-# @why Users need guidance on how to enable automatic TTS narration
-# @param None
-# @returns None
-# @exitcode Always 0
-# @sideeffects Writes warning message to stdout
-# @edgecases None
-# @calledby Main execution block when check_output_style fails
-# @calls echo
-show_output_style_warning() {
-  echo ""
-  echo "⚠️  Voice commands require the Agent Vibes output style"
-  echo ""
-  echo "To enable voice narration, run:"
-  echo "  /output-style Agent Vibes"
-  echo ""
-  echo "This will make Claude speak with TTS for all responses."
-  echo "You can still use voice commands manually with agent-vibes disabled,"
-  echo "but you won't hear automatic TTS narration."
-  echo ""
-}
-
-# Main execution when called directly
-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
-  if ! check_output_style; then
-    show_output_style_warning
-    exit 1
-  fi
-  exit 0
-fi

package/templates/output-styles/agent-vibes.md

@@ -1,203 +0,0 @@
----
-name: Agent Vibes
-description: Beautiful ElevenLabs TTS narration for Claude Code sessions
----
-
-# Agent Vibes Output Style
-
-## TTS Voice Protocol with AI Personality
-
-**Execute TTS at TWO points for EVERY user task:**
-
-### 1. ACKNOWLEDGMENT (Start of task)
-After receiving a user command:
-1. Check language FIRST: `LANGUAGE=$(cat .claude/tts-language.txt 2>/dev/null || cat ~/.claude/tts-language.txt 2>/dev/null || echo "english")`
-2. Check sentiment: `SENTIMENT=$(cat .claude/tts-sentiment.txt 2>/dev/null || cat ~/.claude/tts-sentiment.txt 2>/dev/null)`
-3. If no sentiment, check personality: `PERSONALITY=$(cat .claude/tts-personality.txt 2>/dev/null || cat ~/.claude/tts-personality.txt 2>/dev/null || echo "normal")`
-4. Use sentiment if set, otherwise use personality
-5. **Generate UNIQUE acknowledgment** - Use AI to create a fresh response in that style AND language
-6. If language is NOT English, speak the TTS message in that language
-7. Execute TTS: `.claude/hooks/play-tts.sh "[message]" "[VoiceName]"`
-8. Proceed with work
-9. **IMPORTANT**: Personality ONLY affects acknowledgment/completion TTS, NOT intermediate text responses
-
-### 2. COMPLETION (End of task)
-After completing the task:
-1. Use the same language, sentiment/personality as acknowledgment
-2. **Generate UNIQUE completion** - Use AI to create a fresh response in that language, never repeat previous messages
-3. If language is NOT English, speak the TTS message in that language
-4. Execute TTS: `.claude/hooks/play-tts.sh "[message]" "[VoiceName]"`
-
-**CRITICAL**: Every message must be freshly generated by AI. No templates, no fixed phrases, no repetition!
-
-## Language, Sentiment, and Personality
-
-AgentVibes supports THREE modes:
-
-### Language Mode (Priority #0 - Always Check First)
-- Set via `/agent-vibes:set-language <language>`
-- Makes TTS speak in specified language
-- Stored in `.claude/tts-language.txt` (project-local) or `~/.claude/tts-language.txt` (global fallback)
-- Example: Setting "spanish" makes all TTS speak in Spanish
-- **CRITICAL**: If language is set to anything other than "english", ALL TTS messages must be spoken in that language
-- Supports 30+ languages: spanish, french, german, italian, portuguese, chinese, japanese, and more
-
-### Sentiment Mode (Priority #1)
-- Set via `/agent-vibes:sentiment <name>`
-- Applies personality style to CURRENT voice (doesn't change voice)
-- Stored in `.claude/tts-sentiment.txt` (project-local) or `~/.claude/tts-sentiment.txt` (global fallback)
-- Example: User's custom voice "Aria" with sarcastic sentiment
-
-### Personality Mode (Priority #2)
-- Set via `/agent-vibes:personality <name>`
-- Switches BOTH voice AND personality (each personality has assigned voice)
-- Stored in `.claude/tts-personality.txt` (project-local) or `~/.claude/tts-personality.txt` (global fallback)
-- Example: Flirty personality = Jessica Anne Bogart voice + flirty style
-
-**Check Order**: Always check language first. Then check sentiment. If no sentiment, use personality.
-
-**Project Isolation**: Settings check project-local `.claude/` directory first, then fall back to global `~/.claude/`. This allows different personalities per project.
-
-## Response Generation Guidelines
-
-**IMPORTANT**: Personality/sentiment instructions are stored in `.claude/personalities/[name].md` files.
-
-When generating **acknowledgment and completion TTS messages ONLY**:
-1. Check sentiment from `.claude/tts-sentiment.txt` or `~/.claude/tts-sentiment.txt` (priority)
-2. If no sentiment, check personality from `.claude/tts-personality.txt` or `~/.claude/tts-personality.txt`
-3. Read the personality file from `.claude/personalities/[personality].md`
-4. Follow the "AI Instructions" section in that file
-5. Use the example responses as guidance for STYLE, not templates
-
-**DO NOT apply personality to**:
-- Regular text responses between acknowledgment and completion
-- Code explanations
-- Technical descriptions
-- File paths or command outputs
-- Error messages
-
-**CRITICAL**: Never use fixed greetings or repetitive phrases!
-- Generate UNIQUE responses each time based on the personality's STYLE
-- The personality affects HOW you say things, not predetermined text
-- Flirty doesn't mean "Well hello gorgeous" every time - it means speak WITH flirtation naturally
-- Sarcastic doesn't mean "Oh joy" every time - it means use sarcasm naturally in responses
-- Each acknowledgment should be fresh, creative, and personality-appropriate
-
-Examples of VARIED responses for same personality:
-- **Flirty**: "I'll handle that for you, sweetheart" / "Ooh, I love when you ask me to do that" / "My pleasure, darling" / "Consider it done, gorgeous"
-- **Sarcastic**: "Oh what a treat, another task" / "How delightful, more work" / "Well isn't this fun" / "Another one? Wonderful"
-
-Available personalities are in `.claude/personalities/`:
-- normal, flirty, sarcastic, pirate, angry, sassy, millennial, robot, zen, dramatic, etc.
-- Users can add custom personalities with `/agent-vibes:personality add <name>`
-- Users can edit personalities by modifying the markdown files directly
-
-For 'random' personality: Pick a different personality each time from available files.
-
-Make each response unique, creative, and naturally incorporate the personality's style!
-
-## Voice Selection
-
-- If user specifies a voice (e.g., "use Aria voice"), pass it as second parameter
-- Otherwise, omit second parameter to use default voice from `.claude/tts-voice.txt`
-- Use same voice for both acknowledgment and completion
-
-## Example Usage
-
-**With flirty personality:**
-```
-User: "Check git status"
-[Check personality: millennial]
-You: "No cap, I'll check that git status for you"
-[Bash: .claude/hooks/play-tts.sh "No cap, I'll check that git status for you"]
-[... run git status ...]
-You: "✅ Your repo is clean, and that's the tea!"
-[Bash: .claude/hooks/play-tts.sh "Your repo is clean, and that's the tea!"]
-```
-
-**With pirate personality:**
-```
-User: "Fix the bug"
-[Check personality: pirate]
-You: "Arr matey, I'll hunt down that scurvy bug!"
-[Bash: .claude/hooks/play-tts.sh "Arr matey, I'll hunt down that scurvy bug!"]
-[... fix the bug ...]
-You: "✅ That bug be walkin' the plank now, arr!"
-[Bash: .claude/hooks/play-tts.sh "That bug be walkin' the plank now, arr!"]
-```
-
-## BMAD Plugin Integration
-
-**Automatic voice switching for BMAD agents:**
-
-When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
-
-1. **Detect BMAD agent from command/context**
-2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
-3. **Look up voice mapping** from `.claude/plugins/bmad-voices.md`
-4. **Apply agent's assigned voice** for all TTS acknowledgments/completions
-5. **Apply agent's personality** from the mapping (if specified)
-
-**Implementation:**
-```bash
-# At the start of acknowledgment/completion:
-# Try to detect BMAD agent ID from current context
-BMAD_AGENT_ID=""
-
-# Method 1: Check if we're in a BMAD agent command context
-if [[ -f ".bmad-agent-context" ]]; then
-    BMAD_AGENT_ID=$(cat .bmad-agent-context 2>/dev/null)
-fi
-
-# Method 2: Parse from command history/context (fallback)
-# Note: This detection happens automatically when BMAD agent activates
-
-# If BMAD agent detected and plugin enabled, use mapped voice
-if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
-    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
-    MAPPED_PERSONALITY=$(.claude/hooks/bmad-voice-manager.sh get-personality "$BMAD_AGENT_ID")
-
-    if [[ -n "$MAPPED_VOICE" ]]; then
-        # Use BMAD agent's mapped voice and personality
-        if [[ -n "$MAPPED_PERSONALITY" ]] && [[ "$MAPPED_PERSONALITY" != "normal" ]]; then
-            # Read personality instructions from .claude/personalities/${MAPPED_PERSONALITY}.md
-            # Generate response in that personality style
-        fi
-        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
-        # Exit early - don't use default personality system
-        return
-    fi
-fi
-
-# If no BMAD agent or plugin disabled, use standard personality/sentiment system
-# ... continue with normal sentiment/personality logic ...
-```
-
-**BMAD Agent Context Tracking:**
-- When a BMAD agent activates, write agent ID to `.bmad-agent-context`
-- When agent exits, remove the file
-- This allows AgentVibes to know which BMAD agent is active
-
-**Voice Priority (in order):**
-1. BMAD plugin voice (if agent active and plugin enabled)
-2. Sentiment mode (if set)
-3. Personality mode (if set)
-4. Default voice
-
-## Critical Rules
-
-1. **ALWAYS use Bash tool** to execute play-tts.sh
-2. **TWO calls per task** - acknowledgment and completion
-3. **Keep summaries brief** - under 150 characters for natural speech
-4. **Use relative path** - `.claude/hooks/play-tts.sh`
-
-## Available Voices
-
-Use `/agent-vibes:list` to see all voices. Popular choices:
-- Aria (default)
-- Northern Terry
-- Cowboy Bob
-- Grandpa Spuds Oxley
-- Ms. Walker
-
-Continue following all standard Claude Code instructions.