You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: rewrite get-answers-about-bmad for flow and accuracy (#2213)
Restructure from two glued-together documents into a single
escalation flow (bmad-help → source → community). Remove
references to deprecated _bmad folder and closed Discord channels.
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/how-to/get-answers-about-bmad.md
+18-74Lines changed: 18 additions & 74 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,111 +5,55 @@ sidebar:
5
5
order: 4
6
6
---
7
7
8
-
## Start Here: BMad-Help
8
+
Use BMad's built-in help, source docs, or the community to get answers — from quickest to most thorough.
9
9
10
-
**The fastest way to get answers about BMad is the `bmad-help` skill.** This intelligent guide will answer upwards of 80% of all questions and is available to you directly in your IDE as you work.
10
+
## 1. Ask BMad-Help
11
11
12
-
BMad-Help is more than a lookup tool — it:
13
-
-**Inspects your project** to see what's already been completed
14
-
-**Understands natural language** — ask questions in plain English
15
-
-**Varies based on your installed modules** — shows relevant options
16
-
-**Auto-runs after workflows** — tells you exactly what to do next
17
-
-**Recommends the first required task** — no guessing where to start
18
-
19
-
### How to Use BMad-Help
20
-
21
-
Call it by name in your AI session:
22
-
23
-
```
24
-
bmad-help
25
-
```
26
-
27
-
:::tip
28
-
You can also use `/bmad-help` or `$bmad-help` depending on your platform, but just `bmad-help` should work everywhere.
29
-
:::
30
-
31
-
Combine it with a natural language query:
12
+
The fastest way to get answers. The `bmad-help` skill is available directly in your AI session and handles over 80% of questions — it inspects your project, sees what you've completed, and tells you what to do next.
32
13
33
14
```
34
15
bmad-help I have a SaaS idea and know all the features. Where do I start?
35
16
bmad-help What are my options for UX design?
36
17
bmad-help I'm stuck on the PRD workflow
37
-
bmad-help Show me what's been done so far
38
18
```
39
19
40
-
BMad-Help responds with:
41
-
- What's recommended for your situation
42
-
- What the first required task is
43
-
- What the rest of the process looks like
44
-
45
-
## When to Use This Guide
46
-
47
-
Use this section when:
48
-
- You want to understand BMad's architecture or internals
49
-
- You need answers outside of what BMad-Help provides
BMad-Help draws on your installed configuration. For questions about BMad's internals, history, or architecture — or if you're researching BMad before installing — point your AI at the source directly.
80
27
81
-
### 3. Ask Your Question
28
+
Clone or open the [BMAD-METHOD repo](https://github.com/bmad-code-org/BMAD-METHOD) and ask your AI about it. Any agent-capable tool (Claude Code, Cursor, Windsurf, etc.) can read the source and answer questions directly.
82
29
83
30
:::note[Example]
84
31
**Q:** "Tell me the fastest way to build something with BMad"
85
32
86
33
**A:** Use Quick Flow: Run `bmad-quick-dev` — it clarifies your intent, plans, implements, reviews, and presents results in a single workflow, skipping the full planning phases.
87
34
:::
88
35
89
-
## What You Get
36
+
**Tips for better answers:**
90
37
91
-
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.
38
+
-**Be specific** — "What does step 3 of the PRD workflow do?" beats "How does PRD work?"
39
+
-**Verify surprising claims** — LLMs occasionally get things wrong. Check the source file or ask on Discord.
92
40
93
-
##Tips
41
+
### Not using an agent? Use the docs site
94
42
95
-
-**Verify surprising answers** — LLMs occasionally get things wrong. Check the source file or ask on Discord.
96
-
-**Be specific** — "What does step 3 of the PRD workflow do?" beats "How does PRD work?"
43
+
If your AI can't read local files (ChatGPT, Claude.ai, etc.), fetch [llms-full.txt](https://bmad-code-org.github.io/BMAD-METHOD/llms-full.txt) into your session — it's a single-file snapshot of the BMad documentation.
97
44
98
-
## Still Stuck?
45
+
## 3. Ask Someone
99
46
100
-
Tried the LLM approach and still need help? You now have a much better question to ask.
47
+
If neither BMad-Help nor the source answered your question, you now have a much better question to ask.
0 commit comments