c0f6401902
- Add "Why does BMad use so many tokens?" FAQ explaining design tradeoff (decision quality over code velocity) - Fix stale anchor #adversarial-review-general → #adversarial-review - Remove link to archived customize-workflows.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.4 KiB
title, description
| title | description |
|---|---|
| Getting Started FAQ | Common questions about getting started with the BMad Method |
Quick answers to common questions about getting started with the BMad Method.
Questions
- Why does BMad use so many tokens?
- Do I always need to run workflow-init?
- Why do I need fresh chats for each workflow?
- Can I skip workflow-status and just start working?
- What's the minimum I need to get started?
- How do I know if I'm in Phase 1, 2, 3, or 4?
Why does BMad use so many tokens?
BMad is not always the most token efficient approach, and that's by design. The checkpoints, story files, and retrospectives keep you in the loop so you can apply taste, judgment, and accumulated context that no agent has. Fully automated coding loops optimize for code velocity; BMad optimizes for decision quality. If you're building something you'll maintain for years, where user experience matters, where architectural choices compound—that tradeoff pays for itself.
Do I always need to run workflow-init?
No, once you learn the flow you can go directly to workflows. However, workflow-init is helpful because it:
- Determines your project's appropriate level automatically
- Creates the tracking status file
- Routes you to the correct starting workflow
For experienced users: use the Quick Start Guide to go directly to the right agent/workflow.
Why do I need fresh chats for each workflow?
Context-intensive workflows (like brainstorming, PRD creation, architecture design) can cause AI hallucinations if run in sequence within the same chat. Starting fresh ensures the agent has maximum context capacity for each workflow. This is particularly important for:
- Planning workflows (PRD, architecture)
- Analysis workflows (brainstorming, research)
- Complex story implementation
Quick workflows like status checks can reuse chats safely.
Can I skip workflow-status and just start working?
Yes, if you already know your project level and which workflow comes next. workflow-status is mainly useful for:
- New projects (guides initial setup)
- When you're unsure what to do next
- After breaks in work (reminds you where you left off)
- Checking overall progress
What's the minimum I need to get started?
For the fastest path:
- Install BMad Method:
npx bmad-method@alpha install - For small changes: Load PM agent → run tech-spec → implement
- For larger projects: Load PM agent → run prd → architect → implement
How do I know if I'm in Phase 1, 2, 3, or 4?
Check your bmm-workflow-status.md file (created by workflow-init). It shows your current phase and progress. If you don't have this file, you can also tell by what you're working on:
- Phase 1 — Brainstorming, research, product brief (optional)
- Phase 2 — Creating either a PRD or tech-spec (always required)
- Phase 3 — Architecture design (Level 2-4 only)
- Phase 4 — Actually writing code, implementing stories
Have a question not answered here? Please open an issue or ask in Discord so we can add it!