fix(docs): correct skill names in getting-started tutorials

[alexeyv]

Summary

• Fixed agent skill references using non-existent shortened names (bmad-pm, bmad-architect, bmad-sm, bmad-ux-designer, bmad-analyst) to use actual installed skill names (bmad-agent-pm, bmad-agent-architect, bmad-agent-sm, bmad-agent-ux-designer, bmad-agent-analyst) across EN, ZH-CN, and FR getting-started tutorials
• Fixed bmad-research (non-existent) to list the three actual research skills (bmad-market-research / bmad-domain-research / bmad-technical-research) in EN and FR
• Fixed bmad-product-brief (non-existent) to bmad-create-product-brief in ZH-CN

Test plan

• npm ci && npm run quality passes
• Verify skill names match installed skills after running the installer

🤖 Generated with Claude Code

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 92ce085e-700d-4700-936a-5e3ba07b3b8b

📥 Commits

Reviewing files that changed from the base of the PR and between ba2a5cc and 6f2878b.

📒 Files selected for processing (3)

• docs/fr/tutorials/getting-started.md
• docs/tutorials/getting-started.md
• docs/zh-cn/tutorials/getting-started.md

---

📝 Walkthrough

Walkthrough

Updates documentation across English, French, and Chinese language versions to reflect agent naming convention changes from bmad-<role> to bmad-agent-<role> and expand the research workflow from a single command to three categorized alternatives.

Changes

Cohort / File(s)	Summary
Agent and Workflow Command Naming Updates docs/tutorials/getting-started.md, docs/fr/tutorials/getting-started.md, docs/zh-cn/tutorials/getting-started.md	Updated agent skill references from bmad-<role> to bmad-agent-<role> (pm, architect, ux-designer, sm, analyst); expanded Phase 1 research from bmad-research to bmad-market-research, bmad-domain-research, bmad-technical-research across all language variants. Chinese version additionally updates bmad-product-brief to bmad-create-product-brief.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• #1505: Modifies the same getting-started docs to update agent and workflow command references using the bmad-agent-* naming convention.
• #2035: Updates manifest changes that rename agent entries from bmad- to bmad-agent- form, complementing these documentation updates.
• #1928: Converts domain research workflow into a native bmad-domain-research skill, aligning with the research command expansion in this documentation update.

Suggested reviewers

• bmadcode

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/fix-skill-names

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Tip

CodeRabbit can use your project's `biome` configuration to improve the quality of JS/TS/CSS/JSON code reviews.

Add a configuration file to your project to customize how CodeRabbit runs biome.

[augmentcode]

🤖 Augment PR Summary

Summary: Fixes onboarding docs that referenced skill names users can’t actually invoke after installation.


Changes:

• Updates getting-started tutorials (EN/FR/ZH-CN) to use the full installed agent skill IDs (e.g., bmad-agent-pm, bmad-agent-architect, bmad-agent-sm).
• Replaces the non-existent bmad-research reference with the three concrete research skills (bmad-market-research, bmad-domain-research, bmad-technical-research).
• Adjusts examples/FAQ guidance so users invoke the correct agent skills when starting workflows.

Technical Notes: Documentation-only change meant to reduce “skill not found” friction during the getting-started flow.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 1 suggestion posted.

Comment augment review to trigger a new review at any time.

[augmentcode]

bmad-create-product-brief doesn’t appear to be an installable skill name in this repo (the skill directory/frontmatter is bmad-product-brief, and its manifest indicates it replaces bmad-create-product-brief). Can you double-check which invocation name users will actually have after install so the tutorial doesn’t point to a missing skill?

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

[eatse21]

Should we harmonize the names elsewhere also?

I noticed those places that may need changes:

BMAD-METHOD/docs/reference/agents.md

Line 14 in fce9d6c

- Each agent is available as a skill, generated by the installer. The skill ID (e.g., `bmad-dev`) is used to invoke the agent.

BMAD-METHOD/docs/reference/agents.md

Lines 20 to 28 in fce9d6c

	| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `DP` | Brainstorm Project, Research, Create Brief, Document Project |
	| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Create/Validate/Edit PRD, Create Epics and Stories, Implementation Readiness, Correct Course |
	| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness |
	| Scrum Master (Bob) | `bmad-sm` | `SP`, `CS`, `ER`, `CC` | Sprint Planning, Create Story, Epic Retrospective, Correct Course |
	| Developer (Amelia) | `bmad-dev` | `DS`, `CR` | Dev Story, Code Review |
	| QA Engineer (Quinn) | `bmad-qa` | `QA` | Automate (generate tests for existing features) |
	| Quick Flow Solo Dev (Barry) | `bmad-master` | `QD`, `CR` | Quick Dev, Code Review |
	| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design |
	| Technical Writer (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept |

BMAD-METHOD/docs/reference/commands.md

Lines 57 to 62 in fce9d6c

	├── bmad-dev/
	│ └── SKILL.md
	└── ...
	```
	The directory name determines the skill name in your IDE. For example, the directory `bmad-dev/` registers the skill `bmad-dev`.

BMAD-METHOD/docs/reference/commands.md

Lines 81 to 85 in fce9d6c

	| --- | --- | --- |
	| `bmad-dev` | Amelia (Developer) | Implements stories with strict adherence to specs |
	| `bmad-pm` | John (Product Manager) | Creates and validates PRDs |
	| `bmad-architect` | Winston (Architect) | Designs system architecture |
	| `bmad-sm` | Bob (Scrum Master) | Manages sprints and stories |

BMAD-METHOD/docs/reference/commands.md

Line 126 in fce9d6c

All skills use the `bmad-` prefix followed by a descriptive name (e.g., `bmad-dev`, `bmad-create-prd`, `bmad-help`). See [Modules](./modules.md) for available modules.

And subsequent translations