Files
BMAD-METHOD/docs/reference/agents/index.md
forcetrainer 12d3492e0c Add link auditor, reorganize documentation, and README update (#1277)
* feat: add link auditor tools and fix broken docs links

- Add audit-doc-links.js to scan docs for broken links with auto-resolution
- Add fix-doc-links.js to apply suggested fixes (dry-run by default)
- Remove stale "Back to Core Concepts" breadcrumb links
- Update BMad acronym to "Breakthrough Method of Agile AI Driven Development"
- Update README links to docs.bmad-method.org
- Simplify upgrade callout in getting-started tutorial

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: reorganize docs structure and archive v4 tutorial

- Remove unused section index files (tutorials, how-to, explanation, reference)
- Move getting-started-bmadv4.md to _archive
- Update quick-start-bmgd.md to remove archived file reference
- Update upgrade-to-v6.md
- Update astro.config.mjs for new structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: ignore underscore directories in link checker

Update check-doc-links.js to skip _archive, _planning, and other
underscore-prefixed directories when validating links.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: add v4 users section to README

Add links to v4 documentation archive and upgrade guide for users
migrating from previous versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat: convert docs to site-relative links and add validation tools

- Convert all relative links (./  ../) to site-relative paths (/path/)
- Strip .md extensions and use trailing slashes for Astro/Starlight
- Add fix-doc-links.js to convert relative links to site-relative
- Add validate-doc-links.js to check links point to existing files
- Remove old audit-doc-links.js and check-doc-links.js
- Update build-docs.js to use new validation script
- Add npm scripts: docs:fix-links, docs:validate-links
- Update style guide with validation steps

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: standardize acronym to BMad across documentation

Replace incorrect "BMAD" with correct "BMad" in text and frontmatter
while preserving "BMAD-METHOD" in GitHub URLs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: fix BMad acronym and remove draft README

- Correct acronym to "Breakthrough Method of Agile AI Driven Development"
- Remove unused README-draft.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: standardize BMad acronym in README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: standardize FAQ format across all FAQ pages

- Add TOC with jump links under "## Questions"
- Use ### headers for questions (no Q: prefix)
- Direct answers without **A:** prefix
- Remove horizontal rules and "Related Documentation" sections
- End each FAQ with issue/Discord CTA
- Update style guide with new FAQ guidelines
- Delete redundant faq/index.md (sidebar handles navigation)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use repo-relative links with .md for GitHub compatibility

Convert all documentation links to repo-relative format (/docs/path/file.md)
so they work when browsing on GitHub. The rehype plugin strips /docs/ prefix
and converts .md to trailing slash at build time for Astro/Starlight.

- Update rehype-markdown-links.js to strip /docs/ prefix from absolute paths
- Update fix-doc-links.js to generate /docs/ prefixed paths with .md extension
- Convert 217 links across 64 files to new format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: handle /docs/ prefix in link validator

Update resolveLink to strip /docs/ prefix from repo-relative links
before checking if files exist.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: restore FAQ index page

Re-add the FAQ index page that was accidentally deleted, with
updated repo-relative link format.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
2026-01-10 02:55:33 +08:00

4.0 KiB

title, description
title description
Agents Reference Complete reference for BMad Method agents and their commands

Quick reference of all BMad Method agents and their available commands.


Analyst (Mary)

Business analysis and research.

Commands:

  • *workflow-status - Get workflow status or initialize tracking
  • *brainstorm-project - Guided brainstorming session
  • *research - Market, domain, competitive, or technical research
  • *product-brief - Create a product brief (input for PRD)
  • *document-project - Document existing brownfield projects

PM (John)

Product requirements and planning.

Commands:

  • *workflow-status - Get workflow status or initialize tracking
  • *create-prd - Create Product Requirements Document
  • *create-epics-and-stories - Break PRD into epics and user stories (after Architecture)
  • *implementation-readiness - Validate PRD, UX, Architecture, Epics alignment
  • *correct-course - Course correction during implementation

Architect (Winston)

System architecture and technical design.

Commands:

  • *workflow-status - Get workflow status or initialize tracking
  • *create-architecture - Create architecture document to guide development
  • *implementation-readiness - Validate PRD, UX, Architecture, Epics alignment
  • *create-excalidraw-diagram - System architecture or technical diagrams
  • *create-excalidraw-dataflow - Data flow diagrams

SM (Bob)

Sprint planning and story preparation.

Commands:

  • *sprint-planning - Generate sprint-status.yaml from epic files
  • *create-story - Create story from epic (prep for development)
  • *validate-create-story - Validate story quality
  • *epic-retrospective - Team retrospective after epic completion
  • *correct-course - Course correction during implementation

DEV (Amelia)

Story implementation and code review.

Commands:

  • *dev-story - Execute story workflow (implementation with tests)
  • *code-review - Thorough code review

Quick Flow Solo Dev (Barry)

Fast solo development without handoffs.

Commands:

  • *create-tech-spec - Architect technical spec with implementation-ready stories
  • *quick-dev - Implement tech spec end-to-end solo
  • *code-review - Review and improve code

TEA (Murat)

Test architecture and quality strategy.

Commands:

  • *framework - Initialize production-ready test framework
  • *atdd - Generate E2E tests first (before implementation)
  • *automate - Comprehensive test automation
  • *test-design - Create comprehensive test scenarios
  • *trace - Map requirements to tests, quality gate decision
  • *nfr-assess - Validate non-functional requirements
  • *ci - Scaffold CI/CD quality pipeline
  • *test-review - Review test quality

UX Designer (Sally)

User experience and UI design.

Commands:

  • *create-ux-design - Generate UX design and UI plan from PRD
  • *validate-design - Validate UX specification and design artifacts
  • *create-excalidraw-wireframe - Create website or app wireframe

Technical Writer (Paige)

Technical documentation and diagrams.

Commands:

  • *document-project - Comprehensive project documentation
  • *generate-mermaid - Generate Mermaid diagrams
  • *create-excalidraw-flowchart - Process and logic flow visualizations
  • *create-excalidraw-diagram - System architecture or technical diagrams
  • *create-excalidraw-dataflow - Data flow visualizations
  • *validate-doc - Review documentation against standards
  • *improve-readme - Review and improve README files
  • *explain-concept - Create clear technical explanations
  • *standards-guide - Show BMad documentation standards

Universal Commands

Available to all agents:

  • *menu - Redisplay menu options
  • *dismiss - Dismiss agent
  • *party-mode - Multi-agent collaboration (most agents)