Skip to content

Commit aa48f83

Browse files
alexeyvclaude
andauthored
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>
1 parent ac18b19 commit aa48f83

File tree

1 file changed

+18
-74
lines changed

1 file changed

+18
-74
lines changed

docs/how-to/get-answers-about-bmad.md

Lines changed: 18 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -5,111 +5,55 @@ sidebar:
55
order: 4
66
---
77

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.
99

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
1111

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.
3213

3314
```
3415
bmad-help I have a SaaS idea and know all the features. Where do I start?
3516
bmad-help What are my options for UX design?
3617
bmad-help I'm stuck on the PRD workflow
37-
bmad-help Show me what's been done so far
3818
```
3919

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
50-
- You're researching BMad before installing
51-
- You want to explore the source code directly
52-
53-
## Steps
54-
55-
### 1. Choose Your Source
56-
57-
| Source | Best For | Examples |
58-
| -------------------- | ----------------------------------------- | ---------------------------- |
59-
| **`_bmad` folder** | How BMad works—agents, workflows, prompts | "What does the PM agent do?" |
60-
| **Full GitHub repo** | History, installer, architecture | "What changed in v6?" |
61-
| **`llms-full.txt`** | Quick overview from docs | "Explain BMad's four phases" |
62-
63-
The `_bmad` folder is created when you install BMad. If you don't have it yet, clone the repo instead.
64-
65-
### 2. Point Your AI at the Source
66-
67-
**If your AI can read files (Claude Code, Cursor, etc.):**
68-
69-
- **BMad installed:** Point at the `_bmad` folder and ask directly
70-
- **Want deeper context:** Clone the [full repo](https://github.com/bmad-code-org/BMAD-METHOD)
71-
72-
**If you use ChatGPT or Claude.ai:**
73-
74-
Fetch `llms-full.txt` into your session:
20+
:::tip
21+
You can also use `/bmad-help` or `$bmad-help` depending on your platform, but just `bmad-help` should work everywhere.
22+
:::
7523

76-
```text
77-
https://bmad-code-org.github.io/BMAD-METHOD/llms-full.txt
78-
```
24+
## 2. Go Deeper with Source
7925

26+
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.
8027

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.
8229

8330
:::note[Example]
8431
**Q:** "Tell me the fastest way to build something with BMad"
8532

8633
**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.
8734
:::
8835

89-
## What You Get
36+
**Tips for better answers:**
9037

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.
9240

93-
## Tips
41+
### Not using an agent? Use the docs site
9442

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.
9744

98-
## Still Stuck?
45+
## 3. Ask Someone
9946

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.
10148

10249
| Channel | Use For |
10350
| ------------------------- | ------------------------------------------- |
104-
| `#bmad-method-help` | Quick questions (real-time chat) |
105-
| `help-requests` forum | Detailed questions (searchable, persistent) |
51+
| `help-requests` forum | Questions |
10652
| `#suggestions-feedback` | Ideas and feature requests |
107-
| `#report-bugs-and-issues` | Bug reports |
10853

10954
**Discord:** [discord.gg/gk8jAdXWmj](https://discord.gg/gk8jAdXWmj)
11055

111-
**GitHub Issues:** [github.com/bmad-code-org/BMAD-METHOD/issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) (for clear bugs)
112-
56+
**GitHub Issues:** [github.com/bmad-code-org/BMAD-METHOD/issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)
11357
*You!*
11458
*Stuck*
11559
*in the queue—*

0 commit comments

Comments
 (0)