Go to the /web-bundles/ folder in this repo
Download a bundle file:
- Team bundles in /web-bundles/teams/ - Full agile teams with all roles
- Individual agents in /web-bundles/agents/ - Single role agents
Upload to your AI platform:
- Gemini: Create a new Gem → Upload the bundle file → Start using!
- ChatGPT: Create a custom GPT → Attach as knowledge → Start using!
Wether you use Gemini or ChatGPT, you will want to set the instructions as follows: 'Your critical operating instructions are attached, you ARE the BMad Agent, and you are orchestrating the team attached as instructed. Do not deviate from the attached operating instructions.'

Thanks it, you are now ready to go. I suggest starting with typing /help - and if you dont know what to do, select the option to hear about and select a workflow - and BMad will help you throughout the whole process guiding you agent to agent now!

That's it! You're ready to use BMAD agents. 🎉

Option 2: IDE Agents (Also No Installation)

For Cursor, Windsurf, or other IDEs:

Copy the bmad-core/ folder to your project root
Use agents from bmad-core/ide-agents/
Set up slash commands (see examples in .cursor/ or .claude/commands/)

What is BMAD?

BMAD is a framework that gives you a complete Agile development team powered by AI. Each agent specializes in a specific role:

🧠 Business Analyst - Requirements gathering and project briefs
📋 Product Manager - PRDs and product planning
👁️ UX Expert - User experience design and UI specifications
🏗️ Architect - System design and technical architecture
🔄 Fullstack Architect - Holistic full-stack system design
🎨 Design Architect - UI/UX and frontend architecture
✅ Product Owner - Story validation and backlog management
📝 Scrum Master - Story generation and sprint planning
💻 Developer - Code implementation
🧪 QA Engineer - Testing and quality assurance

The BMAD Orchestrator can transform into any role using slash commands!

🛠️ Advanced: Build Custom Bundles

Only needed if you want to customize agents:

Clone this repository
Install Node.js and run npm install
Modify agents in /agents/ folder
Run npm run build
Find your custom bundles in /dist/

Configuring Custom Agents

Edit YAML files in /agents/ to customize behavior
Create new team combinations in /agent-teams/ directory
All configuration is now YAML-based for easy editing

IDE Slash Commands

For Cursor, Windsurf, VSCode, and Claude Code: Check the .cursor/ or .claude/commands/ folders for example slash command setups. These let you quickly switch between agents in your IDE!

For Claude at least, it also helped to add the following to the root CLAUDE.MD:

## Custom IDE Commands

IMPORTANT: This repository uses custom commands defined in `.claude/commands/`. When users type these commands, IMMEDIATELY follow the instructions in the corresponding command file:

- `/ide-agent <agent-name>` - Switch to an IDE agent persona (see `.claude/commands/ide-agent.md`)
- `/exit-agent` or `/exit` - Return to default Claude Code mode

When a custom command is used:

1. IMMEDIATELY read the command file
2. Follow the instructions exactly as written
3. Do NOT ask for clarification or additional information unless the command file says to

📚 Documentation

Previous Versions

Thank you and enjoy! - BMad

MIT License