BMAD-METHOD/tools/docs/_prompt-external-modules-pa...

2.0 KiB

Prompt: Generate External Modules Reference Page

Goal

Create a reference documentation page at docs/reference/modules.md that lists all official external BMad modules with descriptions and links.

Source of Truth

Read tools/cli/external-official-modules.yaml — this is the authoritative registry of official external modules. Use the module names, codes, npm package names, and repository URLs from this file.

Research Step

For each module in the registry, visit its GitHub repository (url in the YAML record) and read its README to get:

  • A 1-2 sentence description of what the module does
  • The key agents and workflows it provides (if listed)
  • Any notable features or use cases

Output Format

Create docs/reference/modules.md following the project's Reference Catalog structure (see docs/_STYLE_GUIDE.md):

1. Title + Hook
2. Items (## for each module)
   - Brief description (one sentence)
   - **Key Info:** as flat list (code, npm package, GitHub link)
3. Installation note

Style

use @docs/_STYLE_GUIDE.md

Frontmatter

---
title: Official Modules
---

Content Requirements

  • Start with a brief intro explaining that BMad extends through official modules selected during installation
  • For each module include:
    • ## header with module name
    • 1-2 sentence description (sourced from GitHub README, not just the registry's short description)
    • Key info list: module code, npm package (linked), GitHub repo (linked)
    • Brief bullet list of what it provides (agents, workflows, key features) — keep to 3-5 bullets
  • Include a :::tip admonition about how to install modules (via npx bmad-method installer)
  • Mention that community modules and a marketplace are coming
  • Do NOT include built-in modules (core, bmm) — this page is specifically for external/add-on modules

Existing Pages for Reference

Look at these files to match the tone and style of existing reference docs:

  • docs/reference/agents.md
  • docs/reference/commands.md
  • docs/reference/testing.md