BMAD-METHOD/.claude/commands/agent-vibes/bmad.md

/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:

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:

# 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