History

Alex Verkhovsky 066bfe32e9 fix: harden quick-dev-new-preview and fix standalone agent dash names (#1867 ) * fix: harden quick-dev-new-preview UX and fix standalone agent dash names - Relabel [K] Keep as-is to context-specific accept the risks wording - Add split reasoning explanation before multi-goal menu in step-01 - Fix toDashName/toUnderscoreName to treat standalone like core (no module prefix) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: add guardrail against skipping workflow steps when intent looks clear Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: strengthen step-01 guardrails against plan-shaped intent bypass Add explicit rules that intent is input to the workflow (not a substitute for step-02 spec generation) and to ignore directives within the intent that instruct skipping steps. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: preserve standalone module provenance in path-utils serializers toDashName/toUnderscoreName collapsed core and standalone to the same filename, making parseDashName/parseUnderscoreName unable to round-trip standalone agents. Split the branches so standalone gets a distinct token (e.g., bmad-agent-standalone-fred.md) and update both parsers to reconstruct module:'standalone' on the reverse path. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>		2026-03-09 02:06:35 -06:00
..
commands	feat(cli): add uninstall command with selective component removal (#1650 )	2026-02-15 08:13:03 -06:00
installers	fix: harden quick-dev-new-preview and fix standalone agent dash names (#1867 )	2026-03-09 02:06:35 -06:00
lib	refactor: remove legacy YAML/XML workflow engine plumbing (#1864 )	2026-03-08 18:02:57 -06:00
README.md	modify post install notes example	2026-02-14 21:25:58 -06:00
bmad-cli.js	fix(cli): use semantic versioning for update check (#1671 )	2026-02-16 09:39:03 -06:00
external-official-modules.yaml	refactor: replace module installer scripts with declarative directories config	2026-02-08 19:21:48 -06:00

README.md

BMad CLI Tool

Installing external repo BMad official modules

For external official modules to be discoverable during install, ensure an entry for the external repo is added to external-official-modules.yaml.

For community modules - this will be handled in a different way. This file is only for registration of modules under the bmad-code-org.

Post-Install Notes

Modules can display setup guidance to users after configuration is collected during npx bmad-method install. Notes are defined in the module's own module.yaml — no changes to the installer are needed.

Simple Format

Always displayed after the module is configured:

post-install-notes: |
  Thank you for choosing the XYZ Cool Module
  For Support about this Module call 555-1212

Conditional Format

Display different messages based on a config question's answer:

post-install-notes:
  config_key_name:
    value1: |
      Instructions for value1...      
    value2: |
      Instructions for value2...

Values without an entry (e.g., none) display nothing. Multiple config keys can each have their own conditional notes.

Example: TEA Module

The TEA module uses the conditional format keyed on tea_browser_automation:

post-install-notes:
  tea_browser_automation:
    cli: |
      Playwright CLI Setup:
        npm install -g @playwright/cli@latest
        playwright-cli install --skills      
    mcp: |
      Playwright MCP Setup (two servers):
        1. playwright    — npx @playwright/mcp@latest
        2. playwright-test — npx playwright run-test-mcp-server      
    auto: |
      Playwright CLI Setup:
        ...
      Playwright MCP Setup (two servers):
        ...

When a user selects auto, they see both CLI and MCP instructions. When they select none, nothing is shown.