BMAD-METHOD/TESTING.md

Testing AgentVibes Party Mode (PR #934)

This guide helps you test the AgentVibes integration that adds multi-agent party mode with unique voices for each BMAD agent.

Quick Start

We've created an automated test script that handles everything for you:

curl -fsSL 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

What the Script Does

The automated script will:

1. Clone the BMAD repository
2. Checkout the PR branch with party mode features
3. Install BMAD CLI tools locally
4. Create a test BMAD project
5. Install AgentVibes TTS system
6. Configure unique voices for each agent
7. Verify the installation

Prerequisites

• Node.js and npm installed
• Git installed
• ~500MB free disk space
• 10-15 minutes for complete setup

Manual Testing (Alternative)

If you prefer manual installation:

1. Clone and Setup BMAD

git clone https://github.com/paulpreibisch/BMAD-METHOD.git
cd BMAD-METHOD
git fetch origin pull/934/head:agentvibes-party-mode
git checkout agentvibes-party-mode
cd tools/cli
npm install
npm link

2. Create Test Project

mkdir -p ~/bmad-test-project
cd ~/bmad-test-project
bmad install

When prompted:

• Enable TTS for agents? → Yes
• The installer will automatically prompt you to install AgentVibes

3. Test Party Mode

cd ~/bmad-test-project
claude-code

In Claude Code, run:

/bmad:core:workflows:party-mode

Each BMAD agent should speak with a unique voice!

Verification

After installation, verify:

✅ Voice map file exists: .bmad/_cfg/agent-voice-map.csv ✅ BMAD TTS hooks exist: .claude/hooks/bmad-speak.sh ✅ Each agent has a unique voice assigned ✅ Party mode works with distinct voices

Troubleshooting

No audio?

• Check: .claude/hooks/play-tts.sh exists
• Test current voice: /agent-vibes:whoami

Same voice for all agents?

• Check: .bmad/_cfg/agent-voice-map.csv has different voices
• List available voices: /agent-vibes:list

Report Issues

Found a bug? Report it on the PR: https://github.com/bmad-code-org/BMAD-METHOD/pull/934

Cleanup

To remove the test installation:

# Remove test directory
rm -rf ~/bmad-test-project  # or your custom test directory

# Unlink BMAD CLI (optional)
cd ~/BMAD-METHOD/tools/cli
npm unlink