BMAD-METHOD/agent-roles.md at 2e16650067f0a12751a95ff22a4277f74b0c4f10

mirror of https://github.com/bmad-code-org/BMAD-METHOD.git synced 2026-01-30 04:32:02 +00:00

Files

Alex Verkhovsky 2e16650067 feat(docs): Diataxis restructure + Astro/Starlight migration (#1263 )

* feat(docs): add Diataxis folder structure and update sidebar styling

- Create tutorials, how-to, explanation, reference directories with subdirectories
- Add index.md files for each main Diataxis section
- Update homepage with Diataxis card navigation layout
- Implement clean React Native-inspired sidebar styling
- Convert sidebar to autogenerated for both Diataxis and legacy sections
- Update docusaurus config with dark mode default and navbar changes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat(docs): migrate Phase 1 files to Diataxis structure

Move 21 files to new locations:
- Tutorials: quick-start guides, agent creation guide
- How-To: installation, customization, workflows
- Explanation: core concepts, features, game-dev, builder
- Reference: merged glossary from BMM and BMGD

Also:
- Copy images to new locations
- Update internal links via migration script (73 links updated)
- Build verified successfully

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix(docs): add category labels for sidebar folders

Add _category_.json files to control display labels and position
for autogenerated sidebar categories.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* style(docs): improve welcome page and visual styling

- Rewrite index.md with React Native-inspired welcoming layout
- Add Diataxis section cards with descriptions
- Remove sidebar separator, add spacing instead
- Increase navbar padding with responsive breakpoints
- Add rounded admonitions without left border bar
- Use system font stack for better readability
- Add lighter chevron styling in sidebar
- Constrain max-width to 1600px for wide viewports

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix: use baseUrl in meta tag paths for correct deployment URLs

* feat(docs): complete Phase 2 - split files and fix broken links

Phase 2 of Diataxis migration:
- Split 16 large legacy files into 42+ focused documents
- Created FAQ section with 7 topic-specific files
- Created brownfield how-to guides (3 files)
- Created workflow how-to guides (15+ files)
- Created architecture explanation files (3 files)
- Created TEA/testing explanation files
- Moved remaining legacy module files to proper Diataxis locations

Link fixes:
- Fixed ~50 broken internal links across documentation
- Updated relative paths for new file locations
- Created missing index files for installation, advanced tutorials
- Simplified TOC anchors to fix Docusaurus warnings

Cleanup:
- Removed legacy sidebar entries for deleted folders
- Deleted duplicate and empty placeholder files
- Moved workflow diagram assets to tutorials/images

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix(build): use file glob instead of sidebar parsing for llms-full.txt

Replace brittle sidebar.js regex parsing with recursive file glob.
The old approach captured non-file strings like 'autogenerated' and
category labels, resulting in only 5 files being processed.

Now correctly processes all 86+ markdown files (~95k tokens).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix(seo): use absolute URLs in AI meta tags for agent discoverability

AI web-browsing agents couldn't follow relative paths in meta tags due to
URL security restrictions. Changed llms-full.txt and llms.txt meta tag
URLs from relative (baseUrl) to absolute (urlParts.origin + baseUrl).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* refactor(docs): recategorize misplaced files per Diataxis analysis

Phase 2.5 categorization fixes based on post-migration analysis:

Moved to correct Diataxis categories:
- tutorials/installation.md → deleted (duplicate of how-to/install-bmad.md)
- tutorials/brownfield-onboarding.md → how-to/brownfield/index.md
- reference/faq/* (8 files) → explanation/faq/
- reference/agents/barry-quick-flow.md → explanation/agents/
- reference/agents/bmgd-agents.md → explanation/game-dev/agents.md

Created:
- explanation/agents/index.md

Fixed all broken internal links (14 total)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat(docs): add Getting Started tutorial and simplify build script

- Add comprehensive Getting Started tutorial with installation as Step 1
- Simplify build-docs.js to read directly from docs/ (no consolidation)
- Remove backup/restore dance that could corrupt docs folder on build failure
- Remove ~150 lines of unused consolidation code

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix(css): use fixed width layout to prevent content shifting

Apply React Native docs approach: set both width and max-width at
largest breakpoint (1400px) so content area maintains consistent
size regardless of content length. Switches to fluid 100% below
1416px breakpoint.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* refactor(docs): restructure tutorials with renamed entry point

- Rename index.md to bmad-tutorial.md for clearer navigation
- Remove redundant tutorials/index.md
- Update sidebar and config references

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat(docs): add tutorial style guide and AI agent announcement bar

- Add docs/_contributing/ with tutorial style guide
- Reformat quick-start-bmm.md and bmad-tutorial.md per style guide
- Remove horizontal separators, add strategic admonitions
- Add persistent announcement bar for AI agents directing to llms-full.txt
- Fix footer broken link to tutorials

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat(docs): add markdown demo page and UI refinements

- Add comprehensive markdown-demo.md for style testing
- Remove doc category links from navbar (use sidebar instead)
- Remove card buttons from welcome page
- Add dark mode styling for announcement bar
- Clean up index.md card layout

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat(docs): apply unified tutorial style and update references

- Reformat create-custom-agent.md to follow tutorial style guide
- Update tutorial-style.md with complete unified structure
- Update all internal references to renamed tutorial files
- Remove obsolete advanced/index.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* refactor(docs): migrate from Docusaurus to Astro+Starlight

Replace Docusaurus with Astro and the Starlight documentation theme
for improved performance, better customization, and modern tooling.

Build pipeline changes:
- New build-docs.js orchestrates link checking, artifact generation,
  and Astro build in sequence
- Add check-doc-links.js for validating internal links and anchors
- Generate llms.txt and llms-full.txt for LLM-friendly documentation
- Create downloadable source bundles (bmad-sources.zip, bmad-prompts.zip)
- Suppress MODULE_TYPELESS_PACKAGE_JSON warning in Astro build
- Output directly to build/site for cleaner deployment

Website architecture:
- Add rehype-markdown-links.js plugin to transform .md links to routes
- Add site-url.js helper for GitHub Pages URL resolution with strict
  validation (throws on invalid GITHUB_REPOSITORY format)
- Custom Astro components: Banner, Header, MobileMenuFooter
- Symlink docs/ into website/src/content/docs for Starlight

Documentation cleanup:
- Remove Docusaurus _category_.json files (Starlight uses frontmatter)
- Convert all docs to use YAML frontmatter with title field
- Move downloads.md from website/src/pages to docs/
- Consolidate style guide and workflow diagram docs
- Add 404.md and tutorials/index.md

---------

Co-authored-by: forcetrainer <bryan@inagaki.us>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-07 14:42:15 +08:00

4.6 KiB

Raw Blame History

title, description

title	description
Agent Roles in BMad Method	Understanding the different agent roles in BMad Method

BMad Method uses specialized AI agents, each with a distinct role, expertise, and personality. Understanding these roles helps you know which agent to use for each task.

Core Agents Overview

Agent	Role	Primary Phase
Analyst	Research and discovery	Phase 1 (Analysis)
PM	Requirements and planning	Phase 2 (Planning)
Architect	Technical design	Phase 3 (Solutioning)
SM	Sprint orchestration	Phase 4 (Implementation)
DEV	Code implementation	Phase 4 (Implementation)
TEA	Test architecture	Phases 3-4 (Cross-phase)
UX Designer	User experience	Phase 2-3
Quick Flow Solo Dev	Fast solo development	All phases (Quick Flow)

Phase 1: Analysis

Analyst (Mary)

Business analysis and research specialist.

Responsibilities:

Brainstorming and ideation
Market, domain, and competitive research
Product brief creation
Brownfield project documentation

Key Workflows:

*brainstorm-project
*research
*product-brief
*document-project

When to use: Starting new projects, exploring ideas, validating market fit, documenting existing codebases.

Phase 2: Planning

PM (John)

Product requirements and planning expert.

Responsibilities:

Creating Product Requirements Documents
Defining functional and non-functional requirements
Breaking requirements into epics and stories
Validating implementation readiness

Key Workflows:

*create-prd
*create-epics-and-stories
*implementation-readiness

When to use: Defining what to build, creating PRDs, organizing work into stories.

UX Designer (Sally)

User experience and UI design specialist.

Responsibilities:

UX specification creation
User journey mapping
Wireframe and mockup design
Design system documentation

Key Workflows:

*create-ux-design
*validate-design

When to use: When UX is a primary differentiator, complex user workflows, design system creation.

Phase 3: Solutioning

Architect (Winston)

System architecture and technical design expert.

Responsibilities:

System architecture design
Architecture Decision Records (ADRs)
Technical standards definition
Implementation readiness validation

Key Workflows:

*create-architecture
*implementation-readiness

When to use: Multi-epic projects, cross-cutting technical decisions, preventing agent conflicts.

Phase 4: Implementation

SM (Bob)

Sprint planning and story preparation orchestrator.

Responsibilities:

Sprint planning and tracking
Story preparation for development
Course correction handling
Epic retrospectives

Key Workflows:

*sprint-planning
*create-story
*correct-course
*epic-retrospective

When to use: Organizing work, preparing stories, tracking progress.

DEV (Amelia)

Story implementation and code review specialist.

Responsibilities:

Story implementation with tests
Code review
Following architecture patterns
Quality assurance

Key Workflows:

*dev-story
*code-review

When to use: Writing code, implementing stories, reviewing quality.

Cross-Phase Agents

TEA (Murat)

Test architecture and quality strategy expert.

Responsibilities:

Test framework setup
Test design and planning
ATDD and automation
Quality gate decisions

Key Workflows:

*framework, *ci
*test-design, *atdd, *automate
*test-review, *trace, *nfr-assess

When to use: Setting up testing, creating test plans, quality gates.

Quick Flow

Quick Flow Solo Dev (Barry)

Fast solo development without handoffs.

Responsibilities:

Technical specification
End-to-end implementation
Code review

Key Workflows:

*create-tech-spec
*quick-dev
*code-review

When to use: Bug fixes, small features, rapid prototyping.

Choosing the Right Agent

Task	Agent
Brainstorming ideas	Analyst
Market research	Analyst
Creating PRD	PM
Designing UX	UX Designer
System architecture	Architect
Preparing stories	SM
Writing code	DEV
Setting up tests	TEA
Quick bug fix	Quick Flow Solo Dev

What Are Agents - Foundational concepts
Agent Reference - Complete command reference
Quick Start Guide

4.6 KiB Raw Blame History

Core Agents Overview

Phase 1: Analysis

Analyst (Mary)

Phase 2: Planning

PM (John)

UX Designer (Sally)

Phase 3: Solutioning

Architect (Winston)

Phase 4: Implementation

SM (Bob)

DEV (Amelia)

Cross-Phase Agents

TEA (Murat)

Quick Flow

Quick Flow Solo Dev (Barry)

Choosing the Right Agent

Related

4.6 KiB

Raw Blame History