agentvibes 2.12.1 → 2.12.3

package/.claude/commands/bmad/bmm/workflows/research.md

@@ -0,0 +1,13 @@
+---
+description: 'Adaptive research workflow supporting multiple research types: market research, deep research prompt generation, technical/architecture evaluation, competitive intelligence, user research, and domain analysis'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/1-analysis/research/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/1-analysis/research/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/retrospective.md

@@ -0,0 +1,13 @@
+---
+description: 'Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/sprint-planning.md

@@ -0,0 +1,13 @@
+---
+description: 'Generate and manage the sprint status tracking file for Phase 4 implementation, extracting all epics and stories from epic files and tracking their status through the development lifecycle'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/story-context.md

@@ -0,0 +1,13 @@
+---
+description: 'Assemble a dynamic Story Context XML by pulling latest documentation and existing code/library artifacts relevant to a drafted story'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/4-implementation/story-context/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/4-implementation/story-context/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/story-done.md

@@ -0,0 +1,13 @@
+---
+description: 'Marks a story as done (DoD complete) and moves it from its current status → DONE in the status file. Advances the story queue. Simple status-update workflow with no searching required.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/4-implementation/story-done/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/4-implementation/story-done/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/story-ready.md

@@ -0,0 +1,13 @@
+---
+description: 'Marks a drafted story as ready for development and moves it from TODO → IN PROGRESS in the status file. Simple status-update workflow with no searching required.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/tech-spec.md

@@ -0,0 +1,13 @@
+---
+description: 'Technical specification workflow for quick-flow projects. Creates focused tech spec and generates epic + stories (1 story for simple changes, 2-5 stories for features). Tech-spec only - no PRD needed.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/workflow-init.md

@@ -0,0 +1,13 @@
+---
+description: 'Initialize a new BMM project by determining level, type, and creating workflow path'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/workflow-status/init/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/workflow-status/init/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/bmm/workflows/workflow-status.md

@@ -0,0 +1,13 @@
+---
+description: 'Lightweight status checker - answers "what should I do now?" for any agent. Reads YAML status file for workflow tracking. Use workflow-init for new projects.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/bmm/workflows/workflow-status/workflow.yaml
+3. Pass the yaml path .bmad/bmm/workflows/workflow-status/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/core/agents/bmad-master.md

@@ -0,0 +1,14 @@
+---
+name: 'bmad-master'
+description: 'bmad-master agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @.bmad/core/agents/bmad-master.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>

package/.claude/commands/bmad/core/tasks/advanced-elicitation.md

@@ -0,0 +1,9 @@
+---
+description: 'When called from workflow'
+---
+
+# Advanced Elicitation
+
+LOAD and execute the task at: .bmad/core/tasks/advanced-elicitation.xml
+
+Follow all instructions in the task file exactly as written.

package/.claude/commands/bmad/core/tasks/index-docs.md

@@ -0,0 +1,9 @@
+---
+description: 'Generates or updates an index.md of all documents in the specified directory'
+---
+
+# Index Docs
+
+LOAD and execute the task at: .bmad/core/tasks/index-docs.xml
+
+Follow all instructions in the task file exactly as written.

package/.claude/commands/bmad/core/tools/shard-doc.md

@@ -0,0 +1,9 @@
+---
+description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections'
+---
+
+# Shard Document
+
+LOAD and execute the tool at: .bmad/core/tools/shard-doc.xml
+
+Follow all instructions in the tool file exactly as written.

package/.claude/commands/bmad/core/workflows/brainstorming.md

@@ -0,0 +1,13 @@
+---
+description: 'Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/core/workflows/brainstorming/workflow.yaml
+3. Pass the yaml path .bmad/core/workflows/brainstorming/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/commands/bmad/core/workflows/party-mode.md

@@ -0,0 +1,13 @@
+---
+description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @.bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @.bmad/core/workflows/party-mode/workflow.yaml
+3. Pass the yaml path .bmad/core/workflows/party-mode/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

package/.claude/github-star-reminder.txt

@@ -0,0 +1 @@
+20251121

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

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-party-manager.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 BMAD Party Mode Voice Integration Manager
+# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
+# @architecture Opt-out flag management, auto-detection, status reporting
+# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
+# @entrypoints /agent-vibes:bmad-party slash command
+# @patterns Auto-enable with opt-out, graceful degradation, feature detection
+# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
+
+# Fix locale warnings
+export LC_ALL=C
+
+PLUGIN_DIR=".claude/plugins"
+DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
+BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
+
+# Colors
+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
+
+#
+# @function is_bmad_installed
+# @context Check if BMAD v6 is installed
+# @returns 0=installed, 1=not installed
+#
+is_bmad_installed() {
+  [[ -f "$BMAD_MANIFEST" ]]
+}
+
+#
+# @function is_bmad_voices_enabled
+# @context Check if BMAD voice plugin is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_bmad_voices_enabled() {
+  [[ -f "$BMAD_VOICES_FLAG" ]]
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if party mode voice integration is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_party_mode_enabled() {
+  # Disabled if opt-out flag exists
+  [[ -f "$DISABLE_FLAG" ]] && return 1
+
+  # Enabled if BMAD + voice plugin active
+  is_bmad_installed && is_bmad_voices_enabled
+}
+
+#
+# @function show_status
+# @context Display current party mode voice integration status
+#
+show_status() {
+  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Check BMAD installation
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ BMAD not installed${NC}"
+    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
+    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
+
+  # Check voice plugin
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
+
+  # Check party mode status
+  if is_party_mode_enabled; then
+    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
+    echo ""
+    echo -e "${CYAN}How it works:${NC}"
+    echo "  When you run /bmad:core:workflows:party-mode,"
+    echo "  each agent speaks with their unique voice:"
+    echo ""
+    echo "  🏗️  Winston (Architect) → Michael"
+    echo "  📋 John (PM) → Jessica Anne Bogart"
+    echo "  💻 Amelia (Dev) → Matthew Schmitz"
+    echo "  📊 Mary (Analyst) → kristin"
+    echo "  ... and more!"
+    echo ""
+    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
+    echo ""
+    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function enable_party_mode
+# @context Enable party mode voice integration (remove opt-out flag)
+#
+enable_party_mode() {
+  # Verify prerequisites
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
+    echo -e "${GRAY}   Install BMAD v6 first${NC}"
+    return 1
+  fi
+
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
+    return 1
+  fi
+
+  # Remove opt-out flag if it exists
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    rm -f "$DISABLE_FLAG"
+    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
+    echo ""
+    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
+    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
+  else
+    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
+    echo ""
+    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function disable_party_mode
+# @context Disable party mode voice integration (create opt-out flag)
+#
+disable_party_mode() {
+  mkdir -p "$PLUGIN_DIR"
+
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
+    return 0
+  fi
+
+  # Create opt-out flag
+  touch "$DISABLE_FLAG"
+
+  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
+  echo ""
+  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
+  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
+  echo ""
+}
+
+# Main command dispatcher
+case "${1:-status}" in
+  enable)
+    enable_party_mode
+    ;;
+  disable)
+    disable_party_mode
+    ;;
+  status)
+    show_status
+    ;;
+  *)
+    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
+    echo ""
+    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Enable party mode voice integration"
+    echo "  disable    Disable party mode voice integration (opt-out)"
+    echo "  status     Show current status and configuration"
+    echo ""
+    echo "Party Mode Voice Integration:"
+    echo "  • Auto-enabled when BMAD v6 detected"
+    echo "  • Each agent speaks with unique voice during party mode"
+    echo "  • Opt-out available via disable command"
+    ;;
+esac

package/.claude/hooks/stop.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/user-prompt-output.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 Auto-detects emoji markers and BMAD party mode in Claude's output and triggers TTS
+# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and BMAD party mode agent dialogues
+# @architecture Stdin reader, regex matcher, async TTS trigger, agent voice switching
+# @dependencies play-tts.sh, tts-verbosity.txt, bmad-voice-manager.sh, .bmad/_cfg/agent-manifest.csv
+# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
+# @patterns Text stream processing, background job execution, marker-based triggers, party mode detection
+# @related session-start-tts.sh, verbosity-manager.sh, bmad-voice-manager.sh, Issue #32, Issue #33
+# @aiNotes This hook enables natural emoji-based TTS + BMAD party mode voice switching
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract transcript path from JSON
+TRANSCRIPT_PATH=$(echo "$INPUT" | grep -o '"transcript_path":"[^"]*"' | cut -d'"' -f4)
+
+# If no transcript path, exit (shouldn't happen but be safe)
+[[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]] && exit 0
+
+# Get the last assistant message from transcript
+# The transcript is JSONL format - each line is a JSON object
+# Extract all text content blocks from the last message and join them
+LAST_RESPONSE=$(tail -1 "$TRANSCRIPT_PATH" | jq -r '.message.content[] | select(.type == "text") | .text' 2>/dev/null)
+
+# Get verbosity level
+VERBOSITY=$(cat "$PROJECT_ROOT/.claude/tts-verbosity.txt" 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+
+# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
+[[ ! -f "$PLAY_TTS" ]] && exit 0
+
+#
+# @function extract_and_speak
+# @context Extracts text after emoji markers and triggers TTS asynchronously
+# @architecture Uses grep to find markers, extracts text, launches TTS in background
+# @dependencies play-tts.sh
+# @entrypoints Called based on verbosity level
+# @aiNotes Background execution (&) prevents blocking Claude's output
+#
+extract_and_speak() {
+  local pattern="$1"
+
+  # Extract lines matching the pattern
+  # Pattern format: "emoji text" or "emoji [text]"
+  while IFS= read -r line; do
+    # Try to extract text after emoji
+    # Handles formats: "💭 text", "💭 [text]", "💭text"
+    if echo "$line" | grep -qE "$pattern"; then
+      # Extract everything after the emoji (and optional space/bracket)
+      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
+
+      # Skip if text is empty or too short
+      [[ -z "$text" || ${#text} -lt 3 ]] && continue
+
+      # Speak it in background (don't block)
+      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
+    fi
+  done <<< "$LAST_RESPONSE"
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if BMAD party mode voice integration is enabled
+# @architecture Auto-enable for BMAD users, opt-out via disable flag
+# @dependencies .bmad/_cfg/agent-manifest.csv, .claude/config/bmad-voices-enabled.flag
+# @returns 0=enabled, 1=disabled
+# @aiNotes Auto-enabled when BMAD detected, respects opt-out flag for user control
+#
+is_party_mode_enabled() {
+  # Explicit opt-out takes precedence
+  [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-party-mode-disabled.flag" ]] && return 1
+
+  # Auto-enable if BMAD detected + voice plugin enabled
+  if [[ -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]] && \
+     [[ -f "$PROJECT_ROOT/.claude/config/bmad-voices-enabled.flag" ]]; then
+    return 0
+  fi
+
+  return 1
+}
+
+#
+# @function map_display_name_to_agent_id
+# @context Map BMAD agent display name to agent ID for voice lookup
+# @architecture Parses agent-manifest.csv, matches displayName column to name column
+# @dependencies .bmad/_cfg/agent-manifest.csv
+# @param $1 Display name (e.g., "Winston", "John", "Amelia")
+# @returns Agent ID (e.g., "architect", "pm", "dev") or empty string if not found
+# @aiNotes Case-insensitive matching, handles quoted CSV values
+#
+map_display_name_to_agent_id() {
+  local display_name="$1"
+
+  # Check for BMAD v6 manifest
+  if [[ ! -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]]; then
+    return 1
+  fi
+
+  # CSV format: name,displayName,title,icon,role,...
+  # Extract 'name' (column 1) where displayName (column 2) matches
+  # Case-insensitive grep, remove quotes, get first match
+  local agent_id=$(grep -i ",\"*${display_name}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
+                   head -1 | \
+                   cut -d',' -f1 | \
+                   tr -d '"')
+
+  echo "$agent_id"
+}
+
+#
+# @function detect_and_speak_party_mode_dialogue
+# @context Detect BMAD party mode agent responses and speak with agent-specific voices
+# @architecture Pattern matches [Agent Name]: format, maps to agent voice, triggers TTS
+# @dependencies map_display_name_to_agent_id, bmad-voice-manager.sh, play-tts.sh
+# @aiNotes Runs in background to avoid blocking, graceful fallback for unmapped agents
+#
+detect_and_speak_party_mode_dialogue() {
+  # Pattern: [Agent Name]: dialogue
+  # Must start at beginning of line, agent name can include spaces/hyphens
+  while IFS= read -r line; do
+    if echo "$line" | grep -qE '^\[([A-Za-z\s-]+)\]:'; then
+      # Extract agent display name and dialogue
+      local agent_name=$(echo "$line" | sed -E 's/^\[([A-Za-z\s-]+)\]:.*/\1/')
+      local dialogue=$(echo "$line" | sed -E 's/^\[[^]]+\]:[[:space:]]*//')
+
+      # Skip if dialogue is empty or too short
+      [[ -z "$dialogue" || ${#dialogue} -lt 3 ]] && continue
+
+      # Map display name to agent ID
+      local agent_id=$(map_display_name_to_agent_id "$agent_name")
+
+      # Get agent's voice from bmad-voice-manager.sh
+      local agent_voice=""
+      if [[ -n "$agent_id" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+        agent_voice=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$agent_id" 2>/dev/null)
+      fi
+
+      # Speak with agent's voice (or default if not mapped)
+      # Run in foreground to ensure audio completes
+      if [[ -n "$agent_voice" ]]; then
+        bash "$PLAY_TTS" "$dialogue" "$agent_voice" &
+      else
+        # Fallback to default voice if agent not in voice mapping
+        bash "$PLAY_TTS" "$dialogue" &
+      fi
+    fi
+  done
+}
+
+# Process based on verbosity level
+case "$VERBOSITY" in
+  high)
+    # HIGH: Speak ALL markers (💭 🤔 ✓)
+    # Don't speak ✅ here - that's handled by manual TTS completion call
+    extract_and_speak "💭|🤔|✓"
+    ;;
+
+  medium)
+    # MEDIUM: Speak decisions and findings (🤔 ✓)
+    extract_and_speak "🤔|✓"
+    ;;
+
+  low)
+    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
+    # Don't process any markers
+    ;;
+esac
+
+# BMAD Party Mode Integration (Issue #33)
+# Auto-enabled for BMAD users, opt-out available
+if is_party_mode_enabled; then
+  # Detect party mode activation announcement
+  if echo "$LAST_RESPONSE" | grep -q "🎉 PARTY MODE ACTIVATED! 🎉"; then
+    bash "$PLAY_TTS" "Party Mode Activated! All agents are here for a group discussion!" &
+  fi
+
+  # Detect agent dialogues
+  echo "$LAST_RESPONSE" | detect_and_speak_party_mode_dialogue
+fi
+
+# Exit successfully
+exit 0

package/.claude/piper-voices-dir.txt

@@ -0,0 +1 @@
+/home/fire/.claude/piper-voices