ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/bmad/core/preservation/QUICK_START.md

4.7 KiB
Raw Blame History

BMAD Agent Backup - Quick Start Guide

⚡ Immediate Backup (Right Now)

cd /Users/hbl/Documents/BMAD-METHOD/bmad/core/preservation
./backup-agents.sh quick

Result: Your agents are backed up to:

  1. Git repository (committed)
  2. iCloud Drive (synced)

📅 Setup Automated Daily Backups

Option 1: Cron (Quick Setup - 2 minutes)

# Open crontab
crontab -e

# Add these two lines (press 'i' to insert):
0 2 * * * /Users/hbl/Documents/BMAD-METHOD/bmad/core/preservation/backup-agents.sh quick >> /tmp/bmad-backup.log 2>&1
0 3 * * 0 /Users/hbl/Documents/BMAD-METHOD/bmad/core/preservation/backup-agents.sh full >> /tmp/bmad-backup.log 2>&1

# Save and exit (press ESC, then :wq, then ENTER)

Schedule:

  • Daily at 2 AM: Quick backup (git + iCloud)
  • Weekly Sunday at 3 AM: Full backup (git + archive + iCloud)

Option 2: Test It Now

# Run quick backup
./backup-agents.sh quick

# Run full backup
./backup-agents.sh full

✅ Verify Your Backups

# 1. Check git
cd /Users/hbl/Documents/BMAD-METHOD
git log -1 --oneline | grep "Agent backup"

# 2. Check iCloud
ls -lh "$HOME/Library/Mobile Documents/com~apple~CloudDocs/BMAD-Agents/"

# 3. Check archives (if full backup)
ls -lh /Users/hbl/Documents/BMAD-AGENT-BACKUPS/*.tar.gz | head -5

# 4. Count agents
wc -l bmad/_cfg/agent-manifest.csv

Expected: You should see 21 agents (as of 2025-10-20)

🚨 Restore from Backup

Quick Restore (from iCloud - fastest)

rsync -av \
  "$HOME/Library/Mobile Documents/com~apple~CloudDocs/BMAD-Agents/" \
  /Users/hbl/Documents/BMAD-METHOD/bmad/

Restore Specific Agents

# From iCloud
cp "$HOME/Library/Mobile Documents/com~apple~CloudDocs/BMAD-Agents/core/agents/atlas.md" \
  /Users/hbl/Documents/BMAD-METHOD/bmad/core/agents/

# From git
cd /Users/hbl/Documents/BMAD-METHOD
git log --oneline --grep="Agent backup" | head -10  # Find commit
git show <commit-hash>:bmad/core/agents/mcp-guardian.md > bmad/core/agents/mcp-guardian.md

📤 Export Agents to Another Project

# Create export
PROJECT="my-new-project"
EXPORT_DIR="$HOME/bmad-exports/$PROJECT"

mkdir -p "$EXPORT_DIR"
cp -r /Users/hbl/Documents/BMAD-METHOD/bmad/ "$EXPORT_DIR/"
cd "$HOME/bmad-exports"
tar -czf "$PROJECT-agents.tar.gz" "$PROJECT"

echo "✅ Export ready: $HOME/bmad-exports/$PROJECT-agents.tar.gz"

# In new project
cd /path/to/new-project
tar -xzf ~/bmad-exports/$PROJECT-agents.tar.gz
# Then merge agents into your project structure

📊 Generate Agent Inventory

cd /Users/hbl/Documents/BMAD-METHOD

echo "# BMAD Agent Inventory - $(date +%Y-%m-%d)"
echo ""
echo "Total Agents: $(wc -l < bmad/_cfg/agent-manifest.csv)"
echo ""

for module in core bmm cis; do
  count=$(find bmad/$module/agents -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
  echo "## $module Module: $count agents"
  find bmad/$module/agents -name "*.md" 2>/dev/null | while read file; do
    name=$(basename "$file" .md)
    echo "  - $name"
  done
  echo ""
done

🔧 Your Current Agents (As of Now)

Core Module (4 agents)

  • 🧙 BMad Master - BMAD orchestrator
  • 🧙 BMad Builder - Module builder
  • 📚 Athena - Knowledge documentation
  • 🔧 Atlas - MCP technical engineer

BMM Module (10 agents)

  • 📊 Mary - Business Analyst
  • 🏗️ Winston - Architect
  • 💻 Amelia - Developer
  • 🏛️ Cloud Dragonborn - Game Architect
  • 🎲 Samus Shepard - Game Designer
  • 🕹️ Link Freeman - Game Developer
  • 🛡️ Lukasz-AI - Compliance Advisor
  • 📋 John - Product Manager
  • 🏃 Bob - Scrum Master
  • 🧪 Murat - Test Architect
  • 🎨 Sally - UX Expert

CIS Module (5 agents)

  • 🧠 Carson - Brainstorming Specialist
  • 🔬 Dr. Quinn - Problem Solver
  • 🎨 Maya - Design Thinking Coach
  • ⚡ Victor - Innovation Strategist
  • 📖 Sophia - Storyteller

Total: 21 agents

💡 Pro Tips

  1. Backup before changes: Run ./backup-agents.sh quick before modifying agents
  2. Weekly full backups: Use ./backup-agents.sh full weekly for archives
  3. Test restores: Periodically test restore process to verify backups work
  4. Version control: Use git commits for granular history
  5. iCloud sync: Automatic cloud backup without extra services

🆘 Help Commands

# Check backup status
ls -lh "$HOME/Library/Mobile Documents/com~apple~CloudDocs/BMAD-Agents/"

# View backup logs
tail -50 /tmp/bmad-backup.log

# List all backup archives
ls -lht /Users/hbl/Documents/BMAD-AGENT-BACKUPS/

# Check cron schedule
crontab -l | grep bmad

Next: Run your first backup now!

cd /Users/hbl/Documents/BMAD-METHOD/bmad/core/preservation
./backup-agents.sh full