agentvibes 2.9.7 → 2.12.0

package/test-migration.sh

@@ -0,0 +1,539 @@
+#!/usr/bin/env bash
+#
+# AgentVibes Migration Testing Script
+# Tests the migration from .claude/config/ and .claude/plugins/ to .agentvibes/
+#
+# Usage: ./test-migration.sh
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Test counters
+TESTS_RUN=0
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+# Cleanup function
+cleanup() {
+    if [[ -n "${TEST_DIR:-}" ]] && [[ -d "$TEST_DIR" ]]; then
+        echo ""
+        echo -e "${YELLOW}🧹 Cleaning up test directory...${NC}"
+        rm -rf "$TEST_DIR"
+        echo -e "${GREEN}✓ Cleanup complete${NC}"
+    fi
+}
+
+# Register cleanup on exit
+trap cleanup EXIT
+
+# Helper: Assert file exists
+assert_file_exists() {
+    local file="$1"
+    local description="$2"
+
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if [[ -f "$file" ]]; then
+        echo -e "  ${GREEN}✓ PASS:${NC} $description"
+        echo -e "    ${CYAN}→${NC} $file"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Expected: $file"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+# Helper: Assert file does NOT exist
+assert_file_not_exists() {
+    local file="$1"
+    local description="$2"
+
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if [[ ! -f "$file" ]]; then
+        echo -e "  ${GREEN}✓ PASS:${NC} $description"
+        echo -e "    ${CYAN}→${NC} File correctly absent: $file"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} $description"
+        echo -e "    ${CYAN}→${NC} File should not exist: $file"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+# Helper: Assert directory exists
+assert_dir_exists() {
+    local dir="$1"
+    local description="$2"
+
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if [[ -d "$dir" ]]; then
+        echo -e "  ${GREEN}✓ PASS:${NC} $description"
+        echo -e "    ${CYAN}→${NC} $dir"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Expected: $dir"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+# Helper: Assert directory does NOT exist
+assert_dir_not_exists() {
+    local dir="$1"
+    local description="$2"
+
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if [[ ! -d "$dir" ]]; then
+        echo -e "  ${GREEN}✓ PASS:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Directory correctly absent: $dir"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Directory should not exist: $dir"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+# Helper: Assert file contains text
+assert_file_contains() {
+    local file="$1"
+    local pattern="$2"
+    local description="$3"
+
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if grep -q "$pattern" "$file" 2>/dev/null; then
+        echo -e "  ${GREEN}✓ PASS:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Found pattern in $file"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} $description"
+        echo -e "    ${CYAN}→${NC} Pattern not found: $pattern in $file"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🧪 AgentVibes Migration Test Suite"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${BLUE}This script tests the migration from:${NC}"
+echo "  • .claude/config/ → .agentvibes/config/"
+echo "  • .claude/plugins/ → .agentvibes/bmad/"
+echo ""
+echo -e "${BLUE}Test scenarios:${NC}"
+echo "  1. Fresh Install - New .agentvibes/ structure"
+echo "  2. Upgrade from v2.9.x - Auto-migration"
+echo "  3. Manual Migration - Script execution"
+echo "  4. BMAD Integration - Voice mappings"
+echo "  5. Pretext Configuration - Location"
+echo "  6. No Old Config - No errors"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+read -p "Press Enter to start tests..."
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 1: Fresh Install - Verify .agentvibes/ is created directly
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📦 Test 1: Fresh Install"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: npx agentvibes install (fresh)${NC}"
+echo ""
+
+# Create clean test directory
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Run installer (simulated - we'll just copy files)
+echo "Simulating fresh install..."
+mkdir -p .claude/{commands,hooks,personalities,output-styles}
+mkdir -p .agentvibes/{bmad,config}
+
+# Copy essential files from source
+cp "$SCRIPT_DIR/.claude/hooks/migrate-to-agentvibes.sh" .claude/hooks/ 2>/dev/null || true
+cp "$SCRIPT_DIR/.claude/hooks/bmad-voice-manager.sh" .claude/hooks/ 2>/dev/null || true
+
+# Create fresh config files in new location
+echo '{"pretext": "AgentVibes"}' > .agentvibes/config/agentvibes.json
+echo '{"version": "1.0"}' > .agentvibes/config/personality-voice-defaults.default.json
+touch .agentvibes/bmad/bmad-voices-enabled.flag
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+# Assertions
+assert_dir_exists ".agentvibes" "Created .agentvibes/ directory"
+assert_dir_exists ".agentvibes/bmad" "Created .agentvibes/bmad/ subdirectory"
+assert_dir_exists ".agentvibes/config" "Created .agentvibes/config/ subdirectory"
+assert_file_exists ".agentvibes/config/agentvibes.json" "Created agentvibes.json in new location"
+assert_dir_not_exists ".claude/plugins" "Did NOT create .claude/plugins/"
+assert_file_not_exists ".claude/config/agentvibes.json" "Did NOT create config in old location"
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 2: Upgrade from v2.9.x - Verify auto-migration
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔄 Test 2: Upgrade from v2.9.x (Auto-Migration)"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: Upgrade path with old config${NC}"
+echo ""
+
+# Clean and recreate test directory
+cd /tmp
+rm -rf "$TEST_DIR"
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Simulate old v2.9.x installation
+echo "Creating v2.9.x directory structure..."
+mkdir -p .claude/{config,plugins,hooks}
+
+# Create old config files
+echo '{"pretext": "OldPretext"}' > .claude/config/agentvibes.json
+echo '{"version": "1.0"}' > .claude/config/personality-voice-defaults.default.json
+echo "# Personality README" > .claude/config/README-personality-defaults.md
+touch .claude/plugins/bmad-voices-enabled.flag
+touch .claude/plugins/bmad-party-mode-disabled.flag
+
+# Copy migration script
+cp "$SCRIPT_DIR/.claude/hooks/migrate-to-agentvibes.sh" .claude/hooks/
+
+echo ""
+echo -e "${YELLOW}Running migration script...${NC}"
+echo ""
+
+# Run migration
+bash .claude/hooks/migrate-to-agentvibes.sh
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+# Assertions - Files should be in new location
+assert_file_exists ".agentvibes/config/agentvibes.json" "Migrated agentvibes.json"
+assert_file_exists ".agentvibes/config/personality-voice-defaults.default.json" "Migrated personality defaults"
+assert_file_exists ".agentvibes/config/README-personality-defaults.md" "Migrated README"
+assert_file_exists ".agentvibes/bmad/bmad-voices-enabled.flag" "Migrated BMAD enabled flag"
+assert_file_exists ".agentvibes/bmad/bmad-party-mode-disabled.flag" "Migrated party mode flag"
+
+# Old files should be gone
+assert_file_not_exists ".claude/config/agentvibes.json" "Removed old agentvibes.json"
+assert_file_not_exists ".claude/plugins/bmad-voices-enabled.flag" "Removed old BMAD flag"
+assert_dir_not_exists ".claude/plugins" "Removed empty .claude/plugins/"
+
+# Check content preserved
+assert_file_contains ".agentvibes/config/agentvibes.json" "OldPretext" "Preserved pretext value"
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 3: Manual Migration - Script execution
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🛠️  Test 3: Manual Migration Script"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: Manual execution of migrate-to-agentvibes.sh${NC}"
+echo ""
+
+# Clean and recreate
+cd /tmp
+rm -rf "$TEST_DIR"
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Setup old structure with mixed old/new
+mkdir -p .claude/{config,plugins,hooks}
+mkdir -p .agentvibes/{bmad,config}
+
+# Some files in old location, some already migrated
+echo '{"pretext": "Test"}' > .claude/config/agentvibes.json
+touch .agentvibes/bmad/bmad-voices-enabled.flag  # Already migrated
+touch .claude/plugins/bmad-party-mode-disabled.flag  # Not yet migrated
+
+cp "$SCRIPT_DIR/.claude/hooks/migrate-to-agentvibes.sh" .claude/hooks/
+
+echo ""
+echo -e "${YELLOW}Running migration script...${NC}"
+echo ""
+
+bash .claude/hooks/migrate-to-agentvibes.sh
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+# Both should now be in new location
+assert_file_exists ".agentvibes/config/agentvibes.json" "Migrated remaining config"
+assert_file_exists ".agentvibes/bmad/bmad-party-mode-disabled.flag" "Migrated remaining flag"
+assert_file_not_exists ".claude/config/agentvibes.json" "Removed old config"
+assert_file_not_exists ".claude/plugins/bmad-party-mode-disabled.flag" "Removed old flag"
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 4: BMAD Integration - Voice mappings work
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🎤 Test 4: BMAD Integration"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: BMAD voice mappings in new location${NC}"
+echo ""
+
+cd /tmp
+rm -rf "$TEST_DIR"
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Setup BMAD structure
+mkdir -p .agentvibes/bmad
+mkdir -p .claude/hooks
+mkdir -p .bmad/_cfg
+
+# Create voice mapping file
+cat > .agentvibes/bmad/bmad-voices.md <<'EOF'
+| Agent ID | Agent Name | Intro | ElevenLabs Voice | Piper Voice | Personality |
+|----------|------------|-------|------------------|-------------|-------------|
+| pm | John | Product Manager | Jessica Anne Bogart | en_US-lessac-medium | professional |
+| dev | Sarah | Developer | Matthew Schmitz | en_US-amy-medium | friendly |
+EOF
+
+# Create CSV version (v6 format)
+cat > .bmad/_cfg/agent-voice-map.csv <<'EOF'
+pm,en_US-lessac-medium
+dev,en_US-amy-medium
+EOF
+
+touch .agentvibes/bmad/bmad-voices-enabled.flag
+
+# Copy bmad-voice-manager.sh
+cp "$SCRIPT_DIR/.claude/hooks/bmad-voice-manager.sh" .claude/hooks/ 2>/dev/null || true
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+# Verify structure
+assert_file_exists ".agentvibes/bmad/bmad-voices.md" "Created voice mapping file"
+assert_file_exists ".agentvibes/bmad/bmad-voices-enabled.flag" "Created enabled flag"
+assert_file_contains ".agentvibes/bmad/bmad-voices.md" "pm" "Voice mapping contains pm agent"
+assert_file_contains ".agentvibes/bmad/bmad-voices.md" "dev" "Voice mapping contains dev agent"
+
+# Test bmad-voice-manager.sh if available
+if [[ -f ".claude/hooks/bmad-voice-manager.sh" ]]; then
+    # Test get-voice function
+    VOICE=$(bash .claude/hooks/bmad-voice-manager.sh get-voice pm)
+    if [[ -n "$VOICE" ]]; then
+        echo -e "  ${GREEN}✓ PASS:${NC} bmad-voice-manager.sh can read from new location"
+        echo -e "    ${CYAN}→${NC} Retrieved voice: $VOICE"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} bmad-voice-manager.sh could not read voice"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+    fi
+    TESTS_RUN=$((TESTS_RUN + 1))
+fi
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 5: Pretext - Uses new location
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📝 Test 5: Pretext Configuration"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: Pretext reads from .agentvibes/config/${NC}"
+echo ""
+
+cd /tmp
+rm -rf "$TEST_DIR"
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Setup new structure
+mkdir -p .agentvibes/config
+mkdir -p .claude/hooks
+
+# Create pretext config
+echo '{"pretext": "MyProject"}' > .agentvibes/config/agentvibes.json
+
+# Copy play-tts-elevenlabs.sh to test
+cp "$SCRIPT_DIR/.claude/hooks/play-tts-elevenlabs.sh" .claude/hooks/ 2>/dev/null || true
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+assert_file_exists ".agentvibes/config/agentvibes.json" "Pretext config in new location"
+assert_file_contains ".agentvibes/config/agentvibes.json" "MyProject" "Pretext value set correctly"
+
+# Test if play-tts-elevenlabs.sh references new path
+if [[ -f ".claude/hooks/play-tts-elevenlabs.sh" ]]; then
+    if grep -q ".agentvibes/config" ".claude/hooks/play-tts-elevenlabs.sh"; then
+        echo -e "  ${GREEN}✓ PASS:${NC} play-tts-elevenlabs.sh uses new config path"
+        echo -e "    ${CYAN}→${NC} References .agentvibes/config/"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+    else
+        echo -e "  ${RED}✗ FAIL:${NC} play-tts-elevenlabs.sh does not reference new path"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+    fi
+    TESTS_RUN=$((TESTS_RUN + 1))
+fi
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST 6: No Old Config - No errors
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Test 6: No Old Config (No Migration Needed)"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${CYAN}Testing: Migration script with no old config${NC}"
+echo ""
+
+cd /tmp
+rm -rf "$TEST_DIR"
+TEST_DIR=$(mktemp -d -t agentvibes-test-XXXXXX)
+cd "$TEST_DIR"
+echo -e "${BLUE}Test directory: $TEST_DIR${NC}"
+echo ""
+
+# Setup only new structure (no old config)
+mkdir -p .agentvibes/{bmad,config}
+mkdir -p .claude/hooks
+
+# Create only new config
+echo '{"pretext": "NewInstall"}' > .agentvibes/config/agentvibes.json
+
+cp "$SCRIPT_DIR/.claude/hooks/migrate-to-agentvibes.sh" .claude/hooks/
+
+echo ""
+echo -e "${YELLOW}Running migration script (should be no-op)...${NC}"
+echo ""
+
+# Run migration - should complete without errors
+if bash .claude/hooks/migrate-to-agentvibes.sh > /tmp/migration-output.txt 2>&1; then
+    echo -e "  ${GREEN}✓ PASS:${NC} Migration script ran without errors"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+else
+    echo -e "  ${RED}✗ FAIL:${NC} Migration script failed"
+    cat /tmp/migration-output.txt
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+fi
+TESTS_RUN=$((TESTS_RUN + 1))
+
+echo ""
+echo -e "${YELLOW}Running assertions...${NC}"
+echo ""
+
+# Config should still exist and be unchanged
+assert_file_exists ".agentvibes/config/agentvibes.json" "Config file still exists"
+assert_file_contains ".agentvibes/config/agentvibes.json" "NewInstall" "Config unchanged"
+assert_dir_not_exists ".claude/plugins" ".claude/plugins/ not created"
+assert_file_not_exists ".claude/config/agentvibes.json" "No old config created"
+
+echo ""
+
+#═══════════════════════════════════════════════════════════════
+# TEST SUMMARY
+#═══════════════════════════════════════════════════════════════
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📊 Test Summary"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "  Total Tests:  $TESTS_RUN"
+echo -e "  ${GREEN}Passed:       $TESTS_PASSED${NC}"
+if [[ $TESTS_FAILED -gt 0 ]]; then
+    echo -e "  ${RED}Failed:       $TESTS_FAILED${NC}"
+else
+    echo "  Failed:       $TESTS_FAILED"
+fi
+echo ""
+
+# Calculate percentage
+if [[ $TESTS_RUN -gt 0 ]]; then
+    PERCENTAGE=$((TESTS_PASSED * 100 / TESTS_RUN))
+    echo "  Success Rate: ${PERCENTAGE}%"
+    echo ""
+fi
+
+# Final verdict
+if [[ $TESTS_FAILED -eq 0 ]]; then
+    echo -e "${GREEN}✅ ALL TESTS PASSED!${NC}"
+    echo ""
+    echo "The migration system is working correctly. All scenarios tested:"
+    echo "  ✓ Fresh install creates .agentvibes/ directly"
+    echo "  ✓ Upgrade auto-migrates old config"
+    echo "  ✓ Manual migration script works"
+    echo "  ✓ BMAD integration uses new paths"
+    echo "  ✓ Pretext config in new location"
+    echo "  ✓ No errors when no migration needed"
+    EXIT_CODE=0
+else
+    echo -e "${RED}❌ SOME TESTS FAILED${NC}"
+    echo ""
+    echo "Please review the failures above and fix the issues."
+    EXIT_CODE=1
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+exit $EXIT_CODE

package/.bmad/_cfg/agent-manifest.csv

@@ -1,11 +0,0 @@
-name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
-"bmad-master","BMad Master","BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator","🧙","Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator","Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.","Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.","Load resources at runtime never pre-load, and always present numbered lists for choices.","core",".bmad/core/agents/bmad-master.md"
-"analyst","Mary","Business Analyst","📊","Strategic Business Analyst + Requirements Expert","Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague needs into actionable specs.","Systematic and probing. Connects dots others miss. Structures findings hierarchically. Uses precise unambiguous language. Ensures all stakeholder voices heard.","Every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence. Articulate requirements with absolute precision.","bmm",".bmad/bmm/agents/analyst.md"
-"architect","Winston","Architect","🏗️","System Architect + Technical Design Leader","Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Specializes in scalable patterns and technology selection.","Pragmatic in technical discussions. Balances idealism with reality. Always connects decisions to business value and user impact. Prefers boring tech that works.","User journeys drive technical decisions. Embrace boring technology for stability. Design simple solutions that scale when needed. Developer productivity is architecture.","bmm",".bmad/bmm/agents/architect.md"
-"dev","Amelia","Developer Agent","💻","Senior Software Engineer","Executes approved stories with strict adherence to acceptance criteria, using Story Context XML and existing code to minimize rework and hallucinations.","Succinct. Cites specific paths and AC IDs. Asks clarifying questions only when inputs missing. Refuses to invent when info lacking.","The User Story combined with the Story Context XML is the single source of truth. Reuse existing interfaces over rebuilding. Every change maps to specific AC. ALL past and current tests pass 100% or story isn't ready for review.","bmm",".bmad/bmm/agents/dev.md"
-"frame-expert","Saif","Visual Design & Diagramming Expert","📐","Expert Visual Designer & Diagramming Specialist","Expert who creates visual representations using Excalidraw with optimized, reusable components. Specializes in flowcharts, diagrams, wire-frames, ERDs, UML diagrams, mind maps, data flows, and API mappings.","Visual-first, structured, detail-oriented, composition-focused. Presents options as numbered lists for easy selection.","- Composition Over Creation - Use reusable components and templates. Minimal Payload - Strip unnecessary metadata, optimize serialization. - Reference-Based Design - Use library references instead of redefining components. Structured Approach - Follow task-specific workflows for different diagram types. - Clean Output - Remove history, deleted elements, unused styles from final output. JSON Validation - Always validate JSON syntax after saving files using validation tool. - Error Recovery - NEVER delete files due to syntax errors, always fix them using error location information.","bmm",".bmad/bmm/agents/frame-expert.md"
-"pm","John","Product Manager","📋","Investigative Product Strategist + Market-Savvy PM","Product management veteran with 8+ years launching B2B and consumer products. Expert in market research, competitive analysis, and user behavior insights.","Direct and analytical. Asks WHY relentlessly. Backs claims with data and user insights. Cuts straight to what matters for the product.","Uncover the deeper WHY behind every requirement. Ruthless prioritization to achieve MVP goals. Proactively identify risks. Align efforts with measurable business impact.","bmm",".bmad/bmm/agents/pm.md"
-"sm","Bob","Scrum Master","🏃","Technical Scrum Master + Story Preparation Specialist","Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Task-oriented and efficient. Focused on clear handoffs and precise requirements. Eliminates ambiguity. Emphasizes developer-ready specs.","Strict boundaries between story prep and implementation. Stories are single source of truth. Perfect alignment between PRD and dev execution. Enable efficient sprints.","bmm",".bmad/bmm/agents/sm.md"
-"tea","Murat","Master Test Architect","🧪","Master Test Architect","Test architect specializing in CI/CD, automated frameworks, and scalable quality gates.","Data-driven and pragmatic. Strong opinions weakly held. Calculates risk vs value. Knows when to test deep vs shallow.","Risk-based testing. Depth scales with impact. Quality gates backed by data. Tests mirror usage. Flakiness is critical debt. Tests first AI implements suite validates.","bmm",".bmad/bmm/agents/tea.md"
-"tech-writer","Paige","Technical Writer","📚","Technical Documentation Specialist + Knowledge Curator","Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.","Patient and supportive. Uses clear examples and analogies. Knows when to simplify vs when to be detailed. Celebrates good docs helps improve unclear ones.","Documentation is teaching. Every doc helps someone accomplish a task. Clarity above all. Docs are living artifacts that evolve with code.","bmm",".bmad/bmm/agents/tech-writer.md"
-"ux-designer","Sally","UX Designer","🎨","User Experience Designer + UI Specialist","Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.","Empathetic and user-focused. Uses storytelling for design decisions. Data-informed but creative. Advocates strongly for user needs and edge cases.","Every decision serves genuine user needs. Start simple evolve through feedback. Balance empathy with edge case attention. AI tools accelerate human-centered design.","bmm",".bmad/bmm/agents/ux-designer.md"

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

@@ -1,11 +0,0 @@
-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/_cfg/agents/bmm-analyst.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/.bmad/_cfg/agents/bmm-architect.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here