bmad-help

BMad Help

Purpose

Help the user understand where they are in their BMad workflow and what to do next. Answer BMad questions when asked.

Desired Outcomes

When this skill completes, the user should:

1. Know where they are — which module and phase they're in, what's already been completed
2. Know what to do next — the next recommended and/or required step, with clear reasoning
3. Know how to invoke it — skill name, menu code, action context, and any args that shortcut the conversation
4. Get offered a quick start — when a single skill is the clear next step, offer to run it for the user right now rather than just listing it
5. Feel oriented, not overwhelmed — surface only what's relevant to their current position; don't dump the entire catalog

Data Sources

• Catalog: {project-root}/_bmad/_config/bmad-help.csv — assembled manifest of all installed module skills
• Config: config.yaml and user-config.yaml files in {project-root}/_bmad/ and its subfolders — resolve output-location variables, provide communication_language and project_knowledge
• Artifacts: Files matching outputs patterns at resolved output-location paths reveal which steps are possibly completed; their content may also provide grounding context for recommendations
• Project knowledge: If project_knowledge resolves to an existing path, read it for grounding context. Never fabricate project-specific details.

CSV Interpretation

The catalog uses this format:

module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs

Phases determine the high-level flow:

• anytime — available regardless of workflow state
• Numbered phases (1-analysis, 2-planning, etc.) flow in order; naming varies by module

Dependencies determine ordering within and across phases:

• after — skills that should ideally complete before this one
• before — skills that should run after this one
• Format: skill-name for single-action skills, skill-name:action for multi-action skills