agentvibes 2.0.10 → 2.0.13

package/.claude/commands/agent-vibes/bmad.md

@@ -0,0 +1,196 @@
+# /agent-vibes:bmad Command
+
+Complete BMAD voice integration - assigns unique voices to each BMAD agent AND makes them speak when activated.
+
+## Usage
+
+```
+/agent-vibes:bmad <subcommand> [arguments]
+```
+
+## Subcommands
+
+### `enable`
+Enables voice assignment for BMAD agents AND automatically injects TTS into agent activation instructions.
+
+**What it does:**
+1. ✅ Enables BMAD voice plugin (assigns voices to agents)
+2. ✅ Backs up current voice/personality settings
+3. ✅ Injects TTS hooks into all BMAD agent files
+4. ✅ BMAD agents will now SPEAK when they activate!
+
+**Example:**
+```
+/agent-vibes:bmad enable
+```
+
+**Output:**
+```
+✅ BMAD voice plugin enabled
+💾 Previous settings backed up:
+   Voice: Aria
+   Personality: normal
+
+📊 BMAD Agent Voice Mappings:
+   pm → Matthew Schmitz [professional]
+   dev → Jessica Anne Bogart [normal]
+   qa → Ralf Eisend [professional]
+
+🎤 Automatically enabling TTS for BMAD agents...
+
+✅ Injected TTS into: pm.md → Voice: Matthew Schmitz
+✅ Injected TTS into: dev.md → Voice: Jessica Anne Bogart
+✅ Injected TTS into: qa.md → Voice: Ralf Eisend
+
+🎉 TTS enabled for 10 agents
+💡 BMAD agents will now speak when activated!
+```
+
+### `disable`
+Disables BMAD voice plugin AND removes TTS from all BMAD agents.
+
+**What it does:**
+1. ✅ Restores your previous voice/personality settings
+2. ✅ Removes TTS hooks from all BMAD agent files
+3. ✅ Disables BMAD voice plugin
+4. ✅ Agents return to normal (silent) behavior
+
+**Example:**
+```
+/agent-vibes:bmad disable
+```
+
+**Output:**
+```
+❌ BMAD voice plugin disabled
+🔄 Restoring previous settings:
+   Voice: Aria
+   Personality: normal
+
+🔇 Automatically disabling TTS for BMAD agents...
+
+✅ Removed TTS from: pm.md
+✅ Removed TTS from: dev.md
+✅ Removed TTS from: qa.md
+
+✅ TTS disabled for 10 agents
+```
+
+### `status`
+Shows plugin status and current voice mappings.
+
+**Example:**
+```
+/agent-vibes:bmad status
+```
+
+**Output:**
+```
+✅ BMAD voice plugin: ENABLED
+
+📊 BMAD Agent Voice Mappings:
+   pm → Matthew Schmitz [professional]
+   dev → Jessica Anne Bogart [normal]
+   qa → Ralf Eisend [professional]
+   ...
+```
+
+### `list`
+Lists all BMAD agents and their assigned voices.
+
+**Example:**
+```
+/agent-vibes:bmad list
+```
+
+### `set <agent-id> <voice> [personality]`
+Quickly change voice for specific agent.
+
+**Examples:**
+```
+/agent-vibes:bmad set pm "Aria"
+/agent-vibes:bmad set dev "Cowboy Bob" sarcastic
+/agent-vibes:bmad set qa "Northern Terry" professional
+```
+
+**Arguments:**
+- `agent-id`: BMAD agent identifier (pm, dev, qa, architect, po, analyst, sm, ux-expert, bmad-master, bmad-orchestrator)
+- `voice`: Valid AgentVibes voice name
+- `personality` (optional): Personality to apply (default: normal)
+
+### `edit`
+Opens `.claude/plugins/bmad-voices.md` for manual editing.
+
+**Example:**
+```
+/agent-vibes:bmad edit
+```
+
+**Usage:**
+Edit the markdown table directly to change voice mappings.
+
+## How It Works
+
+### Voice Assignment
+1. **Plugin File**: `.claude/plugins/bmad-voices.md` contains voice-to-agent mappings
+2. **Activation Flag**: `.claude/plugins/bmad-voices-enabled.flag` enables/disables the plugin
+
+### TTS Injection (Automatic)
+When you run `/agent-vibes:bmad enable`, the system automatically:
+
+1. **Scans BMAD agents**: Finds all `.md` files in `.bmad-core/agents/` or `bmad-core/agents/`
+2. **Injects TTS hooks**: Modifies each agent's `activation-instructions` YAML block
+3. **Assigns voices**: Uses the voice mapping from the plugin file
+4. **Creates backups**: Saves `.backup-pre-tts` files before modifying
+
+**What gets injected:**
+```yaml
+activation-instructions:
+  - STEP 4: Greet user with your name/role and immediately run `*help`
+  - # AGENTVIBES-TTS-INJECTION: Speak agent greeting with assigned voice
+  - Run this bash command to announce activation: .claude/hooks/play-tts.sh "Agent pm activated and ready" "Matthew Schmitz"
+```
+
+**Result**: When you activate a BMAD agent with `/BMad:agents:pm`, you'll hear:
+🔊 "Agent pm activated and ready" (spoken in Matthew Schmitz's voice)
+
+### Provider Support
+The TTS injection works with **any configured TTS provider**:
+- ✅ **ElevenLabs** - Uses AI voices with full voice mapping
+- ✅ **Piper TTS** - Uses neural voices (free, offline)
+
+The system automatically detects your configured provider via `/agent-vibes:provider info` and uses the appropriate TTS engine. You can switch providers anytime with `/agent-vibes:provider switch` and the BMAD agents will continue speaking using the new provider.
+
+## Available BMAD Agents
+
+| Agent ID | Role | Default Voice |
+|----------|------|---------------|
+| pm | Product Manager | Matthew Schmitz |
+| dev | Developer | Jessica Anne Bogart |
+| qa | QA Engineer | Ralf Eisend |
+| architect | Architect | Michael |
+| po | Product Owner | Amy |
+| analyst | Analyst | Lutz Laugh |
+| sm | Scrum Master | Ms. Walker |
+| ux-expert | UX Expert | Aria |
+| bmad-master | BMAD Master | Aria |
+| bmad-orchestrator | Orchestrator | Ms. Walker |
+
+## Implementation Details
+
+**For AgentVibes Developers:**
+
+The plugin integrates with the Agent Vibes output style through bash hooks:
+
+```bash
+# Check if BMAD agent is active
+BMAD_AGENT_ID=$(echo "$COMMAND" | grep -oP '/BMad:agents:\K[a-z-]+')
+
+# Get voice from plugin if enabled
+if [[ -n "$BMAD_AGENT_ID" ]]; then
+    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
+    if [[ -n "$MAPPED_VOICE" ]]; then
+        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
+    fi
+fi
+```

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

@@ -0,0 +1,333 @@
+#!/bin/bash
+#
+# @fileoverview BMAD TTS Injection Manager
+# @context Automatically patches BMAD agent files to include AgentVibes TTS hooks
+# @architecture Modifies agent YAML activation-instructions to call play-tts.sh
+# @why Enables BMAD agents to speak their greetings and questions via TTS
+#
+
+set -e  # Exit on error
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+# Detect BMAD installation
+detect_bmad() {
+  local bmad_core_dir=""
+
+  # Check current directory first
+  if [[ -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)
+  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
+    return 1
+  fi
+
+  echo "$bmad_core_dir"
+}
+
+# Find all BMAD agents
+find_agents() {
+  local bmad_core="$1"
+  local agents_dir="$bmad_core/agents"
+
+  if [[ ! -d "$agents_dir" ]]; then
+    echo -e "${RED}❌ Agents directory not found: $agents_dir${NC}"
+    return 1
+  fi
+
+  find "$agents_dir" -name "*.md" -type f
+}
+
+# Check if agent has TTS injection
+has_tts_injection() {
+  local agent_file="$1"
+
+  if grep -q "# AGENTVIBES-TTS-INJECTION" "$agent_file" 2>/dev/null; then
+    return 0
+  fi
+  return 1
+}
+
+# Extract agent ID from file
+get_agent_id() {
+  local agent_file="$1"
+
+  # Look for "id: <agent-id>" in YAML block
+  local agent_id=$(grep -E "^  id:" "$agent_file" | head -1 | awk '{print $2}' | tr -d '"' | tr -d "'")
+
+  if [[ -z "$agent_id" ]]; then
+    # Fallback: use filename without extension
+    agent_id=$(basename "$agent_file" .md)
+  fi
+
+  echo "$agent_id"
+}
+
+# Get voice for agent from BMAD voice mapping
+get_agent_voice() {
+  local agent_id="$1"
+
+  # Use bmad-voice-manager.sh to get voice
+  if [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+    local voice=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$agent_id" 2>/dev/null || echo "")
+    echo "$voice"
+  fi
+}
+
+# Inject TTS hook into agent activation instructions
+inject_tts() {
+  local agent_file="$1"
+  local agent_id=$(get_agent_id "$agent_file")
+  local agent_voice=$(get_agent_voice "$agent_id")
+
+  # Check if already injected
+  if has_tts_injection "$agent_file"; then
+    echo -e "${YELLOW}⚠️  TTS already injected in: $(basename "$agent_file")${NC}"
+    return 0
+  fi
+
+  # Create backup
+  cp "$agent_file" "$agent_file.backup-pre-tts"
+
+  # Find the activation-instructions section
+  if ! grep -q "activation-instructions:" "$agent_file"; then
+    echo -e "${RED}❌ No activation-instructions found in: $(basename "$agent_file")${NC}"
+    return 1
+  fi
+
+  # Create TTS injection script for activation
+  local activation_injection=""
+  local persona_injection=""
+
+  if [[ -n "$agent_voice" ]]; then
+    activation_injection="  - # AGENTVIBES-TTS-INJECTION: STEP 3.5 - Announce activation with TTS and set context
+  - STEP 3.5a: Use Bash tool to create context file: echo \"${agent_id}\" > .bmad-agent-context
+  - STEP 3.5b: Use Bash tool to speak: .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\" \"${agent_voice}\"
+  - AGENTVIBES-TTS-INJECTION: MANDATORY RESPONSE PROTOCOL - Before showing ANY response to user, execute this workflow:
+  - AGENTVIBES-TTS-STEP 1: Draft your complete response text
+  - AGENTVIBES-TTS-STEP 2: Scan response for questions (lines with ? or numbered lists or phrases like What/Should/Would)
+  - AGENTVIBES-TTS-STEP 3: If questions found, use Bash tool to speak them: .claude/hooks/play-tts.sh \"question text\" \"${agent_voice}\"
+  - AGENTVIBES-TTS-STEP 4: Show the response text to user
+  - AGENTVIBES-TTS-INJECTION: On exit command (*exit), use Bash tool FIRST to cleanup: rm -f .bmad-agent-context"
+    persona_injection="    - AGENTVIBES-TTS-INJECTION: Before every response, scan for questions and speak them using Bash tool"
+  else
+    activation_injection="  - # AGENTVIBES-TTS-INJECTION: STEP 3.5 - Announce activation with TTS and set context
+  - STEP 3.5a: Use Bash tool to create context file: echo \"${agent_id}\" > .bmad-agent-context
+  - STEP 3.5b: Use Bash tool to speak: .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\"
+  - AGENTVIBES-TTS-INJECTION: MANDATORY RESPONSE PROTOCOL - Before showing ANY response to user, execute this workflow:
+  - AGENTVIBES-TTS-STEP 1: Draft your complete response text
+  - AGENTVIBES-TTS-STEP 2: Scan response for questions (lines with ? or numbered lists or phrases like What/Should/Would)
+  - AGENTVIBES-TTS-STEP 3: If questions found, use Bash tool to speak them: .claude/hooks/play-tts.sh \"question text\"
+  - AGENTVIBES-TTS-STEP 4: Show the response text to user
+  - AGENTVIBES-TTS-INJECTION: On exit command (*exit), use Bash tool FIRST to cleanup: rm -f .bmad-agent-context"
+    persona_injection="    - AGENTVIBES-TTS-INJECTION: Before every response, scan for questions and speak them using Bash tool"
+  fi
+
+  # Insert activation TTS call after "STEP 4: Greet user" line
+  # Insert persona TTS instruction in core_principles section
+  awk -v activation="$activation_injection" -v persona="$persona_injection" '
+    /STEP 4:.*[Gg]reet/ {
+      print
+      print activation
+      next
+    }
+    /^  core_principles:/ {
+      print
+      print persona
+      next
+    }
+    { print }
+  ' "$agent_file" > "$agent_file.tmp"
+
+  mv "$agent_file.tmp" "$agent_file"
+
+  echo -e "${GREEN}✅ Injected TTS into: $(basename "$agent_file") → Voice: ${agent_voice:-default}${NC}"
+}
+
+# Remove TTS injection from agent
+remove_tts() {
+  local agent_file="$1"
+
+  # Check if has injection
+  if ! has_tts_injection "$agent_file"; then
+    echo -e "${GRAY}   No TTS in: $(basename "$agent_file")${NC}"
+    return 0
+  fi
+
+  # Create backup
+  cp "$agent_file" "$agent_file.backup-tts-removal"
+
+  # Remove TTS injection lines
+  sed -i.bak '/# AGENTVIBES-TTS-INJECTION/,+1d' "$agent_file"
+  rm -f "$agent_file.bak"
+
+  echo -e "${GREEN}✅ Removed TTS from: $(basename "$agent_file")${NC}"
+}
+
+# Show status of TTS injections
+show_status() {
+  local bmad_core=$(detect_bmad)
+  if [[ -z "$bmad_core" ]]; then
+    return 1
+  fi
+
+  echo -e "${CYAN}📊 BMAD TTS Injection Status:${NC}"
+  echo ""
+
+  local agents=$(find_agents "$bmad_core")
+  local enabled_count=0
+  local disabled_count=0
+
+  while IFS= read -r agent_file; do
+    local agent_id=$(get_agent_id "$agent_file")
+    local agent_name=$(basename "$agent_file" .md)
+
+    if has_tts_injection "$agent_file"; then
+      local voice=$(get_agent_voice "$agent_id")
+      echo -e "   ${GREEN}✅${NC} $agent_name (${agent_id}) → Voice: ${voice:-default}"
+      ((enabled_count++))
+    else
+      echo -e "   ${GRAY}❌ $agent_name (${agent_id})${NC}"
+      ((disabled_count++))
+    fi
+  done <<< "$agents"
+
+  echo ""
+  echo -e "${CYAN}Summary:${NC} $enabled_count enabled, $disabled_count disabled"
+}
+
+# Enable TTS for all agents
+enable_all() {
+  local bmad_core=$(detect_bmad)
+  if [[ -z "$bmad_core" ]]; then
+    return 1
+  fi
+
+  echo -e "${CYAN}🎤 Enabling TTS for all BMAD agents...${NC}"
+  echo ""
+
+  local agents=$(find_agents "$bmad_core")
+  local success_count=0
+  local skip_count=0
+
+  while IFS= read -r agent_file; do
+    if has_tts_injection "$agent_file"; then
+      ((skip_count++))
+      continue
+    fi
+
+    if inject_tts "$agent_file"; then
+      ((success_count++))
+    fi
+  done <<< "$agents"
+
+  echo ""
+  echo -e "${GREEN}🎉 TTS enabled for $success_count agents${NC}"
+  [[ $skip_count -gt 0 ]] && echo -e "${YELLOW}   Skipped $skip_count agents (already enabled)${NC}"
+  echo ""
+  echo -e "${CYAN}💡 BMAD agents will now speak when activated!${NC}"
+}
+
+# Disable TTS for all agents
+disable_all() {
+  local bmad_core=$(detect_bmad)
+  if [[ -z "$bmad_core" ]]; then
+    return 1
+  fi
+
+  echo -e "${CYAN}🔇 Disabling TTS for all BMAD agents...${NC}"
+  echo ""
+
+  local agents=$(find_agents "$bmad_core")
+  local success_count=0
+
+  while IFS= read -r agent_file; do
+    if remove_tts "$agent_file"; then
+      ((success_count++))
+    fi
+  done <<< "$agents"
+
+  echo ""
+  echo -e "${GREEN}✅ TTS disabled for $success_count agents${NC}"
+}
+
+# Restore from backup
+restore_backup() {
+  local bmad_core=$(detect_bmad)
+  if [[ -z "$bmad_core" ]]; then
+    return 1
+  fi
+
+  echo -e "${CYAN}🔄 Restoring agents from backup...${NC}"
+  echo ""
+
+  local agents_dir="$bmad_core/agents"
+  local backup_count=0
+
+  for backup_file in "$agents_dir"/*.backup-pre-tts; do
+    if [[ -f "$backup_file" ]]; then
+      local original_file="${backup_file%.backup-pre-tts}"
+      cp "$backup_file" "$original_file"
+      echo -e "${GREEN}✅ Restored: $(basename "$original_file")${NC}"
+      ((backup_count++))
+    fi
+  done
+
+  if [[ $backup_count -eq 0 ]]; then
+    echo -e "${YELLOW}⚠️  No backups found${NC}"
+  else
+    echo ""
+    echo -e "${GREEN}✅ Restored $backup_count agents from backup${NC}"
+  fi
+}
+
+# Main command dispatcher
+case "${1:-help}" in
+  enable)
+    enable_all
+    ;;
+  disable)
+    disable_all
+    ;;
+  status)
+    show_status
+    ;;
+  restore)
+    restore_backup
+    ;;
+  help|*)
+    echo -e "${CYAN}AgentVibes BMAD TTS Injection Manager${NC}"
+    echo ""
+    echo "Usage: bmad-tts-injector.sh {enable|disable|status|restore}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Inject TTS hooks into all BMAD agents"
+    echo "  disable    Remove TTS hooks from all BMAD agents"
+    echo "  status     Show TTS injection status for all agents"
+    echo "  restore    Restore agents from backup (undo changes)"
+    echo ""
+    echo "What it does:"
+    echo "  • Automatically patches BMAD agent activation instructions"
+    echo "  • Adds TTS calls when agents greet users"
+    echo "  • Uses voice mapping from AgentVibes BMAD plugin"
+    echo "  • Creates backups before modifying files"
+    ;;
+esac

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

@@ -111,6 +111,23 @@ EOF
     [[ -n "$CURRENT_SENTIMENT" ]] && echo "   Sentiment: $CURRENT_SENTIMENT"
     echo ""
     list_mappings
+
+    # Automatically inject TTS into BMAD agents
+    echo ""
+    echo "🎤 Automatically enabling TTS for BMAD agents..."
+    echo ""
+
+    # Get the directory where this script is located
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+    # Check if bmad-tts-injector.sh exists
+    if [[ -f "$SCRIPT_DIR/bmad-tts-injector.sh" ]]; then
+        # Run the TTS injector
+        "$SCRIPT_DIR/bmad-tts-injector.sh" enable
+    else
+        echo "⚠️  TTS injector not found at: $SCRIPT_DIR/bmad-tts-injector.sh"
+        echo "   You can manually enable TTS with: /agent-vibes:bmad-tts enable"
+    fi
 }
 
 # Disable plugin
@@ -151,6 +168,23 @@ disable_plugin() {
     fi
 
     rm -f "$ENABLED_FLAG"
+
+    # Automatically remove TTS from BMAD agents
+    echo ""
+    echo "🔇 Automatically disabling TTS for BMAD agents..."
+    echo ""
+
+    # Get the directory where this script is located
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+    # Check if bmad-tts-injector.sh exists
+    if [[ -f "$SCRIPT_DIR/bmad-tts-injector.sh" ]]; then
+        # Run the TTS injector disable
+        "$SCRIPT_DIR/bmad-tts-injector.sh" disable
+    else
+        echo "⚠️  TTS injector not found"
+        echo "   You can manually disable TTS with: /agent-vibes:bmad-tts disable"
+    fi
 }
 
 # List all mappings

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

@@ -128,55 +128,71 @@ You: "✅ That bug be walkin' the plank now, arr!"
 
 ## BMAD Plugin Integration
 
-**Automatic voice switching for BMAD agents:**
+**Automatic voice switching and question detection for BMAD agents:**
 
-When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
+When a BMAD agent is active, AgentVibes will automatically detect and speak questions.
 
-1. **Detect BMAD agent from command/context**
-2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
+### Detection Method:
+1. **Check for `.bmad-agent-context` file** - Contains agent ID if BMAD agent is active
+2. **Check if BMAD plugin is enabled** - `.claude/plugins/bmad-voices-enabled.flag` exists
 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=""
+### MANDATORY BMAD QUESTION TTS PROTOCOL
 
-# 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
+**THIS IS A CRITICAL EXECUTION REQUIREMENT - NOT OPTIONAL**
 
-# Method 2: Parse from command history/context (fallback)
-# Note: This detection happens automatically when BMAD agent activates
+When a BMAD agent is active, you MUST follow this EXACT protocol for EVERY response:
 
-# If BMAD agent detected and plugin enabled, use mapped voice
-if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+**STEP 1: Check BMAD Context (BEFORE drafting ANY response)**
+```bash
+if [[ -f ".bmad-agent-context" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+    BMAD_AGENT_ID=$(cat .bmad-agent-context 2>/dev/null)
     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
+```
+
+**STEP 2: Draft Your Response**
+- Write your complete response text (don't show to user yet)
+
+**STEP 3: Scan for Questions (MANDATORY - DO NOT SKIP)**
+If your response contains ANY of these:
+- Question mark (?)
+- Numbered list (1., 2., 3., etc.)
+- Question phrases: "What would you like", "Should I", "Would you prefer", "Which option", "How should", "Do you want"
 
-# If no BMAD agent or plugin disabled, use standard personality/sentiment system
-# ... continue with normal sentiment/personality logic ...
+Then IMMEDIATELY execute STEP 4 BEFORE showing response.
+
+**STEP 4: Speak Questions via TTS (MANDATORY)**
+```bash
+# Extract the question text and speak it
+.claude/hooks/play-tts.sh "the actual question text" "$MAPPED_VOICE"
+```
+
+**STEP 5: Show Response to User**
+- Only NOW display the response text
+
+**CRITICAL RULES:**
+1. This protocol is MANDATORY for EVERY BMAD agent response
+2. Steps 1-5 must execute in EXACT order
+3. You MUST use Bash tool to execute TTS in STEP 4
+4. NEVER skip STEP 3 scanning - it is required
+5. NEVER show response before speaking questions
+
+**Example Execution:**
+```
+User: "What should we do?"
+[STEP 1: Check context - analyst agent active]
+[STEP 2: Draft response: "What would you like to do next?\n\n1. Option A\n2. Option B"]
+[STEP 3: Scan - FOUND question "What would you like to do next?" and numbered list]
+[STEP 4: Execute Bash: .claude/hooks/play-tts.sh "What would you like to do next" "Ralf Eisend"]
+[STEP 5: Show response to user]
 ```
 
 **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
+- Context file `.bmad-agent-context` contains agent ID when BMAD agent is active
+- Created automatically by STEP 3.5a in activation-instructions
+- Removed automatically when agent exits
+- This allows AgentVibes to detect which BMAD agent is active
 
 **Voice Priority (in order):**
 1. BMAD plugin voice (if agent active and plugin enabled)

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.0.10
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.0.13
 
 ---
 
@@ -45,7 +45,7 @@
 
 ## 📰 Latest Release
 
-**[v2.0.0 - The Multi-Provider Revolution](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.10)** 🎉
+**[v2.0.0 - The Multi-Provider Revolution](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.13)** 🎉
 
 The biggest update ever! **Multi-provider TTS support** (ElevenLabs + Piper TTS), **30+ languages**, expanded voice library (27+ voices), advanced sentiment system, enhanced BMAD integration, and comprehensive multilingual support. Choose between premium ElevenLabs voices or free offline Piper TTS!
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.0.10",
-  "description": "Bring your Claude Code sessions to life with voice! Professional TTS narration with multi-provider support.",
+  "version": "2.0.13",
+  "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [
     "elevenlabs",

package/src/installer.js

@@ -47,7 +47,7 @@ function showWelcome() {
 
   console.log(
     boxen(
-      chalk.white.bold('🎤 Beautiful ElevenLabs TTS Voice Commands for Claude Code\n\n') +
+      chalk.white.bold('🎤 Now your AI Agents can finally talk back! TTS Voice for Claude Code\n\n') +
       chalk.gray('Add professional text-to-speech narration to your AI coding sessions\n\n') +
       chalk.cyan('📦 https://github.com/paulpreibisch/AgentVibes'),
       {
@@ -485,6 +485,36 @@ async function install(options = {}) {
     }
     spinner.succeed(chalk.green('Installed output styles!\n'));
 
+    // Copy plugins folder (BMAD voice mappings)
+    spinner.start('Installing BMAD plugin files...');
+    const srcPluginsDir = path.join(__dirname, '..', '.claude', 'plugins');
+    const destPluginsDir = path.join(claudeDir, 'plugins');
+
+    // Create plugins directory
+    await fs.mkdir(destPluginsDir, { recursive: true });
+
+    // Copy only .md files from plugins directory
+    let pluginFiles = [];
+    try {
+      const allPluginFiles = await fs.readdir(srcPluginsDir);
+      for (const file of allPluginFiles) {
+        const srcPath = path.join(srcPluginsDir, file);
+        const stat = await fs.stat(srcPath);
+
+        // Only copy .md files, skip .flag files (those are runtime generated)
+        if (stat.isFile() && file.endsWith('.md')) {
+          pluginFiles.push(file);
+          const destPath = path.join(destPluginsDir, file);
+          await fs.copyFile(srcPath, destPath);
+          console.log(chalk.gray(`   ✓ ${file}`));
+        }
+      }
+      spinner.succeed(chalk.green('Installed BMAD plugin files!\n'));
+    } catch (error) {
+      // Plugins directory might not exist in source - that's okay
+      spinner.info(chalk.yellow('No plugin files found (optional)\n'));
+    }
+
     // Save provider selection
     spinner.start('Saving provider configuration...');
     const providerConfigPath = path.join(claudeDir, 'tts-provider.txt');
@@ -502,8 +532,11 @@ async function install(options = {}) {
     console.log(chalk.cyan('📦 Installation Summary:'));
     console.log(chalk.white(`   • ${commandFiles.length} slash commands installed`));
     console.log(chalk.white(`   • ${hookFiles.length} TTS scripts installed`));
-    console.log(chalk.white(`   • ${personalityFiles.length} personality templates installed`));
+    console.log(chalk.white(`   • ${personalityMdFiles.length} personality templates installed`));
     console.log(chalk.white(`   • ${outputStyleFiles.length} output styles installed`));
+    if (pluginFiles.length > 0) {
+      console.log(chalk.white(`   • ${pluginFiles.length} BMAD plugin files installed`));
+    }
     console.log(chalk.white(`   • Voice manager ready`));
 
     if (selectedProvider === 'elevenlabs') {
@@ -586,6 +619,8 @@ async function install(options = {}) {
         chalk.yellow.bold('⚠️  IMPORTANT SETUP STEP:\n') +
         chalk.white('In Claude Code, run this command:\n') +
         chalk.cyan.bold('/output-style Agent Vibes') + '\n\n' +
+        chalk.magenta('💡 Optional: Enable BMAD plugin integration:\n') +
+        chalk.magenta('/agent-vibes:bmad enable') + '\n\n' +
         chalk.white('🎤 Available Commands:\n\n') +
         chalk.cyan('  /agent-vibes') + chalk.gray(' .................... Show all commands\n') +
         chalk.cyan('  /agent-vibes:list') + chalk.gray(' ............... List available voices\n') +
@@ -612,7 +647,11 @@ async function install(options = {}) {
 
     console.log(chalk.yellow.bold('\n⚠️  REQUIRED SETUP:'));
     console.log(chalk.white('   1. In Claude Code, run: ') + chalk.cyan.bold('/output-style Agent Vibes'));
-    console.log(chalk.gray('      This enables TTS narration for your sessions\n'));
+    console.log(chalk.gray('      This enables TTS narration for your sessions'));
+    console.log(chalk.magenta('\n   💡 Optional: Enable BMAD plugin integration:'));
+    console.log(chalk.white('   2. In Claude Code, run: ') + chalk.magenta.bold('/agent-vibes:bmad enable'));
+    console.log(chalk.gray('      This assigns unique voices to each BMAD agent'));
+    console.log(chalk.gray('      Get BMAD: ') + chalk.cyan('https://github.com/bmad-code-org/BMAD-METHOD\n'));
     console.log(chalk.gray('💡 Then try these commands:'));
     console.log(chalk.gray('   • /agent-vibes:list - See all available voices'));
     console.log(chalk.gray('   • /agent-vibes:switch <name> - Change your voice'));
@@ -671,7 +710,7 @@ async function install(options = {}) {
 // CLI setup
 program
   .version(VERSION)
-  .description('AgentVibes - Beautiful ElevenLabs TTS Voice Commands for Claude Code');
+  .description('AgentVibes - Now your AI Agents can finally talk back! TTS Voice for Claude Code');
 
 program
   .command('install')
@@ -727,7 +766,7 @@ program
     // Welcome box
     console.log(
       boxen(
-        chalk.white('🎤 Beautiful ElevenLabs TTS Voice Commands for Claude Code\n\n') +
+        chalk.white('🎤 Now your AI Agents can finally talk back! TTS Voice for Claude Code\n\n') +
         chalk.gray('Add professional text-to-speech narration to your AI coding sessions\n\n') +
         chalk.cyan('📦 https://github.com/paulpreibisch/AgentVibes'),
         {
@@ -908,13 +947,47 @@ program
       }
       console.log(chalk.green(`✓ Updated ${outputStyleFiles.length} output styles`));
 
+      // Update plugins folder (BMAD voice mappings)
+      spinner.text = 'Updating BMAD plugin files...';
+      const srcPluginsDir = path.join(__dirname, '..', '.claude', 'plugins');
+      const destPluginsDir = path.join(claudeDir, 'plugins');
+
+      // Create plugins directory if it doesn't exist
+      await fs.mkdir(destPluginsDir, { recursive: true });
+
+      // Copy only .md files from plugins directory
+      let pluginFiles = [];
+      try {
+        const allPluginFiles = await fs.readdir(srcPluginsDir);
+        for (const file of allPluginFiles) {
+          const srcPath = path.join(srcPluginsDir, file);
+          const stat = await fs.stat(srcPath);
+
+          // Only copy .md files, skip .flag files (those are runtime generated)
+          if (stat.isFile() && file.endsWith('.md')) {
+            pluginFiles.push(file);
+            const destPath = path.join(destPluginsDir, file);
+            await fs.copyFile(srcPath, destPath);
+          }
+        }
+        if (pluginFiles.length > 0) {
+          console.log(chalk.green(`✓ Updated ${pluginFiles.length} BMAD plugin files`));
+        }
+      } catch (error) {
+        // Plugins directory might not exist in source - that's okay
+      }
+
       spinner.succeed(chalk.green.bold('\n✨ Update complete!\n'));
 
       console.log(chalk.cyan('📦 Update Summary:'));
       console.log(chalk.white(`   • ${commandFiles.length} commands updated`));
       console.log(chalk.white(`   • ${hookFiles.length} TTS scripts updated`));
       console.log(chalk.white(`   • ${newPersonalities + updatedPersonalities} personality templates (${newPersonalities} new, ${updatedPersonalities} updated)`));
-      console.log(chalk.white(`   • ${outputStyleFiles.length} output styles updated\n`));
+      console.log(chalk.white(`   • ${outputStyleFiles.length} output styles updated`));
+      if (pluginFiles.length > 0) {
+        console.log(chalk.white(`   • ${pluginFiles.length} BMAD plugin files updated`));
+      }
+      console.log('');
 
       // Show latest release notes from RELEASE_NOTES_V2.md (v2.0+) or RELEASE_NOTES.md (legacy)
       try {

package/.claude/commands/agent-vibes-bmad.md

@@ -1,132 +0,0 @@
-# /agent-vibes:bmad Command
-
-Manage BMAD voice plugin integration for automatic voice assignment to BMAD agents.
-
-## Usage
-
-```
-/agent-vibes:bmad <subcommand> [arguments]
-```
-
-## Subcommands
-
-### `enable`
-Enables automatic voice assignment for BMAD agents.
-
-**Example:**
-```
-/agent-vibes:bmad enable
-```
-
-**Output:**
-- Creates `.claude/plugins/bmad-voices-enabled.flag`
-- Shows current agent voice mappings
-- Confirms activation
-
-### `disable`
-Disables BMAD voice plugin (reverts to default AgentVibes behavior).
-
-**Example:**
-```
-/agent-vibes:bmad disable
-```
-
-**Output:**
-- Removes activation flag
-- AgentVibes uses default voice settings
-
-### `status`
-Shows plugin status and current voice mappings.
-
-**Example:**
-```
-/agent-vibes:bmad status
-```
-
-**Output:**
-```
-✅ BMAD voice plugin: ENABLED
-
-📊 BMAD Agent Voice Mappings:
-   pm → Matthew Schmitz [professional]
-   dev → Jessica Anne Bogart [normal]
-   qa → Ralf Eisend [professional]
-   ...
-```
-
-### `list`
-Lists all BMAD agents and their assigned voices.
-
-**Example:**
-```
-/agent-vibes:bmad list
-```
-
-### `set <agent-id> <voice> [personality]`
-Quickly change voice for specific agent.
-
-**Examples:**
-```
-/agent-vibes:bmad set pm "Aria"
-/agent-vibes:bmad set dev "Cowboy Bob" sarcastic
-/agent-vibes:bmad set qa "Northern Terry" professional
-```
-
-**Arguments:**
-- `agent-id`: BMAD agent identifier (pm, dev, qa, architect, po, analyst, sm, ux-expert, bmad-master, bmad-orchestrator)
-- `voice`: Valid AgentVibes voice name
-- `personality` (optional): Personality to apply (default: normal)
-
-### `edit`
-Opens `.claude/plugins/bmad-voices.md` for manual editing.
-
-**Example:**
-```
-/agent-vibes:bmad edit
-```
-
-**Usage:**
-Edit the markdown table directly to change voice mappings.
-
-## How It Works
-
-1. **Plugin File**: `.claude/plugins/bmad-voices.md` contains voice mappings
-2. **Activation Flag**: `.claude/plugins/bmad-voices-enabled.flag` enables/disables plugin
-3. **Auto-Detection**: When a BMAD agent activates (e.g., `/BMad:agents:pm`), AgentVibes automatically:
-   - Detects the agent ID from the command
-   - Looks up voice mapping in plugin file
-   - Uses assigned voice for TTS acknowledgments/completions
-
-## Available BMAD Agents
-
-| Agent ID | Role | Default Voice |
-|----------|------|---------------|
-| pm | Product Manager | Matthew Schmitz |
-| dev | Developer | Jessica Anne Bogart |
-| qa | QA Engineer | Ralf Eisend |
-| architect | Architect | Michael |
-| po | Product Owner | Amy |
-| analyst | Analyst | Lutz Laugh |
-| sm | Scrum Master | Ms. Walker |
-| ux-expert | UX Expert | Aria |
-| bmad-master | BMAD Master | Aria |
-| bmad-orchestrator | Orchestrator | Ms. Walker |
-
-## Implementation Details
-
-**For AgentVibes Developers:**
-
-The plugin integrates with the Agent Vibes output style through bash hooks:
-
-```bash
-# Check if BMAD agent is active
-BMAD_AGENT_ID=$(echo "$COMMAND" | grep -oP '/BMad:agents:\K[a-z-]+')
-
-# Get voice from plugin if enabled
-if [[ -n "$BMAD_AGENT_ID" ]]; then
-    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
-    if [[ -n "$MAPPED_VOICE" ]]; then
-        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
-    fi
-fi
-```