Personal collection of expansion packs for the BMAD Method — Pre-built AI agent teams and workflows for specialized domains.

🚧 Container Repository: This repo currently serves as a personal staging and distribution mechanism for BMAD expansion packs. It demonstrates how to build, organize, and distribute custom BMAD modules until formal package distribution is established.

💡 Future Home: The BMAD community is working toward BMAD Foundry as the official distribution point for expansion packs. (I think???)

Expansion packs extend BMAD with ready-to-use AI agent teams and workflows for specific domains:

• No setup required — Agents come pre-configured with personas, expertise, and workflows
• Production-ready — Built using BMAD Builder (BMB) with proper .agent.yaml format
• Domain-specialized — Each pack brings expert agents for a specific field (marketing, medical, blogging, etc.)
• Interactive installation — Configure each pack for your specific needs during install

Think of them as: Pre-built teams of AI specialists that integrate directly into your BMAD-powered projects.

31 AI marketing specialists across strategy, content, performance, social media, PR, and analytics.

Configuration: 7 interactive fields (industry, focus areas, audience, maturity, disclaimers)

📖 Marketing Pack Documentation

9 healthcare AI specialists for clinical validation, compliance, training, and health IT.

Configuration: 6 interactive fields (specialty, HIPAA mode, disclaimers, validation level, EHR system)

📖 Medical Pack Documentation

2 AI content specialists for daily blogging and content operations (Derek Neighbors' system).

Configuration: 6 interactive fields (author name, content focus, cadence, SEO priority, social automation)

📖 Blog Pack Documentation

• BMAD v6-alpha installed (BMAD-METHOD)
• Node.js and npm installed
• Cursor IDE (for agent usage)
• rsync available on your system

1. Clone this repository

# Clone as sibling to BMAD-METHOD (recommended structure)
cd /path/to/repos/
git clone https://github.com/dneighbors/bmad-expansions.git

# Your directory structure:
# /path/to/repos/
# ├── bmad-expansions/  (this repo)
# └── BMAD-METHOD/      (BMAD v6-alpha)

2. Sync packs to BMAD-METHOD

cd bmad-expansions
./scripts/sync-packs.sh

# Interactive prompts:
# - Confirm BMAD-METHOD path (defaults to sibling directory)
# - Review packs to sync (medical, marketing, blog)
# - Confirm sync operation

3. Rebuild BMAD to discover new modules

cd ../BMAD-METHOD
npm install

4. Install packs in your project

cd /path/to/your-cursor-project
npm run install:bmad

# Interactive installer:
# - Select expansion packs to install (medical, marketing, blog)
# - Answer configuration questions for each pack
# - Agents and workflows install to .cursor/rules/

5. Use agents in Cursor

@victoria-chen-cmo
How should I structure my Q1 marketing strategy?

@dr-michael-johnson
Can you review this patient education content for accuracy?

@derek-neighbors-author
Help me brainstorm blog topics for this month.

• Installation & Testing Guide — Complete installation walkthrough
• Project Plan — Project overview and roadmap
• Workflow Status — Sprint progress and deliverables

• Contributing Guide — BMB-first policy and authoring guidelines
• Expansion Pack Setup — Repository structure and conventions
• Discovery Sessions — Pack requirements and design decisions
• Stories & Epics — Detailed story documentation

We follow a BMB-first policy: All agents and workflows must be created using BMAD Builder workflows.

To create a new expansion pack:

1. Run BMB *create-module workflow to scaffold the pack
2. Create agents using *create-agent workflow (produces .agent.yaml files)
3. Create workflows using *create-workflow workflow
4. Configure installer in _module-installer/install-config.yaml
5. Document in README.md with agent roster and workflow list
6. Test end-to-end via sync script and installation

Critical Requirements:

• ✅ Use BMB workflows (no manual file creation)
• ✅ Agents must be .agent.yaml format (not .md)
• ✅ Workflows need 4 files: workflow.yaml, instructions.md, checklist.md, README.md
• ✅ Rich configuration (5-8 interactive installer fields)
• ✅ Complete documentation

See CONTRIBUTING.md for full guidelines.

Sprint 01: ✅ COMPLETE

• 3 production packs delivered
• 42 agents (100% functional)
• 38 workflow configs (instructions coming in Sprint 02)
• Interactive sync script
• BMB-first policy established

Known Gaps:

• ⚠️ Workflows missing instructions/checklists (Story 28 for Sprint 02)
• Impact: Agents work perfectly; workflows non-functional until Sprint 02

Sprint 02 Priority:

• Complete workflow files (instructions, checklists, READMEs)
• End-to-end workflow testing
• BMB documentation

📈 View Detailed Status

bmad-expansions/
├── medical/                    # Medical Pack
│   ├── agents/                 # 9 healthcare specialists (.agent.yaml)
│   ├── workflows/              # 8 clinical workflows (configs only)
│   ├── _module-installer/      # Interactive installer config
│   └── README.md
│
├── marketing/                  # Marketing Pack
│   ├── agents/                 # 31 marketing specialists (.agent.yaml)
│   ├── workflows/              # 15 marketing workflows (configs only)
│   ├── _module-installer/      # Interactive installer config
│   └── README.md
│
├── blog/                       # Blog Pack
│   ├── agents/                 # 2 content specialists (.agent.yaml)
│   ├── workflows/              # 15 blogging workflows (configs only)
│   ├── _module-installer/      # Interactive installer config
│   └── README.md
│
├── scripts/
│   └── sync-packs.sh          # Interactive sync to BMAD-METHOD
│
├── docs/
│   ├── discovery/             # Pack requirements and design
│   ├── epics/                 # Epic definitions
│   ├── stories/               # Story documentation
│   ├── sprints/               # Sprint plans
│   ├── plan.md                # Project plan
│   └── workflow-status.md     # Progress tracking
│
├── CONTRIBUTING.md            # BMB-first contribution guidelines
├── EXPANSIONS-SETUP.md        # Repository conventions
└── README.md                  # This file

• What is BMAD? — Base framework for AI-powered development
• BMAD Foundry — Future official home for expansion packs (I think???)
• BMAD Builder (BMB) — Tool for creating agents and workflows
• Epic 05: Context-Aware Adaptation — Future roadmap for intelligent configuration

• Marketing Pack Discovery — Design decisions and agent roster
• Medical Pack Discovery — Healthcare AI requirements
• Blog Pack Discovery — Content operations system

Found a bug? Open an issue with:

• Pack name and version
• Installation steps taken
• Expected vs actual behavior
• BMAD version

Want a new pack? Start a discussion:

• Describe the domain/use case
• List desired agent types
• Outline key workflows

Contributing? Read CONTRIBUTING.md first!

MIT License - See LICENSE for details.

• BMAD Method by BMad (Brian) — The foundation making this all possible
• BMAD Builder (BMB) — Authoring workflows that ensure quality and consistency
• Contributors — Everyone helping expand BMAD's capabilities

Built with BMAD Builder • Following BMB-First Standards • Sprint 01 Complete