Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions docs/bmad-commands.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: BMAD Commands
description: Use BMAD Method workflows inside Maestro's AI Commands panel.
---

# BMAD Commands

Maestro bundles a curated set of prompts from [bmad-code-org/BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) and exposes them in **Settings -> AI Commands**.

You can review, edit, reset, and refresh these prompts the same way you can with Spec-Kit and OpenSpec.

## What Is Included

The BMAD bundle covers the main workflow families published by BMAD:

- **Core utilities** like `/bmad-help`, `/bmad-brainstorming`, `/bmad-party-mode`, `/bmad-index-docs`, and review-oriented prompts
- **Analysis workflows** like `/bmad-bmm-market-research`, `/bmad-bmm-domain-research`, `/bmad-bmm-technical-research`, and `/bmad-bmm-create-product-brief`
- **Planning workflows** like `/bmad-bmm-create-prd`, `/bmad-bmm-validate-prd`, `/bmad-bmm-edit-prd`, and `/bmad-bmm-create-ux-design`
- **Solutioning workflows** like `/bmad-bmm-create-architecture`, `/bmad-bmm-create-epics-and-stories`, and `/bmad-bmm-check-implementation-readiness`
- **Implementation workflows** like `/bmad-bmm-sprint-planning`, `/bmad-bmm-create-story`, `/bmad-bmm-dev-story`, `/bmad-bmm-code-review`, and `/bmad-bmm-qa-automate`
- **Quick flow workflows** like `/bmad-bmm-quick-spec`, `/bmad-bmm-quick-dev`, and `/bmad-bmm-quick-dev-new-preview`

## Important Prerequisite

Many BMAD prompts assume the target repository already contains BMAD's project artifacts such as the `_bmad/` directory, workflow configs, sprint files, and generated planning documents.

If those files are missing, the prompt may still provide guidance, but BMAD works best when the repository has already been prepared with the BMAD installer or equivalent project structure.

## Updating The Bundle

From the AI Commands settings panel, use **Check for Updates** in the BMAD section to pull the latest upstream workflow text from BMAD.

This updates Maestro's cached copy of the upstream prompts while preserving any local edits you have made in the app.

## Editing Prompts

Each bundled BMAD command can be:

- expanded to inspect the current prompt
- edited and saved locally
- reset back to the bundled default

Local edits are stored in Maestro's application data and do not modify the upstream BMAD project.
2 changes: 1 addition & 1 deletion docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Settings are organized into tabs:
| **Shortcuts** | Customize keyboard shortcuts (see [Keyboard Shortcuts](./keyboard-shortcuts)) |
| **Themes** | Dark, light, and vibe mode themes, custom theme builder with import/export |
| **Notifications** | OS notifications, custom command notifications, toast notification duration |
| **AI Commands** | View and edit slash commands, [Spec-Kit](./speckit-commands), and [OpenSpec](./openspec-commands) prompts |
| **AI Commands** | View and edit slash commands, [Spec-Kit](./speckit-commands), [OpenSpec](./openspec-commands), and [BMAD](./bmad-commands) prompts |
| **SSH Hosts** | Configure remote hosts for [SSH agent execution](./ssh-remote-execution) |
| **WakaTime** _(in General tab)_ | WakaTime integration toggle, API key, detailed file tracking |

Expand Down
3 changes: 2 additions & 1 deletion docs/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,8 @@
"autorun-playbooks",
"playbook-exchange",
"speckit-commands",
"openspec-commands"
"openspec-commands",
"bmad-commands"
]
},
{
Expand Down
15 changes: 14 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,8 @@
"test:integration:watch": "vitest --config vitest.integration.config.ts",
"test:performance": "vitest run --config vitest.performance.config.mts",
"refresh-speckit": "node scripts/refresh-speckit.mjs",
"refresh-openspec": "node scripts/refresh-openspec.mjs"
"refresh-openspec": "node scripts/refresh-openspec.mjs",
"refresh-bmad": "node scripts/refresh-bmad.mjs"
},
"build": {
"npmRebuild": false,
Expand Down Expand Up @@ -116,6 +117,10 @@
{
"from": "src/prompts/openspec",
"to": "prompts/openspec"
},
{
"from": "src/prompts/bmad",
"to": "prompts/bmad"
}
]
},
Expand Down Expand Up @@ -148,6 +153,10 @@
{
"from": "src/prompts/openspec",
"to": "prompts/openspec"
},
{
"from": "src/prompts/bmad",
"to": "prompts/bmad"
}
]
},
Expand All @@ -172,6 +181,10 @@
{
"from": "src/prompts/openspec",
"to": "prompts/openspec"
},
{
"from": "src/prompts/bmad",
"to": "prompts/bmad"
}
]
},
Expand Down
Loading
Loading