Skip to main content

​
Start Here: BMad-Help

The fastest way to get answers about BMad is /bmad-help. This intelligent guide will answer upwards of 80% of all questions and is available to you directly in your IDE as you work. BMad-Help is more than a lookup tool — it:
  • Inspects your project to see what’s already been completed
  • Understands natural language — ask questions in plain English
  • Varies based on your installed modules — shows relevant options
  • Auto-runs after workflows — tells you exactly what to do next
  • Recommends the first required task — no guessing where to start

​
How to Use BMad-Help

Run it with just the slash command: 
/bmad-help
Or combine it with a natural language query: 
/bmad-help I have a SaaS idea and know all the features. Where do I start?
/bmad-help What are my options for UX design?
/bmad-help I'm stuck on the PRD workflow
/bmad-help Show me what's been done so far
BMad-Help responds with:
  • What’s recommended for your situation
  • What the first required task is
  • What the rest of the process looks like

​
When to Use This Guide

Use this section when:
  • You want to understand BMad’s architecture or internals
  • You need answers outside of what BMad-Help provides
  • You’re researching BMad before installing
  • You want to explore the source code directly

​
Steps

​
1. Choose Your Source

SourceBest ForExamples
_bmad folderHow BMad works—agents, workflows, prompts”What does the PM agent do?”
Full GitHub repoHistory, installer, architecture”What changed in v6?”
llms-full.txtQuick overview from docs”Explain BMad’s four phases”
The _bmad folder is created when you install BMad. If you don’t have it yet, clone the repo instead.

​
2. Point Your AI at the Source

If your AI can read files (Claude Code, Cursor, etc.):
  • BMad installed: Point at the _bmad folder and ask directly
  • Want deeper context: Clone the full repo
If you use ChatGPT or Claude.ai: Fetch llms-full.txt into your session: 
https://bmad-code-org.github.io/BMAD-METHOD/llms-full.txt

​
3. Ask Your Question

Be specific about what you want to know:

​
Example Questions

Q: “Tell me the fastest way to build something with BMad” A: Use Quick Flow: Run quick-spec to write a technical specification, then quick-dev to implement it—skipping the full planning phases.
Q: “What does the PM agent do?” A: The PM agent guides you through creating Product Requirements Documents (PRDs), breaking down features into epics and stories, and managing sprint planning.
Q: “How do I customize an agent’s personality?” A: Edit the agent’s .customize.yaml file in _bmad/_config/agents/ and modify the persona section, then run npx bmad-method install --action compile-agents.

​
What You Get

Direct answers about BMad—how agents work, what workflows do, why things are structured the way they are—without waiting for someone else to respond.

​
Tips

Verify Surprising AnswersLLMs occasionally get things wrong. Check the source file or ask on Discord if something seems off.
Be Specific“What does step 3 of the PRD workflow do?” beats “How does PRD work?”
Use ContextProvide relevant files or folder paths to help the AI understand your specific situation.

​
Still Stuck?

Tried the LLM approach and still need help? You now have a much better question to ask.
ChannelUse For
#bmad-method-helpQuick questions (real-time chat)
help-requests forumDetailed questions (searchable, persistent)
#suggestions-feedbackIdeas and feature requests
#report-bugs-and-issuesBug reports
Discord: discord.gg/gk8jAdXWmj GitHub Issues: github.com/bmad-code-org/BMAD-METHOD/issues (for clear bugs)
You! Stuck in the queue— waiting for who? The source is there, plain to see! Point your machine. Set it free. It reads. It speaks. Ask away— Why wait for tomorrow when you have today? —Claude

Build docs developers (and LLMs) love

Get started for freeTalk to us