ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity

Merge 20318b3dbf into 189c2b85eb

This commit is contained in:
Loic Duong 2026-05-25 01:51:12 +00:00 committed by GitHub
parent 189c2b85eb 20318b3dbf
commit c7cf2b494b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
26 changed files with 565 additions and 360 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@ -73,9 +73,11 @@ BMad Method extends with official modules for specialized domains. Available dur
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Core framework with 34+ workflows | | **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Core framework with 34+ workflows |
| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Create custom BMad agents and workflows | | **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Create custom BMad agents and workflows |
| **[BMad Automator](https://github.com/bmad-code-org/bmad-automator)** | Experimental story epic automation for Claude and Codex |
| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Risk-based test strategy and automation | | **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Risk-based test strategy and automation |
| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Game development workflows (Unity, Unreal, Godot) | | **[Game Dev Studio (GDS)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Game development workflows (Unity, Unreal, Godot) |
| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Innovation, brainstorming, design thinking | | **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Innovation, brainstorming, design thinking |
| **[Whiteport Design Studio (WDS)](https://github.com/bmad-code-org/bmad-method-wds-expansion)** | Strategic UX and design-first planning |
## Documentation ## Documentation

23
README_VN.md
View File

@ -2,14 +2,14 @@
[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method) [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.12.0-brightgreen)](https://nodejs.org)
[![Python Version](https://img.shields.io/badge/python-%3E%3D3.10-blue?logo=python&logoColor=white)](https://www.python.org) [![Python Version](https://img.shields.io/badge/python-%3E%3D3.10-blue?logo=python&logoColor=white)](https://www.python.org)
[![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/) [![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/)
[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj) [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
[English](README.md) | [简体中文](README_CN.md) | Tiếng Việt [English](README.md) | [简体中文](README_CN.md) | Tiếng Việt
**Build More Architect Dreams** - một mô-đun khung phát triển hướng AI trong hệ sinh thái BMad, có khả năng thích ứng theo quy mô từ sửa lỗi nhỏ đến các hệ thống doanh nghiệp. **Build More Architect Dreams** - một mô-đun phát triển agile hướng AI trong hệ sinh thái module BMad Method, framework phát triển Agile AI Driven tốt nhất và toàn diện nhất, với trí thông minh thích ứng thật sự theo quy mô từ sửa lỗi nhỏ đến các hệ thống doanh nghiệp.
**100% miễn phí và mã nguồn mở.** Không có tường phí. Không có nội dung bị khóa. Không có Discord giới hạn quyền truy cập. Chúng tôi tin vào việc trao quyền cho mọi người, không chỉ cho những ai có thể trả tiền để vào một cộng đồng hay khóa học khép kín. **100% miễn phí và mã nguồn mở.** Không có tường phí. Không có nội dung bị khóa. Không có Discord giới hạn quyền truy cập. Chúng tôi tin vào việc trao quyền cho mọi người, không chỉ cho những ai có thể trả tiền để vào một cộng đồng hay khóa học khép kín.
@ -20,7 +20,7 @@ Các công cụ AI truyền thống thường làm thay phần suy nghĩ của b
- **Trợ giúp AI thông minh** - Gọi skill `bmad-help` bất kỳ lúc nào để biết bước tiếp theo - **Trợ giúp AI thông minh** - Gọi skill `bmad-help` bất kỳ lúc nào để biết bước tiếp theo
- **Thích ứng theo quy mô và miền bài toán** - Tự động điều chỉnh độ sâu lập kế hoạch theo độ phức tạp của dự án - **Thích ứng theo quy mô và miền bài toán** - Tự động điều chỉnh độ sâu lập kế hoạch theo độ phức tạp của dự án
- **Quy trình có cấu trúc** - Dựa trên các thực hành tốt nhất của agile xuyên suốt phân tích, lập kế hoạch, kiến trúc và triển khai - **Quy trình có cấu trúc** - Dựa trên các thực hành tốt nhất của agile xuyên suốt phân tích, lập kế hoạch, kiến trúc và triển khai
- **Agent chuyên biệt** - Hơn 12 chuyên gia theo vai trò như PM, Architect, Developer, UX, Scrum Master và nhiều vai trò khác - **Agent chuyên biệt** - Hơn 12 chuyên gia theo vai trò như PM, Architect, Developer, UX và nhiều vai trò khác
- **Party Mode** - Đưa nhiều persona agent vào cùng một phiên để cộng tác và thảo luận - **Party Mode** - Đưa nhiều persona agent vào cùng một phiên để cộng tác và thảo luận
- **Vòng đời hoàn chỉnh** - Từ động não ý tưởng cho đến triển khai - **Vòng đời hoàn chỉnh** - Từ động não ý tưởng cho đến triển khai
@ -38,7 +38,7 @@ Các công cụ AI truyền thống thường làm thay phần suy nghĩ của b
## Bắt đầu nhanh ## Bắt đầu nhanh
**Điều kiện tiên quyết**: [Node.js](https://nodejs.org) v20+ · [Python](https://www.python.org) 3.10+ · [uv](https://docs.astral.sh/uv/) **Điều kiện tiên quyết**: [Node.js](https://nodejs.org) v20.12+ · [Python](https://www.python.org) 3.10+ · [uv](https://docs.astral.sh/uv/)
```bash ```bash
npx bmad-method install npx bmad-method install
@ -54,6 +54,15 @@ Làm theo các lời nhắc của trình cài đặt, sau đó mở AI IDE của
npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes
``` ```
Ghi đè bất kỳ tùy chọn cấu hình module nào bằng `--set <module>.<key>=<value>` (có thể lặp lại). Chạy `--list-options [module]` để xem các key chính thức mà máy hiện biết (module tích hợp sẵn cộng với mọi module chính thức bên ngoài đã được cache trên máy này):
```bash
npx bmad-method install --yes \
--modules bmm --tools claude-code \
--set bmm.project_knowledge=research \
--set bmm.user_skill_level=expert
```
[Xem toàn bộ tùy chọn cài đặt](https://docs.bmad-method.org/vi-vn/how-to/non-interactive-installation/) [Xem toàn bộ tùy chọn cài đặt](https://docs.bmad-method.org/vi-vn/how-to/non-interactive-installation/)
> **Chưa chắc nên làm gì?** Hãy hỏi `bmad-help` - nó sẽ cho bạn biết chính xác bước nào tiếp theo và bước nào là tùy chọn. Bạn cũng có thể hỏi kiểu như `bmad-help Tôi vừa hoàn thành phần kiến trúc, tiếp theo tôi cần làm gì?` > **Chưa chắc nên làm gì?** Hãy hỏi `bmad-help` - nó sẽ cho bạn biết chính xác bước nào tiếp theo và bước nào là tùy chọn. Bạn cũng có thể hỏi kiểu như `bmad-help Tôi vừa hoàn thành phần kiến trúc, tiếp theo tôi cần làm gì?`
@ -66,9 +75,11 @@ BMad Method có thể được mở rộng bằng các mô-đun chính thức ch
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Khung lõi với hơn 34 quy trình | | **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Khung lõi với hơn 34 quy trình |
| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Tạo agent và quy trình BMad tùy chỉnh | | **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Tạo agent và quy trình BMad tùy chỉnh |
| **[BMad Automator](https://github.com/bmad-code-org/bmad-automator)** | Tự động hóa story epic thử nghiệm cho Claude và Codex |
| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Chiến lược kiểm thử và tự động hóa dựa trên rủi ro | | **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Chiến lược kiểm thử và tự động hóa dựa trên rủi ro |
| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Quy trình phát triển game (Unity, Unreal, Godot) | | **[Game Dev Studio (GDS)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Quy trình phát triển game (Unity, Unreal, Godot) |
| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Đổi mới, động não ý tưởng, tư duy thiết kế | | **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Đổi mới, động não ý tưởng, tư duy thiết kế |
| **[Whiteport Design Studio (WDS)](https://github.com/bmad-code-org/bmad-method-wds-expansion)** | UX chiến lược và lập kế hoạch design-first |
## Tài liệu ## Tài liệu
@ -106,4 +117,4 @@ Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết.
[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors) [![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
Xem [CONTRIBUTORS.md](CONTRIBUTORS.md) để biết thông tin về những người đóng góp. Xem [CONTRIBUTORS.md](CONTRIBUTORS.md) để biết thông tin về những người đóng góp.

12
docs/cs/reference/agents.md
View File

@ -11,18 +11,18 @@ Tato stránka uvádí výchozí BMM (Agile suite) agenty, kteří se instalují
## Poznámky ## Poznámky
- Každý agent je dostupný jako skill, generovaný instalátorem. Skill ID (např. `bmad-dev`) se používá k vyvolání agenta. - Každý agent je dostupný jako skill, generovaný instalátorem. Skill ID (např. `bmad-agent-dev`) se používá k vyvolání agenta.
- Spouštěče jsou krátké kódy nabídky (např. `CP`) a fuzzy shody zobrazené v nabídce každého agenta. - Spouštěče jsou krátké kódy nabídky (např. `CP`) a fuzzy shody zobrazené v nabídce každého agenta.
- Generování QA testů zajišťuje workflow skill `bmad-qa-generate-e2e-tests`, dostupný přes Developer agenta. Plný Test Architect (TEA) žije ve vlastním modulu. - Generování QA testů zajišťuje workflow skill `bmad-qa-generate-e2e-tests`, dostupný přes Developer agenta. Plný Test Architect (TEA) žije ve vlastním modulu.
| Agent | Skill ID | Spouštěče | Primární workflow | | Agent | Skill ID | Spouštěče | Primární workflow |
| --------------------------- | -------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------- | | --------------------------- | -------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Analyst (Mary) | `bmad-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, průzkum trhu, doménový výzkum, technický výzkum, tvorba briefu, PRFAQ výzva, dokumentace projektu | | Analyst (Mary) | `bmad-agent-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, průzkum trhu, doménový výzkum, technický výzkum, tvorba briefu, PRFAQ výzva, dokumentace projektu |
| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Tvorba/validace/editace PRD, tvorba epiců a stories, připravenost implementace, korekce kurzu | | Product Manager (John) | `bmad-agent-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Tvorba/validace/editace PRD, tvorba epiců a stories, připravenost implementace, korekce kurzu |
| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Tvorba architektury, připravenost implementace | | Architect (Winston) | `bmad-agent-architect` | `CA`, `IR` | Tvorba architektury, připravenost implementace |
| Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev story, Quick Dev, generování QA testů, revize kódu, plánování sprintu, tvorba story, retrospektiva epicu | | Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev story, Quick Dev, generování QA testů, revize kódu, plánování sprintu, tvorba story, retrospektiva epicu |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Tvorba UX designu | | UX Designer (Sally) | `bmad-agent-ux-designer` | `CU` | Tvorba UX designu |
| Technical Writer (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Dokumentace projektu, psaní dokumentu, aktualizace standardů, generování Mermaid, validace dok., vysvětlení konceptu | | Technical Writer (Paige) | `bmad-agent-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Dokumentace projektu, psaní dokumentu, aktualizace standardů, generování Mermaid, validace dok., vysvětlení konceptu |
## Typy spouštěčů ## Typy spouštěčů

6
docs/cs/reference/commands.md
View File

@ -80,8 +80,8 @@ Agentní skills načítají specializovanou AI personu s definovanou rolí, komu
| Příklad skillu | Agent | Role | | Příklad skillu | Agent | Role |
| --- | --- | --- | | --- | --- | --- |
| `bmad-agent-dev` | Amelia (Developer) | Implementuje stories s přísným dodržováním specifikací | | `bmad-agent-dev` | Amelia (Developer) | Implementuje stories s přísným dodržováním specifikací |
| `bmad-pm` | John (Product Manager) | Vytváří a validuje PRD | | `bmad-agent-pm` | John (Product Manager) | Vytváří a validuje PRD |
| `bmad-architect` | Winston (Architect) | Navrhuje systémovou architekturu | | `bmad-agent-architect` | Winston (Architect) | Navrhuje systémovou architekturu |
Viz [Agenti](./agents.md) pro úplný seznam výchozích agentů a jejich spouštěčů. Viz [Agenti](./agents.md) pro úplný seznam výchozích agentů a jejich spouštěčů.
@ -124,7 +124,7 @@ Základní modul zahrnuje 11 vestavěných nástrojů — revize, komprese, brai
## Konvence pojmenování ## Konvence pojmenování
Všechny skills používají prefix `bmad-` následovaný popisným názvem (např. `bmad-dev`, `bmad-create-prd`, `bmad-help`). Viz [Moduly](./modules.md) pro dostupné moduly. Všechny skills používají prefix `bmad-` následovaný popisným názvem (např. `bmad-agent-dev`, `bmad-create-prd`, `bmad-help`). Viz [Moduly](./modules.md) pro dostupné moduly.
## Řešení problémů ## Řešení problémů

12
docs/fr/reference/agents.md
View File

@ -11,18 +11,18 @@ Cette page liste les agents BMM (suite Agile) par défaut installés avec la mé
## Notes ## Notes
- Chaque agent est disponible en tant que skill, généré par l’installateur. L’identifiant de skill (par exemple, `bmad-dev`) est utilisé pour invoquer l’agent. - Chaque agent est disponible en tant que skill, généré par l’installateur. L’identifiant de skill (par exemple, `bmad-agent-dev`) est utilisé pour invoquer l’agent.
- Les déclencheurs sont les codes courts de menu (par exemple, `BP`) et les correspondances approximatives affichés dans chaque menu d’agent. - Les déclencheurs sont les codes courts de menu (par exemple, `BP`) et les correspondances approximatives affichés dans chaque menu d’agent.
- La génération de tests QA est gérée par le skill de workflow `bmad-qa-generate-e2e-tests`, disponible par l’agent Développeur. L’architecte de tests complet (TEA) se trouve dans son propre module. - La génération de tests QA est gérée par le skill de workflow `bmad-qa-generate-e2e-tests`, disponible par l’agent Développeur. L’architecte de tests complet (TEA) se trouve dans son propre module.
| Agent | Identifiant de skill | Déclencheurs | Workflows principaux | | Agent | Identifiant de skill | Déclencheurs | Workflows principaux |
|-----------------------------|----------------------|------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------| |-----------------------------|----------------------|------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Analyste (Mary) | `bmad-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorming du projet, Recherche marché/domaine/technique, Création du brief[^1], Défi PRFAQ, Documentation du projet | | Analyste (Mary) | `bmad-agent-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorming du projet, Recherche marché/domaine/technique, Création du brief[^1], Défi PRFAQ, Documentation du projet |
| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Créer/Valider/Éditer un PRD, Créer des Epics et Stories, vérifier l’état de préparation à l’Implémentation, Corriger le Cours | | Product Manager (John) | `bmad-agent-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Créer/Valider/Éditer un PRD, Créer des Epics et Stories, vérifier l’état de préparation à l’Implémentation, Corriger le Cours |
| Architecte (Winston) | `bmad-architect` | `CA`, `IR` | Créer l’architecture, Préparation à l’implémentation | | Architecte (Winston) | `bmad-agent-architect` | `CA`, `IR` | Créer l’architecture, Préparation à l’implémentation |
| Développeur (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev Story, Quick Dev, Génération de Tests QA, Code Review, Sprint Planning, Créer Story, Rétrospective d’Epic | | Développeur (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev Story, Quick Dev, Génération de Tests QA, Code Review, Sprint Planning, Créer Story, Rétrospective d’Epic |
| Designer UX (Sally) | `bmad-ux-designer` | `CU` | Création du design UX[^2] | | Designer UX (Sally) | `bmad-agent-ux-designer` | `CU` | Création du design UX[^2] |
| Rédacteur Technique (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Documentation du projet, Rédaction de documents, Mise à jour des standards, Génération de diagrammes Mermaid, Validation de documents, Explication de concepts | | Rédacteur Technique (Paige) | `bmad-agent-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Documentation du projet, Rédaction de documents, Mise à jour des standards, Génération de diagrammes Mermaid, Validation de documents, Explication de concepts |
## Types de déclencheurs ## Types de déclencheurs

4
docs/fr/reference/commands.md
View File

@ -80,8 +80,8 @@ Les skills d'agent chargent un persona[^2] IA spécialisé avec un rôle défini
| Exemple de skill | Agent | Rôle | | Exemple de skill | Agent | Rôle |
|------------------|------------------------|-------------------------------------------------------------| |------------------|------------------------|-------------------------------------------------------------|
| `bmad-agent-dev` | Amelia (Développeur) | Implémente les stories avec une adhérence stricte aux specs | | `bmad-agent-dev` | Amelia (Développeur) | Implémente les stories avec une adhérence stricte aux specs |
| `bmad-pm` | John (Product Manager) | Crée et valide les PRDs[^1] | | `bmad-agent-pm` | John (Product Manager) | Crée et valide les PRDs[^1] |
| `bmad-architect` | Winston (Architecte) | Conçoit l'architecture système | | `bmad-agent-architect` | Winston (Architecte) | Conçoit l'architecture système |
Consultez [Agents](./agents.md) pour la liste complète des agents par défaut et leurs déclencheurs. Consultez [Agents](./agents.md) pour la liste complète des agents par défaut et leurs déclencheurs.

6
docs/how-to/install-bmad.md
View File

@ -31,7 +31,7 @@ npx bmad-method install
The interactive flow asks you five things: The interactive flow asks you five things:
1. Installation directory (defaults to the current working directory) 1. Installation directory (defaults to the current working directory)
2. Which modules to install (checkboxes for core, bmm, bmb, cis, gds, tea) 2. Which modules to install (checkboxes for core, bmm, bmb, automator, cis, gds, wds, tea)
3. **"Ready to install (all stable)?"** — Yes accepts the latest released tag for every external module 3. **"Ready to install (all stable)?"** — Yes accepts the latest released tag for every external module
4. Which AI tools/IDEs to integrate with (claude-code, cursor, and others) 4. Which AI tools/IDEs to integrate with (claude-code, cursor, and others)
5. Per-module config (name, language, output folder) 5. Per-module config (name, language, output folder)
@ -53,7 +53,7 @@ Two independent axes control what ends up on disk.
### Axis 1: external module channels ### Axis 1: external module channels
Every external module — bmb, cis, gds, tea, and any community module — installs on one of three channels: Every external module — bmb, automator, cis, gds, wds, tea, and any community module — installs on one of three channels:
| Channel | What gets installed | Who picks this | | Channel | What gets installed | Who picks this |
| ------------------ | ---------------------------------------------------------------------------- | --------------------------------------- | | ------------------ | ---------------------------------------------------------------------------- | --------------------------------------- |
@ -138,7 +138,7 @@ Under `--yes`, patch and minor upgrades apply automatically. Majors stay frozen
Precedence when flags overlap: `--pin` beats `--next=` beats `--channel` / `--all-*` beats the registry default (`stable`). Precedence when flags overlap: `--pin` beats `--next=` beats `--channel` / `--all-*` beats the registry default (`stable`).
:::note[Example resolution] :::note[Example resolution]
`--all-next --pin cis=v0.2.0` puts bmb, gds, and tea on next while pinning cis to v0.2.0. `--all-next --pin cis=v0.2.0` puts bmb, automator, gds, wds, and tea on next while pinning cis to v0.2.0.
::: :::
### Recipes ### Recipes

6
docs/how-to/upgrade-to-v6.md
View File

@ -85,9 +85,9 @@ your-project/
| v4 Module | v6 Status | | v4 Module | v6 Status |
| ----------------------------- | ----------------------------------------- | | ----------------------------- | ----------------------------------------- |
| `.bmad-2d-phaser-game-dev` | Integrated into BMGD Module | | `.bmad-2d-phaser-game-dev` | Integrated into GDS module |
| `.bmad-2d-unity-game-dev` | Integrated into BMGD Module | | `.bmad-2d-unity-game-dev` | Integrated into GDS module |
| `.bmad-godot-game-dev` | Integrated into BMGD Module | | `.bmad-godot-game-dev` | Integrated into GDS module |
| `.bmad-infrastructure-devops` | Deprecated — new DevOps agent coming soon | | `.bmad-infrastructure-devops` | Deprecated — new DevOps agent coming soon |
| `.bmad-creative-writing` | Not adapted — new v6 module coming soon | | `.bmad-creative-writing` | Not adapted — new v6 module coming soon |

12
docs/reference/agents.md
View File

@ -11,18 +11,18 @@ This page lists the default BMM (Agile suite) agents that install with BMad Meth
## Notes ## Notes
- Each agent is available as a skill, generated by the installer. The skill ID (e.g., `bmad-dev`) is used to invoke the agent. - Each agent is available as a skill, generated by the installer. The skill ID (e.g., `bmad-agent-dev`) is used to invoke the agent.
- Triggers are the short menu codes (e.g., `CP`) and fuzzy matches shown in each agent menu. - Triggers are the short menu codes (e.g., `CP`) and fuzzy matches shown in each agent menu.
- QA test generation is handled by the `bmad-qa-generate-e2e-tests` workflow skill, available through the Developer agent. The full Test Architect (TEA) lives in its own module. - QA test generation is handled by the `bmad-qa-generate-e2e-tests` workflow skill, available through the Developer agent. The full Test Architect (TEA) lives in its own module.
| Agent | Skill ID | Triggers | Primary workflows | | Agent | Skill ID | Triggers | Primary workflows |
| --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- | | --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| Analyst (Mary) | `bmad-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, Market Research, Domain Research, Technical Research, Create Brief, PRFAQ Challenge, Document Project | | Analyst (Mary) | `bmad-agent-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, Market Research, Domain Research, Technical Research, Create Brief, PRFAQ Challenge, 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 | | Product Manager (John) | `bmad-agent-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 | | Architect (Winston) | `bmad-agent-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness |
| Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER`, `IN` | Dev Story, Quick Dev, QA Test Generation, Code Review, Sprint Planning, Create Story, Epic Retrospective, [Forensic Investigation](../explanation/forensic-investigation.md) | | Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER`, `IN` | Dev Story, Quick Dev, QA Test Generation, Code Review, Sprint Planning, Create Story, Epic Retrospective, [Forensic Investigation](../explanation/forensic-investigation.md) |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design | | UX Designer (Sally) | `bmad-agent-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 | | Technical Writer (Paige) | `bmad-agent-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept |
## Trigger Types ## Trigger Types

4
docs/reference/commands.md
View File

@ -80,8 +80,8 @@ Agent skills load a specialized AI persona with a defined role, communication st
| Example skill | Agent | Role | | Example skill | Agent | Role |
| --- | --- | --- | | --- | --- | --- |
| `bmad-agent-dev` | Amelia (Developer) | Implements stories with strict adherence to specs | | `bmad-agent-dev` | Amelia (Developer) | Implements stories with strict adherence to specs |
| `bmad-pm` | John (Product Manager) | Creates and validates PRDs | | `bmad-agent-pm` | John (Product Manager) | Creates and validates PRDs |
| `bmad-architect` | Winston (Architect) | Designs system architecture | | `bmad-agent-architect` | Winston (Architect) | Designs system architecture |
See [Agents](./agents.md) for the full list of default agents and their triggers. See [Agents](./agents.md) for the full list of default agents and their triggers.

37
docs/reference/modules.md
View File

@ -1,6 +1,6 @@
--- ---
title: Official Modules title: Official Modules
description: Add-on modules for building custom agents, creative intelligence, game development, and testing description: Add-on modules for building custom agents, automation, creative intelligence, game development, design, and testing
sidebar: sidebar:
order: 4 order: 4
--- ---
@ -41,6 +41,22 @@ AI-powered tools for structured creativity, ideation, and innovation during earl
- Storyteller and Presentation Master for narratives and pitches - Storyteller and Presentation Master for narratives and pitches
- Ideation frameworks including SCAMPER, Reverse Brainstorming, and problem reframing - Ideation frameworks including SCAMPER, Reverse Brainstorming, and problem reframing
## BMad Automator
Experimental automation module for generating implementation-ready story epics and running supported BMAD workflows with less manual orchestration. The module currently targets Claude and Codex workflows.
- **Code:** `automator`
- **npm:** [`bmad-story-automator`](https://www.npmjs.com/package/bmad-story-automator)
- **GitHub:** [bmad-code-org/bmad-automator](https://github.com/bmad-code-org/bmad-automator)
- **Default channel:** `next`
**Provides:**
- Epic-building automation for story-driven delivery
- Experimental workflow support for Claude and Codex users
- A faster path from planning artifacts to actionable implementation work
- Early-access functionality that may change more quickly than stable modules
## Game Dev Studio ## Game Dev Studio
Structured game development workflows adapted for Unity, Unreal, Godot, and custom engines. Supports rapid prototyping through Quick Flow and full-scale production with epic-driven sprints. Structured game development workflows adapted for Unity, Unreal, Godot, and custom engines. Supports rapid prototyping through Quick Flow and full-scale production with epic-driven sprints.
@ -56,6 +72,21 @@ Structured game development workflows adapted for Unity, Unreal, Godot, and cust
- Narrative design support for characters, dialogue, and world-building - Narrative design support for characters, dialogue, and world-building
- Coverage for 21+ game types with engine-specific architecture guidance - Coverage for 21+ game types with engine-specific architecture guidance
## Whiteport Design Studio
Strategic UX and design-first planning module for teams that need stronger product experience framing before implementation. WDS expands BMAD with structured UX discovery and design planning workflows.
- **Code:** `wds`
- **npm:** [`bmad-wds`](https://www.npmjs.com/package/bmad-wds)
- **GitHub:** [bmad-code-org/bmad-method-wds-expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion)
**Provides:**
- Design-first planning methodology for product and UX work
- Structured UX discovery before solutioning and implementation
- Strategic design workflows that complement BMAD's product planning flow
- Whiteport Design Studio skills exposed through the installer module picker
## Test Architect (TEA) ## Test Architect (TEA)
Enterprise-grade test strategy, automation guidance, and release gate decisions through an expert agent and nine structured workflows. TEA goes well beyond the built-in QA agent with risk-based prioritization and requirements traceability. Enterprise-grade test strategy, automation guidance, and release gate decisions through an expert agent and nine structured workflows. TEA goes well beyond the built-in QA agent with risk-based prioritization and requirements traceability.
@ -71,6 +102,6 @@ Enterprise-grade test strategy, automation guidance, and release gate decisions
- NFR assessment, CI setup, and framework scaffolding - NFR assessment, CI setup, and framework scaffolding
- P0-P3 prioritization with optional Playwright Utils and MCP integrations - P0-P3 prioritization with optional Playwright Utils and MCP integrations
## Community Modules ## Community and Custom Modules
Community modules and a module marketplace are coming. Check the [BMad GitHub organization](https://github.com/bmad-code-org) for updates. The interactive community module picker has been retired. Install community or third-party modules with `--custom-source <git-url-or-path>` from a Git repository or local path. See [Install custom and community modules](../how-to/install-custom-modules.md).

48
docs/vi-vn/bmad-developer-guide.md
View File

@ -96,20 +96,20 @@ Ba nhánh lập kế hoạch với độ phức tạp tăng dần:
| Agent | Tên nhân vật | Skill ID | Vai trò | | Agent | Tên nhân vật | Skill ID | Vai trò |
|---|---|---|---| |---|---|---|---|
| **Analyst** | Mary | `bmad-analyst` | Brainstorm, nghiên cứu thị trường/kỹ thuật, tạo Product Brief và PRFAQ | | **Analyst** | Mary | `bmad-agent-analyst` | Brainstorm, nghiên cứu thị trường/kỹ thuật, tạo Product Brief và PRFAQ |
| **Product Manager** | John | `bmad-pm` | Tạo và quản lý PRD, Epics, Stories, kiểm tra Implementation Readiness | | **Product Manager** | John | `bmad-agent-pm` | Tạo và quản lý PRD, Epics, Stories, kiểm tra Implementation Readiness |
| **Architect** | Winston | `bmad-architect` | Thiết kế Architecture, ADR, kiểm tra Implementation Readiness | | **Architect** | Winston | `bmad-agent-architect` | Thiết kế Architecture, ADR, kiểm tra Implementation Readiness |
| **Developer** | Amelia | `bmad-agent-dev` | Triển khai story, tạo test, code review, sprint planning | | **Developer** | Amelia | `bmad-agent-dev` | Triển khai story, tạo test, code review, sprint planning |
| **UX Designer** | Sally | `bmad-ux-designer` | Thiết kế UX specification | | **UX Designer** | Sally | `bmad-agent-ux-designer` | Thiết kế UX specification |
| **Technical Writer** | Paige | `bmad-tech-writer` | Viết tài liệu, cập nhật standards, giải thích khái niệm | | **Technical Writer** | Paige | `bmad-agent-tech-writer` | Viết tài liệu, cập nhật standards, giải thích khái niệm |
### 3.2. Cách gọi Agent ### 3.2. Cách gọi Agent
**Qua Skill** (Claude Code / Cursor): **Qua Skill** (Claude Code / Cursor):
``` ```
bmad-analyst bmad-agent-analyst
bmad-pm bmad-agent-pm
bmad-architect bmad-agent-architect
bmad-agent-dev bmad-agent-dev
``` ```
@ -192,7 +192,7 @@ PRD bao gồm: mục tiêu sản phẩm, functional requirements (FR), non-funct
**Thiết kế UX** — UX Designer Agent (Tùy chọn) **Thiết kế UX** — UX Designer Agent (Tùy chọn)
``` ```
Trigger: CU Trigger: CU
Đầu ra: ux-spec.md Đầu ra: ux-design-specification.md
``` ```
Dùng khi UX/UI là yếu tố quan trọng. Bao gồm user flows, component specs, interaction patterns. Dùng khi UX/UI là yếu tố quan trọng. Bao gồm user flows, component specs, interaction patterns.
@ -383,7 +383,7 @@ File `project-context.md` là "bản hiến pháp" kỹ thuật của dự án
```bash ```bash
# Mở agent Analyst # Mở agent Analyst
bmad-analyst bmad-agent-analyst
# Trong hội thoại, gõ trigger: # Trong hội thoại, gõ trigger:
BP # Brainstorm ý tưởng BP # Brainstorm ý tưởng
@ -395,7 +395,7 @@ MR # Research thị trường
```bash ```bash
# Mở agent PM # Mở agent PM
bmad-pm bmad-agent-pm
# Trigger tạo PRD # Trigger tạo PRD
CP # Create PRD (có hướng dẫn từng bước) CP # Create PRD (có hướng dẫn từng bước)
@ -406,7 +406,7 @@ VP # Validate PRD sau khi hoàn thiện
```bash ```bash
# Mở agent Architect # Mở agent Architect
bmad-architect bmad-agent-architect
# Trigger # Trigger
CA # Create Architecture CA # Create Architecture
@ -417,7 +417,7 @@ IR # Implementation Readiness Check
```bash ```bash
# Mở agent PM # Mở agent PM
bmad-pm bmad-agent-pm
# Trigger # Trigger
EP # Create Epics and Stories EP # Create Epics and Stories
@ -485,18 +485,18 @@ bmad-quick-dev
``` ```
Ngày 1-2: Analysis Ngày 1-2: Analysis
├── bmad-analyst → CB → product-brief.md ├── bmad-agent-analyst → CB → product-brief.md
└── (tùy chọn) bmad-analyst → MR → market-research.md └── (tùy chọn) bmad-agent-analyst → MR → market-research.md
Ngày 2-3: Planning Ngày 2-3: Planning
├── bmad-pm → CP → PRD.md ├── bmad-agent-pm → CP → PRD.md
├── bmad-pm → VP (validate) ├── bmad-agent-pm → VP (validate)
└── (nếu có UI) bmad-ux-designer → CU → ux-spec.md └── (nếu có UI) bmad-agent-ux-designer → CU → ux-design-specification.md
Ngày 3-4: Solutioning Ngày 3-4: Solutioning
├── bmad-architect → CA → architecture.md ├── bmad-agent-architect → CA → architecture.md
├── bmad-pm → EP → epics/ (stories) ├── bmad-agent-pm → EP → epics/ (stories)
└── bmad-architect → IR → PASS ✓ └── bmad-agent-architect → IR → PASS ✓
Ngày 5+: Implementation (lặp lại cho mỗi story) Ngày 5+: Implementation (lặp lại cho mỗi story)
├── bmad-agent-dev → SP → sprint-status.yaml ├── bmad-agent-dev → SP → sprint-status.yaml
@ -719,7 +719,7 @@ your-project/
│ ├── planning-artifacts/ │ ├── planning-artifacts/
│ │ ├── product-brief.md # Giai đoạn 1 output │ │ ├── product-brief.md # Giai đoạn 1 output
│ │ ├── PRD.md # Giai đoạn 2 output │ │ ├── PRD.md # Giai đoạn 2 output
│ │ ├── ux-spec.md # Giai đoạn 2 output (nếu có) │ │ ├── ux-design-specification.md # Giai đoạn 2 output (nếu có)
│ │ ├── architecture.md # Giai đoạn 3 output │ │ ├── architecture.md # Giai đoạn 3 output
│ │ └── epics/ # Giai đoạn 3 output │ │ └── epics/ # Giai đoạn 3 output
│ │ ├── epic-1-auth/ │ │ ├── epic-1-auth/
@ -731,8 +731,8 @@ your-project/
│ └── sprint-status.yaml # Tracking sprint │ └── sprint-status.yaml # Tracking sprint
│ │
├── .claude/skills/ # Skills cho Claude Code ├── .claude/skills/ # Skills cho Claude Code
│ ├── bmad-pm.md │ ├── bmad-agent-pm.md
│ ├── bmad-architect.md │ ├── bmad-agent-architect.md
│ └── ... │ └── ...
│ │
├── docs/ # Tài liệu dự án ├── docs/ # Tài liệu dự án

94
docs/vi-vn/explanation/forensic-investigation.md Normal file
View File

@ -0,0 +1,94 @@
---
title: "Điều tra pháp chứng"
description: Cách bmad-investigate đối xử với mọi vấn đề như một hiện trường, chấm cấp bằng chứng và tạo hồ sơ vụ án có cấu trúc để engineer hành động
sidebar:
order: 6
---
Bạn đưa cho `bmad-investigate` một crash log, stack trace, hoặc chỉ một câu "trước đây chạy được, giờ thì không". Skill sẽ tiếp quản kỷ luật của điều tra viên trong suốt lần chạy. Nó không lao vào sửa. Nó mở một hồ sơ vụ án.
Mọi phát hiện đều được chấm cấp. Mọi giả thuyết đều có trạng thái. Những hướng đi sai được giữ lại, không bị xóa. Đầu ra là một tài liệu mà một engineer khác có thể mở ra và hiểu ngay dù chưa có bối cảnh trước đó.
Trang này giải thích vì sao điều tra là một kỷ luật riêng, và skill đem lại điều gì mà workflow dev thông thường không có.
## Vấn đề của "cứ debug đi"
Debug thông thường trộn ba việc: nhìn bằng chứng, suy luận nguyên nhân và đổi code để thử lý thuyết. Khi ba việc này bị trộn lẫn, hai kiểu lỗi hay xuất hiện.
Thứ nhất là **khóa chặt vào câu chuyện ban đầu**. Câu chuyện hợp lý đầu tiên trở thành giả thuyết làm việc, rồi mọi quan sát bị uốn theo nó. Bug vẫn không sửa được cho tới khi ai đó bỏ cuộc và bắt đầu lại. Vài giờ sau.
Thứ hai là **mất trí nhớ bằng chứng**. Bạn đã truy vết một hướng, đã loại nó ra, nhưng không ghi lại vì sao. Hai ngày sau, với góc nhìn mới, bạn lại truy vết đúng hướng đó. Hoặc tệ hơn, một đồng nghiệp nhận bug và chạy lại đúng ngõ cụt bạn đã loại bỏ.
Thiết kế của skill là phản ứng trực tiếp với cả hai vấn đề này.
## Chấm cấp bằng chứng
Mọi phát hiện trong một cuộc điều tra thuộc một trong ba loại.
- **Đã xác nhận.** Được quan sát trực tiếp trong log, code hoặc dump; có trích dẫn cụ thể như `path:line`, timestamp log hoặc commit hash. Nếu ai hỏi "làm sao bạn biết?", bạn chỉ vào citation.
- **Được suy ra.** Theo logic từ bằng chứng đã xác nhận; chuỗi suy luận được trình bày. Nếu một bước trong chuỗi sai, kết luận suy ra sai, và bạn thấy chính xác bước nào.
- **Giả thuyết.** Hợp lý nhưng chưa được xác nhận. Nêu rõ bằng chứng nào sẽ xác nhận hoặc bác bỏ, và nói trước điều gì sẽ khép lại giả thuyết. Giả thuyết rõ ràng *không phải sự thật*.
Việc chấm cấp không phải để tỏ ra khiêm tốn. Nó giúp hồ sơ vụ án dễ đọc. Người đọc có thể quét phần Đã xác nhận để biết điều gì là thật, phần Được suy ra để biết điều gì kéo theo từ đó, và phần Giả thuyết để biết điều gì còn mở. Lẫn lộn ba loại này là lý do phổ biến nhất khiến điều tra xoáy vòng.
## Bám vào cứ điểm trước
Điều tra không bắt đầu từ một lý thuyết. Nó bắt đầu từ một mẩu bằng chứng đã xác nhận rồi mở rộng ra. Bằng chứng đó có thể là một thông báo lỗi cụ thể, một stack frame hoặc một dòng log có timestamp.
Điều này ngược với cách điều tra thường diễn ra. Ai đó có linh cảm, dựng lý thuyết, rồi săn bằng chứng ủng hộ. Linh cảm có thể đúng; *phương pháp* thì mong manh vì nó biến thiên kiến xác nhận thành mặc định.
Cứ điểm là một sự thật bạn có thể quay lại khi suy luận trở nên mơ hồ. Nếu một suy luận đưa bạn tới chỗ kỳ lạ, bạn có thể lần ngược về cứ điểm rồi thử một nhánh khác. Không có cứ điểm, bạn không biết phải hoàn tác bước nào.
Khi bằng chứng thưa thớt, skill nói rõ điều đó và chuyển sang khám phá theo giả thuyết: lập giả thuyết từ những gì đang có, xác định cách kiểm tra từng giả thuyết, rồi đưa ra danh sách thu thập dữ liệu theo ưu tiên. Thiếu bằng chứng tự nó cũng là một phát hiện.
## Kỷ luật giả thuyết
Giả thuyết không bao giờ bị xóa khỏi hồ sơ vụ án. Khi bằng chứng xác nhận hoặc bác bỏ một giả thuyết, trường **Status** đổi từ Open sang Confirmed hoặc Refuted, và phần **Resolution** giải thích bằng chứng nào đã kết luận nó.
Quy tắc này có chi phí thật: hồ sơ dài ra. Lợi ích cũng thật. Toàn bộ lịch sử suy luận trở thành một phần của đầu ra. Sáu tháng sau, khi một bug tương tự xuất hiện, người điều tra tiếp theo có thể đọc hồ sơ cũ và thấy hướng nào đã bị loại, vì sao. Không có lịch sử đó, mỗi điều tra viên mới lại chạy lại cùng các ngõ cụt.
Nó cũng rèn kỷ luật cho điều tra viên hiện tại. Nếu không thể xóa một giả thuyết sai, bạn phải bác bỏ nó bằng bằng chứng có citation. Lặng lẽ bỏ nó đi khi nó bất tiện không còn là lựa chọn.
## Thách thức tiền đề
Mô tả vấn đề của người dùng là một giả thuyết, không phải sự thật. "Cache bị hỏng" là điều người dùng *tin*. Trước khi skill xây cuộc điều tra quanh nó, các khẳng định kỹ thuật được xác minh độc lập. Nếu bằng chứng mâu thuẫn với tiền đề, báo cáo nói thẳng.
Đó là bản năng pháp chứng: lời khai của nhân chứng là dữ liệu, không phải chân lý. Đôi khi bug được báo là thật nhưng bị đặt nhãn sai. Đôi khi triệu chứng được mô tả lại là hệ quả downstream của nguyên nhân khác. Những cuộc điều tra coi tiền đề là chân lý sẽ chẩn đoán sai lỗi, và bug quay lại dưới hình thức hơi khác.
## Một bước đi được hiệu chỉnh
Skill là một quy trình duy nhất, không phải hai chế độ. Nó hiệu chỉnh liên tục mức độ cần săn lỗi cụ thể so với mức độ cần khám phá khu vực hệ thống.
Một case có triệu chứng như ticket, crash, thông báo lỗi hoặc "trước đây chạy được" sẽ nghiêng về theo dõi giả thuyết, dựng timeline và hướng sửa. Một case không có triệu chứng như hiểu một module trước khi đụng vào, đánh giá khả năng tái sử dụng hoặc xây mô hình tinh thần sẽ nghiêng về mapping input/output, lọc control flow và lập kế hoạch xác minh. Phần lớn case thật nằm giữa hai đầu, và hồ sơ phản ánh đúng sự cân bằng mà bằng chứng đòi hỏi.
Kỷ luật giữ nguyên dù case nằm ở đâu trên phổ đó: cứ điểm trước, chấm cấp bằng chứng, theo dõi giả thuyết, không xóa. Đầu ra luôn nằm ở `{implementation_artifacts}/investigations/{slug}-investigation.md`, với các phần không áp dụng cho case cụ thể được để trống hoặc bỏ qua.
Khi một bug sâu đòi hỏi hiểu subsystem rộng hơn, quy trình sẽ gộp các kỹ thuật mapping input/output, lọc control flow, lần ngược từ output và truy vết ranh giới giữa component ngay trong cùng hồ sơ. Mô hình khu vực hệ thống cũng nằm trong hồ sơ vụ án đó. Không có chuyển chế độ.
## Phương pháp nằm trong skill
Kỷ luật điều tra là thuộc tính của chính skill. Bất kỳ ai gọi `bmad-investigate` đều nhận lấy phương pháp và phong cách giao tiếp của nó trong lần chạy đó: chính xác lâm sàng, ngôn ngữ đặt bằng chứng trước, không nói lấp lửng, framing như hồ sơ vụ án. Khi skill kết thúc, người gọi quay lại giọng nói trước đó. Không đổi persona, chỉ đổi sắc thái theo nguyên tắc của skill.
Điều này quan trọng vì điều tra và triển khai thưởng cho hai bản năng khác nhau. Điều tra viên chậm và chính xác. Người triển khai nhanh và tự tin. Cùng một bộ não làm cả hai trong một phiên thường làm không trọn cả hai. Skill tạo ra tư thế điều tra ngay trong luồng làm việc, không cần đổi sang một danh tính riêng.
## Bạn nhận được gì
Một hồ sơ điều tra hoàn chỉnh:
- Tách phát hiện Đã xác nhận (có citation) khỏi Suy luận và Giả thuyết
- Giữ mọi giả thuyết từng được lập, cùng Status và Resolution cuối cùng
- Dựng lại timeline sự kiện từ nhiều nguồn bằng chứng
- Xác định lỗ hổng dữ liệu và điều chúng có thể giải quyết
- Đưa ra kết luận có thể hành động, dựa trên bằng chứng
- Bao gồm kế hoạch tái hiện khi đã xác định root cause
- Duy trì backlog điều tra cho các hướng còn cần khám phá
Đưa nó cho một engineer không có mặt trong phiên, họ hiểu chuyện gì đã xảy ra, điều gì đã biết và điều gì vẫn còn bất định. Đó là tiêu chuẩn.
## Ý tưởng lớn hơn
Phần lớn "AI debugging" hiện nay trộn bằng chứng, suy luận và thay đổi code vào một dòng văn bản nghe có vẻ hợp lý. Tín hiệu khó tìm, ngõ cụt lặp lại, và hồ sơ vụ án, nếu có, chỉ là chat log không ai muốn đọc.
`bmad-investigate` coi điều tra là một kỷ luật với đầu ra riêng. Bằng chứng có cấp. Giả thuyết có trạng thái. Hướng đi sai được ghi lại, không bị xóa. Hồ sơ vụ án sống lâu hơn phiên làm việc.
Khi bug tiếp theo xuất hiện và trông giống một bug bạn từng thấy, bạn có chỗ để bắt đầu thay vì một prompt trắng.

2
docs/vi-vn/explanation/named-agents.md
View File

@ -84,7 +84,7 @@ Ngoài ra còn có một bề mặt tùy chỉnh thứ hai cho các mối quan t
Để xem toàn bộ bề mặt tùy chỉnh và ví dụ thực tế: Để xem toàn bộ bề mặt tùy chỉnh và ví dụ thực tế:
- [Cách tùy chỉnh BMad](../how-to/customize-bmad.md): tài liệu tham chiếu cho những gì có thể tùy chỉnh và merge diễn ra thế nào - [Cách tùy chỉnh BMad](../how-to/customize-bmad.md): tài liệu tham chiếu cho những gì có thể tùy chỉnh và merge diễn ra thế nào
- [Cách mở rộng BMad cho tổ chức của bạn](../how-to/expand-bmad-for-your-org.md): năm recipe hoàn chỉnh trải từ quy tắc ở cấp agent, convention workflow, publish ra hệ thống ngoài, thay template đầu ra đến tùy chỉnh roster agent - [Cách mở rộng BMad cho tổ chức của bạn](../how-to/expand-bmad-for-your-org.md): sáu recipe hoàn chỉnh trải từ quy tắc ở cấp agent, convention workflow, publish ra hệ thống ngoài, thay template đầu ra, tùy chỉnh roster agent đến các mẫu tích hợp nâng cao
- Skill `bmad-customize`: trợ lý soạn cấu hình (authoring helper) có hướng dẫn để biến ý định thành một file override đúng chỗ và đã được kiểm chứng - Skill `bmad-customize`: trợ lý soạn cấu hình (authoring helper) có hướng dẫn để biến ý định thành một file override đúng chỗ và đã được kiểm chứng
## Ý tưởng lớn hơn phía sau ## Ý tưởng lớn hơn phía sau

2
docs/vi-vn/how-to/customize-bmad.md
View File

@ -370,7 +370,7 @@ Trong cùng một dự án, bạn hoàn toàn có thể dùng đồng thời c
## Ví dụ thực chiến ## Ví dụ thực chiến
Để xem các recipe thiên về doanh nghiệp như định hình một agent trên mọi workflow mà nó dispatch, ép workflow tuân thủ convention nội bộ, publish output lên Confluence và Jira, tùy chỉnh agent roster, hoặc thay template đầu ra bằng template riêng của tổ chức, hãy xem [Cách mở rộng BMad cho tổ chức của bạn](./expand-bmad-for-your-org.md). Để xem các recipe thiên về doanh nghiệp như định hình một agent trên mọi workflow mà nó dispatch, ép workflow tuân thủ convention nội bộ, publish output lên Confluence và Jira, tùy chỉnh agent roster, thay template đầu ra bằng template riêng của tổ chức, hoặc cấu hình các mẫu tích hợp nâng cao, hãy xem [Cách mở rộng BMad cho tổ chức của bạn](./expand-bmad-for-your-org.md).
## Khắc phục sự cố ## Khắc phục sự cố

76
docs/vi-vn/how-to/expand-bmad-for-your-org.md
View File

@ -1,11 +1,11 @@
--- ---
title: 'Cách mở rộng BMad cho tổ chức của bạn' title: 'Cách mở rộng BMad cho tổ chức của bạn'
description: Năm mẫu tùy chỉnh giúp thay đổi BMad mà không cần fork, gồm quy tắc ở cấp agent, quy ước workflow, xuất bản ra hệ thống ngoài, thay template và điều chỉnh danh sách agent description: Sáu mẫu tùy chỉnh giúp thay đổi BMad mà không cần fork, gồm quy tắc ở cấp agent, quy ước workflow, xuất bản ra hệ thống ngoài, thay template, điều chỉnh danh sách agent và các mẫu tích hợp nâng cao
sidebar: sidebar:
order: 9 order: 9
--- ---
Bề mặt tùy chỉnh của BMad cho phép một tổ chức định hình lại hành vi mà không phải sửa file đã cài hay fork skill. Hướng dẫn này trình bày năm công thức mẫu (recipe) bao phủ phần lớn nhu cầu ở môi trường doanh nghiệp. Bề mặt tùy chỉnh của BMad cho phép một tổ chức định hình lại hành vi mà không phải sửa file đã cài hay fork skill. Hướng dẫn này trình bày sáu công thức mẫu (recipe) bao phủ phần lớn nhu cầu ở môi trường doanh nghiệp.
:::note[Điều kiện tiên quyết] :::note[Điều kiện tiên quyết]
@ -235,9 +235,79 @@ Chỉ một câu, nhưng được nạp ở mọi phiên. Nó kết hợp với
Hãy giữ file hướng dẫn của IDE **ngắn gọn**. Một tá dòng được chọn kỹ sẽ hiệu quả hơn một danh sách dài lê thê. Model phải đọc file đó ở mọi lượt, và càng nhiều nhiễu thì càng ít tín hiệu. Hãy giữ file hướng dẫn của IDE **ngắn gọn**. Một tá dòng được chọn kỹ sẽ hiệu quả hơn một danh sách dài lê thê. Model phải đọc file đó ở mọi lượt, và càng nhiều nhiễu thì càng ít tín hiệu.
## Recipe 6: mẫu tích hợp nâng cao
Một số workflow BMad mở ra bề mặt cấu hình phong phú hơn các phần cơ bản trong Recipe 1-5. Những mẫu này, gồm nguồn tri thức theo nhu cầu, tự động publish output, chuẩn tài liệu lúc finalize và template có thể thay thế, xuất hiện trong nhiều workflow. Hãy kiểm tra `customize.toml` của workflow để biết nó expose những field nào; các ví dụ dưới đây dùng `bmad-prd` vì workflow này expose đủ các field, nhưng cùng pattern áp dụng ở mọi nơi có field tương ứng.
### Nguồn tri thức theo nhu cầu (`external_sources`)
Kết nối workflow với knowledge base nội bộ, cơ sở dữ liệu cạnh tranh hoặc tài liệu compliance. Agent chỉ tham khảo các nguồn này khi cuộc trò chuyện chạm tới nhu cầu phù hợp, không gọi trước một cách vô điều kiện.
```toml
# _bmad/custom/bmad-prd.toml (cùng pattern áp dụng cho mọi workflow expose external_sources)
[workflow]
external_sources = [
"Khi người dùng nhắc tới đối thủ hoặc phân khúc thị trường, hãy query corp:competitive_db (category={project_name}) trước khi viết phần differentiation.",
"Với domain có yếu tố pháp lý như healthcare, fintech, education, hãy tham khảo corp:compliance_reference trước khi viết các phần domain-specific.",
]
```
Mỗi entry là một chỉ dẫn ngôn ngữ tự nhiên nêu tên MCP tool, điều kiện kích hoạt và các field tool cần. Nếu tool không có sẵn lúc chạy, workflow fallback về hành vi chuẩn và ghi nhận khoảng trống đó.
### Tự động publish output (`external_handoffs`)
Đưa artifact đã hoàn tất sang các hệ thống nguồn sự thật bên ngoài sau khi workflow finalize. Khác với `on_complete` ở Recipe 3, `external_handoffs` là một mảng append chuyên dụng: entry của team được chồng thêm, và từng handoff chạy độc lập với graceful degradation nếu tool không có sẵn.
```toml
# _bmad/custom/bmad-prd.toml (cùng pattern áp dụng cho mọi workflow expose external_handoffs)
[workflow]
external_handoffs = [
"Sau khi finalize, upload prd.md và addendum.md lên Confluence qua corp:confluence_upload (space_key='PROD', parent_page='PRDs', label='prd', author={user_name}). Lưu và hiển thị URL trang được trả về.",
"Mirror sang Notion qua notion:create_page (database_id='abc123', title='PRD: ' + {project_name}).",
]
```
Nếu một tool được nêu tên không có sẵn, handoff đó bị bỏ qua và được đánh dấu; các file local vẫn luôn tồn tại.
### Chuẩn tài liệu lúc finalize (`doc_standards`)
Áp dụng chuẩn viết của tổ chức cho tài liệu dành cho con người ở thời điểm finalize, sau khi nội dung đã hoàn tất nhưng trước khi người dùng nhìn thấy output. Mỗi entry là một chỉ dẫn `skill:`, `file:` hoặc plain-text; các lượt kiểm tra chạy bằng subagent song song.
```toml
# _bmad/custom/bmad-prd.toml (cùng pattern áp dụng cho mọi workflow expose doc_standards)
[workflow]
doc_standards = [
"file:{project-root}/docs/enterprise/voice-and-tone.md",
"Mọi ngày tháng phải dùng định dạng ISO 8601 (YYYY-MM-DD).",
"Thay mọi lần dùng 'leverage' bằng 'use'.",
]
```
`doc_standards` là mảng append; entry của team chồng lên mọi mặc định mà workflow đi kèm. Các lượt kiểm tra cấu trúc rộng nên chạy trước các lượt chỉnh văn phong hẹp.
### Template và checklist có thể thay thế
Các workflow tạo tài liệu có cấu trúc thường expose đường dẫn template và checklist dưới dạng scalar có thể override. Trỏ chúng tới file do tổ chức sở hữu dưới `{project-root}` để ép cấu trúc khác mà không phải sửa source.
```toml
# _bmad/custom/bmad-prd.toml
[workflow]
# Cấu trúc PRD cho ngành chịu quản lý
prd_template = "{project-root}/docs/enterprise/prd-template-hipaa.md"
# Tiêu chí validation riêng của tổ chức
validation_checklist = "{project-root}/docs/enterprise/prd-checklist-regulated.md"
```
Agent thích ứng với bất kỳ cấu trúc nào template định nghĩa. Hãy giữ template trong `{project-root}/docs/` hoặc `{project-root}/_bmad/custom/templates/` để chúng được version cùng file override. Với repo đa tổ chức, dùng `.user.toml` để từng team có thể trỏ tới template riêng mà không đụng vào file dùng chung.
## Kết hợp các recipe ## Kết hợp các recipe
Cả năm recipe này có thể kết hợp song song. Một cấu hình doanh nghiệp thực tế cho `bmad-product-brief` hoàn toàn có thể đặt `persistent_facts` theo Recipe 2, `on_complete` theo Recipe 3 và `brief_template` theo Recipe 4 trong cùng một file. Quy tắc ở cấp agent theo Recipe 1 sẽ nằm trong file của agent tương ứng, còn cấu hình trung tâm theo Recipe 5 thì ghim roster và thiết lập chung. Tất cả cùng hoạt động đồng thời. Cả sáu recipe này có thể kết hợp song song. Một cấu hình doanh nghiệp thực tế cho `bmad-product-brief` hoàn toàn có thể đặt `persistent_facts` theo Recipe 2, `on_complete` theo Recipe 3 và `brief_template` theo Recipe 4 trong cùng một file. Quy tắc ở cấp agent theo Recipe 1 sẽ nằm trong file của agent tương ứng, cấu hình trung tâm theo Recipe 5 thì ghim roster và thiết lập chung, còn các mẫu tích hợp nâng cao theo Recipe 6 cấu hình external sources và handoff. Tất cả cùng hoạt động đồng thời.
```toml ```toml
# _bmad/custom/bmad-product-brief.toml (cấp workflow) # _bmad/custom/bmad-product-brief.toml (cấp workflow)

312
docs/vi-vn/how-to/install-bmad.md
View File

@ -1,116 +1,266 @@
--- ---
title: "Cách cài đặt BMad" title: 'Cách cài đặt BMad'
description: Hướng dẫn từng bước để cài đặt BMad vào dự án của bạn description: Cài đặt, cập nhật và ghim phiên bản BMad cho phát triển local, team và CI
sidebar: sidebar:
order: 1 order: 1
--- ---
Sử dụng lệnh `npx bmad-method install` để thiết lập BMad trong dự án của bạn với các module và công cụ AI theo lựa chọn. Dùng `npx bmad-method install` để thiết lập BMad trong dự án của bạn. Một lệnh xử lý cả cài đặt lần đầu, nâng cấp, đổi channel và chạy bằng script cho CI. Trang này bao quát toàn bộ các trường hợp đó.
Nếu bạn muốn dùng trình cài đặt không tương tác và cung cấp toàn bộ tùy chọn ngay trên dòng lệnh, xem [hướng dẫn này](./non-interactive-installation.md).
## Khi nào nên dùng ## Khi nào nên dùng
- Bắt đầu một dự án mới với BMad - Bắt đầu một dự án mới với BMad
- Thêm BMad vào một codebase hiện có - Thêm hoặc gỡ module trên một bản cài hiện có
- Cập nhật bản cài đặt BMad hiện tại - Chuyển một module sang main-HEAD hoặc ghim vào một bản phát hành cụ thể
- Script hóa cài đặt cho pipeline CI, Dockerfile hoặc triển khai doanh nghiệp
:::note[Điều kiện tiên quyết] :::note[Điều kiện tiên quyết]
- **Node.js** 20.12+ (bắt buộc cho trình cài đặt)
- **Git** (khuyến nghị) - **Node.js** 20.12+ (trình cài đặt yêu cầu phiên bản này)
- **Công cụ AI** (Claude Code, Cursor, hoặc tương tự) - **Git** (để clone các module bên ngoài)
- **Một công cụ AI** như Claude Code hoặc Cursor (chạy `npx bmad-method install --list-tools` để xem mọi công cụ được hỗ trợ)
::: :::
## Các bước thực hiện ## Cài lần đầu (đường nhanh)
### 1. Chạy trình cài đặt
```bash ```bash
npx bmad-method install npx bmad-method install
``` ```
:::tip[Muốn dùng bản prerelease mới nhất?] Luồng tương tác sẽ hỏi bạn năm thứ:
Sử dụng dist-tag `next`:
1. Thư mục cài đặt (mặc định là thư mục làm việc hiện tại)
2. Module cần cài (checkbox cho core, bmm, bmb, automator, cis, gds, wds, tea)
3. **"Ready to install (all stable)?"** — chọn Yes để nhận tag phát hành mới nhất cho mọi module bên ngoài
4. Công cụ AI/IDE cần tích hợp (claude-code, cursor và các công cụ khác)
5. Cấu hình theo từng module (tên, ngôn ngữ, thư mục output)
Chấp nhận mặc định là bạn sẽ có bản stable mới nhất của mọi module, đã cấu hình cho công cụ bạn chọn.
:::tip[Chỉ muốn bản prerelease mới nhất?]
```bash ```bash
npx bmad-method@next install npx bmad-method@next install
``` ```
Cách này giúp bạn nhận các thay đổi mới sớm hơn, đổi lại khả năng biến động cao hơn bản cài đặt mặc định. Lệnh này chạy trình cài prerelease, đi kèm snapshot mới hơn của core và bmm. Đổi lại là biến động nhiều hơn, nhưng ít độ trễ hơn giữa phát triển và phát hành.
::: :::
:::tip[Bản rất mới] ## Chọn một phiên bản cụ thể
Để cài đặt trực tiếp từ nhánh `main` mới nhất (có thể không ổn định):
Có hai trục độc lập quyết định thứ gì được ghi xuống đĩa.
### Trục 1: channel của module bên ngoài
Mọi module bên ngoài như bmb, automator, cis, gds, wds, tea và các module cộng đồng đều được cài trên một trong ba channel:
| Channel | Nội dung được cài | Ai nên chọn |
| ------------------ | ---------------------------------------------------------------------------- | --------------------------------------- |
| `stable` (mặc định) | Tag semver đã phát hành cao nhất. Các prerelease như `v2.0.0-alpha.1` bị loại trừ. | Phần lớn người dùng |
| `next` | HEAD của nhánh main tại thời điểm cài | Contributor, người dùng sớm |
| `pinned` | Một tag cụ thể do bạn chỉ định | Cài đặt doanh nghiệp, CI cần tái lập |
Channel được chọn theo từng module. Bạn có thể để bmb chạy `next` trong khi cis vẫn ở `stable`; các cờ bên dưới cho phép trộn tự do.
### Trục 2: phiên bản binary của trình cài đặt
Gói npm `bmad-method` có hai dist-tag:
| Lệnh | Bạn nhận được gì |
| ------------------------------------- | ----------------------------------------------------------------- |
| `npx bmad-method install` (`@latest`) | Bản stable mới nhất của trình cài |
| `npx bmad-method@next install` | Bản prerelease mới nhất của trình cài, tự động publish ở mỗi lần push lên main |
**Binary của trình cài quyết định phiên bản core và bmm.** Hai module này được đóng gói sẵn bên trong package trình cài thay vì clone từ repo riêng.
### Vì sao core và bmm chưa có channel riêng
Chúng gắn liền với binary trình cài bạn chạy:
- `npx bmad-method install` → core và bmm stable mới nhất
- `npx bmad-method@next install` → core và bmm prerelease
- `node /path/to/local-checkout/tools/installer/bmad-cli.js install` → đúng nội dung trong checkout local của bạn
`--pin bmm=v6.3.0` và `--next=bmm` không có hiệu lực với module bundled, và trình cài sẽ cảnh báo khi bạn thử. Một bản phát hành trong tương lai sẽ tách bmm khỏi package trình cài; khi đó bmm sẽ có bộ chọn channel đúng nghĩa giống bmb hiện nay.
## Cập nhật bản cài hiện có
Chạy `npx bmad-method install` trong thư mục đã có `_bmad/` sẽ hiển thị một menu:
| Lựa chọn | Tác dụng |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Quick Update** | Chạy lại cài đặt với cấu hình hiện có. Làm mới file, áp dụng patch và nâng cấp minor stable, từ chối nâng cấp major. Nhanh và không tương tác. |
| **Modify Install** | Luồng tương tác đầy đủ. Thêm hoặc gỡ module, cấu hình lại thiết lập, tùy chọn xem và đổi channel cho module hiện có. |
### Prompt nâng cấp
Khi Modify phát hiện tag stable mới hơn cho một module đang ở `stable`, nó phân loại diff và hỏi theo bảng sau:
| Kiểu nâng cấp | Ví dụ | Mặc định |
| ------------ | --------------- | ------- |
| Patch | v1.7.0 → v1.7.1 | Y |
| Minor | v1.7.0 → v1.8.0 | Y |
| Major | v1.7.0 → v2.0.0 | **N** |
Major mặc định là N vì breaking change thường bị cảm nhận như "bất ổn" khi người dùng không chờ đợi nó. Prompt có kèm URL release notes trên GitHub để bạn đọc trước khi chấp nhận.
Khi dùng `--yes`, nâng cấp patch và minor được áp dụng tự động. Major vẫn bị giữ nguyên; truyền `--pin <code>=<new-tag>` để chấp nhận không tương tác.
### Đổi channel của một module
**Tương tác:** chọn Modify → trả lời **Yes** cho "Review channel assignments?" → mỗi module bên ngoài sẽ có lựa chọn Keep, Switch to stable, Switch to next hoặc Pin to a tag.
**Qua cờ:** các recipe ở phần tiếp theo bao phủ những trường hợp thường gặp.
## Headless CI installs
### Bảng cờ
| Cờ | Mục đích |
| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `--yes`, `-y` | Bỏ qua mọi prompt; nhận giá trị từ cờ và mặc định |
| `--directory <path>` | Cài vào thư mục này (mặc định là thư mục làm việc hiện tại) |
| `--modules <a,b,c>` | Tập module chính xác. Core được tự thêm. Đây không phải delta; hãy liệt kê mọi module bạn muốn giữ. |
| `--tools <a,b>` | Chọn IDE/công cụ. Bắt buộc với bản cài mới dùng `--yes`. Chạy `--list-tools` để xem ID hợp lệ. |
| `--list-tools` | In mọi ID công cụ/IDE được hỗ trợ (kèm thư mục đích) rồi thoát. |
| `--action <type>` | `install`, `update` hoặc `quick-update`. Mặc định dựa trên trạng thái cài đặt hiện có. |
| `--custom-source <urls>` | Cài module tùy chỉnh từ Git URL hoặc đường dẫn local |
| `--channel <stable\|next>` | Áp dụng cho mọi module bên ngoài (alias là `--all-stable` / `--all-next`) |
| `--all-stable` | Alias cho `--channel=stable` |
| `--all-next` | Alias cho `--channel=next` |
| `--next=<code>` | Đặt một module lên next. Có thể lặp lại. |
| `--pin <code>=<tag>` | Ghim một module vào tag cụ thể. Có thể lặp lại. |
| `--set <module>.<key>=<value>` | Đặt bất kỳ tùy chọn cấu hình module nào không tương tác (khuyến nghị; xem [Ghi đè cấu hình module](#ghi-đè-cấu-hình-module)). Có thể lặp lại. |
| `--list-options [module]` | In mọi key `--set` cho module tích hợp và module chính thức đã cache local, rồi thoát. Truyền mã module để chỉ xem module đó. |
| `--user-name`, `--communication-language`, `--document-output-language`, `--output-folder` | Shortcut cũ tương đương `--set core.<key>=<value>` (vẫn được hỗ trợ) |
Độ ưu tiên khi các cờ chồng nhau: `--pin` thắng `--next=`, thắng `--channel` / `--all-*`, thắng mặc định registry (`stable`).
:::note[Ví dụ resolve]
`--all-next --pin cis=v0.2.0` đặt bmb, automator, gds, wds và tea lên next, đồng thời ghim cis vào v0.2.0.
:::
### Recipe
**Cài mặc định — stable mới nhất cho mọi thứ:**
```bash ```bash
npx github:bmad-code-org/BMAD-METHOD install npx bmad-method install --yes --modules bmm,bmb,cis --tools claude-code
```
:::
### 2. Chọn vị trí cài đặt
Trình cài đặt sẽ hỏi bạn muốn đặt các tệp BMad ở đâu:
- Thư mục hiện tại (khuyến nghị cho dự án mới nếu bạn tự tạo thư mục và chạy lệnh từ bên trong nó)
- Đường dẫn tùy chọn
### 3. Chọn công cụ AI
Chọn các công cụ AI bạn đang dùng:
- Claude Code
- Cursor
- Các công cụ khác
Mỗi công cụ có cách tích hợp skill riêng. Trình cài đặt sẽ tạo các tệp prompt nhỏ để kích hoạt workflow và agent, và đặt chúng vào đúng vị trí mà công cụ của bạn mong đợi.
:::note[Kích hoạt skill]
Một số nền tảng yêu cầu bật skill trong cài đặt trước khi chúng xuất hiện. Nếu bạn đã cài BMad mà chưa thấy skill, hãy kiểm tra cài đặt của nền tảng hoặc hỏi trợ lý AI cách bật skill.
:::
### 4. Chọn module
Trình cài đặt sẽ hiện các module có sẵn. Chọn những module bạn cần - phần lớn người dùng chỉ cần **BMad Method** (module phát triển phần mềm).
### 5. Làm theo các prompt
Trình cài đặt sẽ hướng dẫn các bước còn lại - cài đặt, tích hợp công cụ, và các tùy chọn khác.
## Bạn nhận được gì
```text
du-an-cua-ban/
├── _bmad/
│ ├── bmm/ # Các module bạn đã chọn
│ │ └── config.yaml # Cài đặt module (nếu bạn cần thay đổi sau này)
│ ├── core/ # Module core bắt buộc
│ └── ...
├── _bmad-output/ # Các artifact được tạo ra
├── .claude/ # Claude Code skills (nếu dùng Claude Code)
│ └── skills/
│ ├── bmad-help/
│ ├── bmad-persona/
│ └── ...
└── .cursor/ # Cursor skills (nếu dùng Cursor)
└── skills/
└── ...
``` ```
## Xác minh cài đặt **Ghim cho doanh nghiệp — tái lập từng byte:**
Chạy `bmad-help` để xác minh mọi thứ hoạt động và xem bạn nên làm gì tiếp theo. ```bash
npx bmad-method install --yes \
--modules bmm,bmb,cis \
--pin bmb=v1.7.0 --pin cis=v0.2.0 \
--tools claude-code
```
**BMad-Help là công cụ hướng dẫn thông minh** sẽ: **Bleeding edge — module bên ngoài ở main HEAD:**
- Xác nhận bản cài đặt hoạt động đúng
- Hiển thị những gì có sẵn dựa trên module đã cài
- Đề xuất bước đầu tiên của bạn
Bạn cũng có thể hỏi nó: ```bash
```text npx bmad-method install --yes --modules bmm,bmb --all-next --tools claude-code
bmad-help Tôi vừa cài xong, giờ nên làm gì đầu tiên? ```
bmad-help Tôi có những lựa chọn nào cho một dự án SaaS?
**Thêm module vào bản cài hiện có** (giữ mọi thứ khác):
```bash
npx bmad-method install --yes --action update \
--modules bmm,bmb,gds
```
`--tools` được bỏ có chủ ý vì `--action update` dùng lại các công cụ đã cấu hình ở lần cài đầu.
**Trộn channel — bmb ở next, gds ở stable:**
```bash
npx bmad-method install --yes --action update \
--modules bmm,bmb,cis,gds \
--next=bmb
```
### Ghi đè cấu hình module
`--set <module>.<key>=<value>` cho phép đặt bất kỳ tùy chọn cấu hình module nào không tương tác. Cờ này có thể lặp lại và mở rộng được cho mọi module hiện tại lẫn tương lai. Nó được áp dụng như một patch sau cài đặt: trình cài chạy luồng bình thường trước, sau đó `--set` upsert từng giá trị vào `_bmad/config.toml` (scope team) hoặc `_bmad/config.user.toml` (scope user), và vào `_bmad/<module>/config.yaml` để các giá trị đã khai báo được giữ cho lần cài sau.
**Ví dụ — cài bmm với project knowledge và skill level rõ ràng:**
```bash
npx bmad-method install --yes \
--modules bmm \
--tools claude-code \
--set bmm.project_knowledge=research \
--set bmm.user_skill_level=expert
```
**Khám phá các key có sẵn cho một module:**
```bash
npx bmad-method install --list-options bmm
```
`--list-options` không có tham số sẽ liệt kê mọi key mà trình cài tìm thấy local: module tích hợp (`core`, `bmm`) cộng với các module chính thức đang được cache. Cache là theo từng máy và có thể bị xóa, nên các module chính thức từng cài sẽ không xuất hiện trên checkout mới hoặc CI worker tạm thời cho đến khi chúng được cài lại. Module cộng đồng và tùy chỉnh không được liệt kê ở đây; hãy đọc trực tiếp `module.yaml` của module để xem các key nó khai báo.
**Cách hoạt động:**
- **Routing.** Bước patch tìm `[modules.<module>] <key>` (hoặc `[core] <key>`) trong `config.user.toml` trước; nếu đã có ở đó, nó cập nhật file đó. Nếu không, nó ghi vào `config.toml` scope team. Vì vậy các key scope user như `core.user_name`, `bmm.user_skill_level` đi vào `config.user.toml`, còn key scope team đi vào `config.toml`, khớp với cách trình cài phân vùng cấu hình.
- **Giá trị nguyên văn.** Giá trị được ghi đúng như bạn truyền vào, không render template `result:`. Nếu muốn dạng đã render như `{project-root}/research`, hãy truyền chính xác giá trị đó: `--set bmm.project_knowledge='{project-root}/research'`.
- **Giữ lại, key đã khai báo.** Giá trị cho key được khai báo trong `module.yaml` sống sót qua các lần cài sau vì cũng được ghi vào `_bmad/<module>/config.yaml`, nơi trình cài đọc làm mặc định cho prompt tiếp theo.
- **Giữ lại, key chưa khai báo.** Giá trị cho key mà schema module không khai báo sẽ nằm trong `config.toml` cho lần cài hiện tại nhưng không được phát lại ở lần cài sau (manifest writer phân vùng nghiêm theo schema và bỏ key lạ). Hãy truyền lại `--set` nếu bạn cần nó bền, hoặc sửa trực tiếp `_bmad/config.toml`.
- **Không validate.** Giá trị `single-select` không được kiểm tra với danh sách cho phép, và key lạ không bị từ chối; bạn khẳng định gì thì giá trị đó được ghi.
- **Module không nằm trong `--modules`.** Đặt giá trị cho module bạn không cài sẽ in cảnh báo và bỏ giá trị đó, không tạo file cho module chưa cài.
Các shortcut core cũ như `--user-name`, `--output-folder` vẫn hoạt động và vẫn được ghi lại để tương thích ngược, nhưng `--set core.user_name=...` là tương đương.
:::note[Hoạt động với quick-update]
`--set` là patch sau cài đặt, nên nó áp dụng giống nhau bất kể action type. Khi chạy `bmad install --action quick-update` (hoặc `--yes` trên bản cài hiện có, nơi quick-update là mặc định), `--set` patch các file cấu hình trung tâm ở cuối giống một lần cài thường.
:::
:::caution[Rate limit trên IP dùng chung]
Các API call GitHub ẩn danh bị giới hạn 60/giờ cho mỗi IP. Một lần cài gọi API một lần cho mỗi module bên ngoài để resolve tag stable. Văn phòng sau NAT, pool CI runner và VPN có thể cùng nhau dùng hết hạn mức này.
Đặt `GITHUB_TOKEN=<personal access token>` trong môi trường để nâng hạn mức lên 5000/giờ cho mỗi tài khoản. PAT đọc public repo là đủ, không cần scope.
:::
## Những gì đã được cài
Sau mọi lần cài, `_bmad/_config/manifest.yaml` ghi lại chính xác nội dung trên đĩa:
```yaml
modules:
- name: bmb
version: v1.7.0 # tag, hoặc "main" nếu là next
channel: stable # stable | next | pinned
sha: 86033fc9aeae2ca6d52c7cdb675c1f4bf17fc1c1
source: external
repoUrl: https://github.com/bmad-code-org/bmad-builder
```
Trường `sha` được ghi cho các module dựa trên git (external, community và custom bằng URL). Module bundled (core, bmm) và module custom từ đường dẫn local không có trường này; code của chúng đi cùng binary trình cài hoặc filesystem của bạn, không phải một ref có thể clone.
Để tái lập giữa nhiều máy, đừng dựa vào việc chạy lại cùng lệnh `--modules`. Cài trên stable channel resolve sang tag đã phát hành cao nhất **tại thời điểm cài**, nên lần chạy sau có thể nhận bản mới hơn. Hãy chuyển các tag đã ghi trong `manifest.yaml` thành cờ `--pin` rõ ràng trên máy đích, ví dụ:
```bash
npx bmad-method install --yes --modules bmb,cis \
--pin bmb=v1.7.0 --pin cis=v0.4.2 --tools claude-code
``` ```
## Khắc phục sự cố ## Khắc phục sự cố
**Trình cài đặt báo lỗi** - Sao chép toàn bộ output vào trợ lý AI của bạn và để nó phân tích. ### "Could not resolve stable tag" hoặc "API rate limit exceeded"
**Cài đặt xong nhưng sau đó có thứ không hoạt động** - AI của bạn cần bối cảnh BMad để hỗ trợ. Xem [Cách tìm câu trả lời về BMad](./get-answers-about-bmad.md) để biết cách cho AI truy cập đúng nguồn thông tin. Bạn đã chạm giới hạn 60/giờ của GitHub khi gọi ẩn danh. Đặt `GITHUB_TOKEN` rồi thử lại. Nếu đã có token, token đó có thể đã hết hạn hoặc hết budget rate limit; hãy thử token khác hoặc chờ reset theo giờ.
### "Tag 'vX.Y.Z' not found"
Tag bạn truyền cho `--pin` không tồn tại trong repo module. Kiểm tra trang releases của repo trên GitHub để xem tag hợp lệ.
### Bản cài đã ghim vẫn cứ nâng cấp
Bản cài pinned không nâng cấp. Quick-update chỉ áp dụng patch và minor trên stable channel; nó không đụng tới `pinned` hoặc `next`. Nếu bản cài pinned thay đổi, mở `_bmad/_config/manifest.yaml`: `channel: pinned` cùng `version` và `sha` cố định phải giữ nguyên qua các lần chạy, trừ khi bạn override rõ bằng cờ.
### `--pin bmm=X` không làm gì
bmm là module bundled, nên `--pin` và `--next=` không áp dụng. Dùng `npx bmad-method@next install` để lấy prerelease core/bmm, hoặc checkout repo bmad-bmm và chạy trình cài local để lấy thay đổi chưa phát hành.

190
docs/vi-vn/how-to/non-interactive-installation.md
View File

@ -1,194 +1,10 @@
--- ---
title: Cài đặt không tương tác title: Cài đặt không tương tác
description: Cài đặt BMad bằng các cờ dòng lệnh cho pipeline CI/CD và triển khai tự động description: Tài liệu cài đặt headless / CI đã được chuyển sang trang mới
sidebar: sidebar:
order: 2 order: 2
--- ---
Sử dụng các cờ dòng lệnh để cài đặt BMad mà không cần tương tác. Cách này hữu ích cho: :::note[Trang này đã được chuyển]
Các cờ cài đặt headless và CI, cách chọn channel, và pin phiên bản hiện nằm trong hướng dẫn hợp nhất [Cách cài đặt BMad](./install-bmad.md). Hãy chuyển tới mục [Cài đặt headless / CI](./install-bmad.md#headless-ci-installs) để xem bảng cờ và các recipe có thể sao chép dùng ngay.
## Khi nào nên dùng
- Triển khai tự động và pipeline CI/CD
- Cài đặt bằng script
- Cài đặt hàng loạt trên nhiều dự án
- Cài đặt nhanh với cấu hình đã biết trước
:::note[Điều kiện tiên quyết]
Yêu cầu [Node.js](https://nodejs.org) v20.12+ và `npx` (đi kèm với npm).
:::
## Các cờ khả dụng
### Tùy chọn cài đặt
| Cờ | Mô tả | Ví dụ |
|------|-------------|---------|
| `--directory <path>` | Thư mục cài đặt | `--directory ~/projects/myapp` |
| `--modules <modules>` | Danh sách ID module, cách nhau bởi dấu phẩy | `--modules bmm,bmb` |
| `--tools <tools>` | Danh sách ID công cụ/IDE, cách nhau bởi dấu phẩy (dùng `none` để bỏ qua) | `--tools claude-code,cursor` hoặc `--tools none` |
| `--action <type>` | Hành động cho bản cài đặt hiện có: `install` (mặc định), `update`, hoặc `quick-update` | `--action quick-update` |
| `--custom-source <sources>` | Danh sách Git URL hoặc đường dẫn cục bộ cho module tùy chỉnh, cách nhau bởi dấu phẩy | `--custom-source /path/to/module` |
### Cấu hình cốt lõi
| Cờ | Mô tả | Mặc định |
|------|-------------|---------|
| `--user-name <name>` | Tên để agent sử dụng | Tên người dùng hệ thống |
| `--communication-language <lang>` | Ngôn ngữ giao tiếp của agent | Tiếng Anh |
| `--document-output-language <lang>` | Ngôn ngữ đầu ra tài liệu | Tiếng Anh |
| `--output-folder <path>` | Đường dẫn thư mục output (xem quy tắc resolve bên dưới) | `_bmad-output` |
#### Quy tắc resolve đường dẫn output folder
Giá trị truyền vào `--output-folder` (hoặc nhập ở chế độ tương tác) sẽ được resolve theo các quy tắc sau:
| Loại đầu vào | Ví dụ | Được resolve thành |
|------|-------------|---------|
| Đường dẫn tương đối (mặc định) | `_bmad-output` | `<project-root>/_bmad-output` |
| Đường dẫn tương đối có traversal | `../../shared-outputs` | Đường dẫn tuyệt đối đã được chuẩn hóa, ví dụ `/Users/me/shared-outputs` |
| Đường dẫn tuyệt đối | `/Users/me/shared-outputs` | Giữ nguyên như đã nhập, **không** thêm project root vào trước |
Đường dẫn sau khi resolve là đường dẫn mà agent và workflow sẽ dùng lúc runtime để ghi file đầu ra. Việc dùng đường dẫn tuyệt đối hoặc đường dẫn tương đối có traversal cho phép bạn chuyển toàn bộ artifact sinh ra sang một thư mục nằm ngoài cây dự án, hữu ích với thư mục dùng chung hoặc cấu trúc monorepo.
### Tùy chọn khác
| Cờ | Mô tả |
|------|-------------|
| `-y, --yes` | Chấp nhận toàn bộ mặc định và bỏ qua prompt |
| `-d, --debug` | Bật output debug cho quá trình tạo manifest |
## ID module
Những ID module có thể dùng với cờ `--modules`:
- `bmm` - BMad Method Master
- `bmb` - BMad Builder
Kiểm tra [BMad registry](https://github.com/bmad-code-org) để xem các module ngoài được hỗ trợ.
## ID công cụ/IDE
Những ID công cụ có thể dùng với cờ `--tools`:
**Khuyến dùng:** `claude-code`, `cursor`
Chạy `npx bmad-method install` một lần ở chế độ tương tác để xem danh sách đầy đủ hiện tại của các công cụ được hỗ trợ, hoặc xem [cấu hình platform codes](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/tools/installer/ide/platform-codes.yaml).
## Các chế độ cài đặt
| Chế độ | Mô tả | Ví dụ |
|------|-------------|---------|
| Hoàn toàn không tương tác | Cung cấp đầy đủ cờ để bỏ qua tất cả prompt | `npx bmad-method install --directory . --modules bmm --tools claude-code --yes` |
| Bán tương tác | Cung cấp một số cờ, BMad hỏi thêm phần còn lại | `npx bmad-method install --directory . --modules bmm` |
| Chỉ dùng mặc định | Chấp nhận tất cả giá trị mặc định với `-y` | `npx bmad-method install --yes` |
| Chỉ dùng custom source | Chỉ cài core và module tùy chỉnh | `npx bmad-method install --directory . --custom-source /path/to/module --tools claude-code --yes` |
| Không cấu hình công cụ | Bỏ qua cấu hình công cụ/IDE | `npx bmad-method install --modules bmm --tools none` |
## Ví dụ
### Cài đặt cho pipeline CI/CD
```bash
#!/bin/bash
# install-bmad.sh
npx bmad-method install \
--directory "${GITHUB_WORKSPACE}" \
--modules bmm \
--tools claude-code \
--user-name "CI Bot" \
--communication-language English \
--document-output-language English \
--output-folder _bmad-output \
--yes
```
### Cập nhật bản cài đặt hiện có
```bash
npx bmad-method install \
--directory ~/projects/myapp \
--action update \
--modules bmm,bmb,custom-module
```
### Quick Update (giữ nguyên cài đặt)
```bash
npx bmad-method install \
--directory ~/projects/myapp \
--action quick-update
```
### Cài từ custom source
Cài một module từ đường dẫn cục bộ hoặc từ bất kỳ Git host nào:
```bash
npx bmad-method install \
--directory . \
--custom-source /path/to/my-module \
--tools claude-code \
--yes
```
Kết hợp cùng module chính thức:
```bash
npx bmad-method install \
--directory . \
--modules bmm \
--custom-source https://gitlab.com/myorg/my-module \
--tools claude-code \
--yes
```
:::note[Hành vi của `custom-source`]
Khi dùng `--custom-source` mà không kèm `--modules`, hệ thống chỉ cài core và các module tùy chỉnh. Nếu muốn cài cả module chính thức, hãy thêm `--modules`. Xem thêm [Cài đặt module tùy chỉnh và module cộng đồng](./install-custom-modules.md) để biết chi tiết.
:::
## Bạn nhận được gì
- Thư mục `_bmad/` đã được cấu hình đầy đủ trong dự án của bạn
- Agent và workflow đã được cấu hình theo module và công cụ bạn chọn
- Thư mục `_bmad-output/` để lưu các artifact được tạo
## Kiểm tra và xử lý lỗi
BMad sẽ kiểm tra tất cả các cờ được cung cấp:
- **Directory** - Phải là đường dẫn hợp lệ và có quyền ghi
- **Modules** - Cảnh báo nếu ID module không hợp lệ (nhưng không thất bại)
- **Tools** - Cảnh báo nếu ID công cụ không hợp lệ (nhưng không thất bại)
- **Action** - Phải là một trong: `install`, `update`, `quick-update`
Giá trị không hợp lệ sẽ dẫn đến một trong các trường hợp sau:
1. Hiện lỗi và thoát (với các tùy chọn quan trọng như directory)
2. Hiện cảnh báo và bỏ qua (với mục tùy chọn)
3. Quay lại hỏi interactive (với giá trị bắt buộc bị thiếu)
:::tip[Thực hành tốt]
- Dùng đường dẫn tuyệt đối cho `--directory` để tránh nhầm lẫn
- Dùng đường dẫn tuyệt đối cho `--output-folder` khi bạn muốn ghi artifact ra ngoài cây dự án, ví dụ vào một thư mục output dùng chung trong monorepo
- Thử nghiệm cờ ở máy local trước khi đưa vào pipeline CI/CD
- Kết hợp với `-y` nếu bạn muốn cài đặt hoàn toàn không cần can thiệp
- Dùng `--debug` nếu gặp vấn đề trong quá trình cài đặt
:::
## Khắc phục sự cố
### Cài đặt thất bại với lỗi "Invalid directory"
- Thư mục đích phải tồn tại (hoặc thư mục cha của nó phải tồn tại)
- Bạn cần quyền ghi
- Đường dẫn phải là tuyệt đối, hoặc tương đối đúng với thư mục hiện tại
### Không tìm thấy module
- Xác minh ID module có đúng không
- Module bên ngoài phải có sẵn trong registry
:::note[Vẫn bị mắc?]
Chạy với `--debug` để xem output chi tiết, thử chế độ interactive để cô lập vấn đề, hoặc báo cáo tại <https://github.com/bmad-code-org/BMAD-METHOD/issues>.
::: :::

6
docs/vi-vn/how-to/upgrade-to-v6.md
View File

@ -84,9 +84,9 @@ du-an-cua-ban/
| Module v4 | Trạng thái trong v6 | | Module v4 | Trạng thái trong v6 |
| --- | --- | | --- | --- |
| `.bmad-2d-phaser-game-dev` | Đã được tích hợp vào module BMGD | | `.bmad-2d-phaser-game-dev` | Đã được tích hợp vào module GDS |
| `.bmad-2d-unity-game-dev` | Đã được tích hợp vào module BMGD | | `.bmad-2d-unity-game-dev` | Đã được tích hợp vào module GDS |
| `.bmad-godot-game-dev` | Đã được tích hợp vào module BMGD | | `.bmad-godot-game-dev` | Đã được tích hợp vào module GDS |
| `.bmad-infrastructure-devops` | Đã bị ngừng hỗ trợ - agent DevOps mới sắp ra mắt | | `.bmad-infrastructure-devops` | Đã bị ngừng hỗ trợ - agent DevOps mới sắp ra mắt |
| `.bmad-creative-writing` | Chưa được điều chỉnh - module v6 mới sắp ra mắt | | `.bmad-creative-writing` | Chưa được điều chỉnh - module v6 mới sắp ra mắt |

12
docs/vi-vn/reference/agents.md
View File

@ -11,18 +11,18 @@ Trang này liệt kê các agent mặc định của BMM (bộ Agile suite) đư
## Ghi Chú ## Ghi Chú
- Mỗi agent đều có sẵn dưới dạng một skill do trình cài đặt tạo ra. Skill ID, ví dụ `bmad-dev`, được dùng để gọi agent. - Mỗi agent đều có sẵn dưới dạng một skill do trình cài đặt tạo ra. Skill ID, ví dụ `bmad-agent-dev`, được dùng để gọi agent.
- Trigger là các mã menu ngắn, ví dụ `CP`, cùng với các fuzzy match hiển thị trong menu của từng agent. - Trigger là các mã menu ngắn, ví dụ `CP`, cùng với các fuzzy match hiển thị trong menu của từng agent.
- Việc tạo test QA do workflow skill `bmad-qa-generate-e2e-tests` đảm nhận, khả dụng thông qua Developer agent. Module Test Architect (TEA) đầy đủ nằm trong một module riêng. - Việc tạo test QA do workflow skill `bmad-qa-generate-e2e-tests` đảm nhận, khả dụng thông qua Developer agent. Module Test Architect (TEA) đầy đủ nằm trong một module riêng.
| Agent | Skill ID | Trigger | Workflow chính | | Agent | Skill ID | Trigger | Workflow chính |
| --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- | | --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| Analyst (Mary) | `bmad-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, Market Research, Domain Research, Technical Research, Create Brief, PRFAQ Challenge, Document Project | | Analyst (Mary) | `bmad-agent-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | Brainstorm, Market Research, Domain Research, Technical Research, Create Brief, PRFAQ Challenge, 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 | | Product Manager (John) | `bmad-agent-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 | | Architect (Winston) | `bmad-agent-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness |
| Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev Story, Quick Dev, QA Test Generation, Code Review, Sprint Planning, Create Story, Epic Retrospective | | Developer (Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | Dev Story, Quick Dev, QA Test Generation, Code Review, Sprint Planning, Create Story, Epic Retrospective |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design | | UX Designer (Sally) | `bmad-agent-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 | | Technical Writer (Paige) | `bmad-agent-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept |
## Các Loại Trigger ## Các Loại Trigger

4
docs/vi-vn/reference/commands.md
View File

@ -80,8 +80,8 @@ Agent skills nạp một persona AI chuyên biệt với vai trò, phong cách g
| Ví dụ skill | Agent | Vai trò | | Ví dụ skill | Agent | Vai trò |
| --- | --- | --- | | --- | --- | --- |
| `bmad-agent-dev` | Amelia (Developer) | Triển khai story với mức tuân thủ đặc tả nghiêm ngặt | | `bmad-agent-dev` | Amelia (Developer) | Triển khai story với mức tuân thủ đặc tả nghiêm ngặt |
| `bmad-pm` | John (Product Manager) | Tạo và kiểm tra PRD | | `bmad-agent-pm` | John (Product Manager) | Tạo và kiểm tra PRD |
| `bmad-architect` | Winston (Architect) | Thiết kế kiến trúc hệ thống | | `bmad-agent-architect` | Winston (Architect) | Thiết kế kiến trúc hệ thống |
Xem [Agents](./agents.md) để biết danh sách đầy đủ các agent mặc định và trigger của chúng. Xem [Agents](./agents.md) để biết danh sách đầy đủ các agent mặc định và trigger của chúng.

35
docs/vi-vn/reference/modules.md
View File

@ -41,6 +41,22 @@ Bộ công cụ vận hành bởi AI dành cho sáng tạo có cấu trúc, phá
- Storyteller và Presentation Master cho kể chuyện và pitching - Storyteller và Presentation Master cho kể chuyện và pitching
- Các framework phát ý tưởng như SCAMPER, Reverse Brainstorming và problem reframing - Các framework phát ý tưởng như SCAMPER, Reverse Brainstorming và problem reframing
## BMad Automator
Module tự động hóa thử nghiệm để tạo epic/story sẵn sàng cho triển khai và chạy các workflow BMAD được hỗ trợ với ít thao tác thủ công hơn. Hiện module này tập trung vào Claude và Codex.
- **Mã:** `automator`
- **npm:** [`bmad-story-automator`](https://www.npmjs.com/package/bmad-story-automator)
- **GitHub:** [bmad-code-org/bmad-automator](https://github.com/bmad-code-org/bmad-automator)
- **Kênh mặc định:** `next`
**Cung cấp:**
- Tự động hóa xây epic cho quy trình giao hàng theo story
- Hỗ trợ workflow thử nghiệm cho người dùng Claude và Codex
- Đường tắt từ artifact kế hoạch sang công việc triển khai cụ thể
- Tính năng early-access có thể thay đổi nhanh hơn các module stable
## Game Dev Studio ## Game Dev Studio
Các workflow phát triển game có cấu trúc, được điều chỉnh cho Unity, Unreal, Godot và các engine tùy chỉnh. Hỗ trợ làm prototype nhanh qua Quick Flow và sản xuất toàn diện bằng sprint theo epic. Các workflow phát triển game có cấu trúc, được điều chỉnh cho Unity, Unreal, Godot và các engine tùy chỉnh. Hỗ trợ làm prototype nhanh qua Quick Flow và sản xuất toàn diện bằng sprint theo epic.
@ -56,6 +72,21 @@ Các workflow phát triển game có cấu trúc, được điều chỉnh cho U
- Hỗ trợ thiết kế narrative cho nhân vật, hội thoại và world-building - Hỗ trợ thiết kế narrative cho nhân vật, hội thoại và world-building
- Bao phủ hơn 21 thể loại game cùng hướng dẫn kiến trúc theo engine - Bao phủ hơn 21 thể loại game cùng hướng dẫn kiến trúc theo engine
## Whiteport Design Studio
Module UX chiến lược và design-first planning cho các nhóm cần định hình trải nghiệm sản phẩm chắc hơn trước khi triển khai. WDS mở rộng BMAD bằng discovery UX và workflow lập kế hoạch thiết kế có cấu trúc.
- **Mã:** `wds`
- **npm:** [`bmad-wds`](https://www.npmjs.com/package/bmad-wds)
- **GitHub:** [bmad-code-org/bmad-method-wds-expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion)
**Cung cấp:**
- Phương pháp design-first planning cho sản phẩm và UX
- Discovery UX có cấu trúc trước solutioning và implementation
- Workflow thiết kế chiến lược bổ trợ luồng product planning của BMAD
- Các skill Whiteport Design Studio được hiển thị qua module picker của installer
## Test Architect (TEA) ## Test Architect (TEA)
Chiến lược kiểm thử cấp doanh nghiệp, hướng dẫn tự động hóa và quyết định release gate thông qua một agent chuyên gia cùng chín workflow có cấu trúc. TEA vượt xa QA agent tích hợp sẵn nhờ ưu tiên theo rủi ro và truy vết yêu cầu. Chiến lược kiểm thử cấp doanh nghiệp, hướng dẫn tự động hóa và quyết định release gate thông qua một agent chuyên gia cùng chín workflow có cấu trúc. TEA vượt xa QA agent tích hợp sẵn nhờ ưu tiên theo rủi ro và truy vết yêu cầu.
@ -71,6 +102,6 @@ Chiến lược kiểm thử cấp doanh nghiệp, hướng dẫn tự động h
- Đánh giá NFR, thiết lập CI và dựng sườn framework kiểm thử - Đánh giá NFR, thiết lập CI và dựng sườn framework kiểm thử
- Ưu tiên P0-P3 cùng tích hợp tùy chọn với Playwright Utils và MCP - Ưu tiên P0-P3 cùng tích hợp tùy chọn với Playwright Utils và MCP
## Community Modules ## Module cộng đồng và tùy chỉnh
Các module cộng đồng và một chợ module đang được chuẩn bị. Hãy theo dõi [tổ chức BMad trên GitHub](https://github.com/bmad-code-org) để cập nhật. Module picker cho community module trong luồng tương tác đã được gỡ. Hãy cài module cộng đồng hoặc bên thứ ba bằng `--custom-source <git-url-or-path>` từ Git repository hoặc đường dẫn cục bộ. Xem [Cài đặt module tùy chỉnh và module cộng đồng](../how-to/install-custom-modules.md).

10
docs/zh-cn/reference/agents.md
View File

@ -11,12 +11,12 @@ sidebar:
| 智能体 | Skill ID | 触发器 | 主要 workflow | | 智能体 | Skill ID | 触发器 | 主要 workflow |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| Analyst (Mary) | `bmad-analyst` | `BP`、`MR`、`DR`、`TR`、`CB`、`WB`、`DP` | Brainstorm、Market Research、Domain Research、Technical Research、Create Brief、PRFAQ Challenge、Document Project | | Analyst (Mary) | `bmad-agent-analyst` | `BP`、`MR`、`DR`、`TR`、`CB`、`WB`、`DP` | Brainstorm、Market Research、Domain Research、Technical Research、Create Brief、PRFAQ Challenge、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 | | Product Manager (John) | `bmad-agent-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 | | Architect (Winston) | `bmad-agent-architect` | `CA`、`IR` | Create Architecture、Implementation Readiness |
| Developer (Amelia) | `bmad-agent-dev` | `DS`、`QD`、`QA`、`CR`、`SP`、`CS`、`ER` | Dev Story、Quick Dev、QA Test Generation、Code Review、Sprint Planning、Create Story、Epic Retrospective | | Developer (Amelia) | `bmad-agent-dev` | `DS`、`QD`、`QA`、`CR`、`SP`、`CS`、`ER` | Dev Story、Quick Dev、QA Test Generation、Code Review、Sprint Planning、Create Story、Epic Retrospective |
| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design | | UX Designer (Sally) | `bmad-agent-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 | | Technical Writer (Paige) | `bmad-agent-tech-writer` | `DP`、`WD`、`US`、`MG`、`VD`、`EC` | Document Project、Write Document、Update Standards、Mermaid Generate、Validate Doc、Explain Concept |
## 使用说明 ## 使用说明

4
docs/zh-cn/reference/commands.md
View File

@ -74,8 +74,8 @@ skill 目录名就是调用名，例如 `bmad-agent-dev/` 对应 skill `bmad-age
| 示例 skill | 角色 | 用途 | | 示例 skill | 角色 | 用途 |
| --- | --- | --- | | --- | --- | --- |
| `bmad-agent-dev` | Developer（Amelia） | 按规范实现 story | | `bmad-agent-dev` | Developer（Amelia） | 按规范实现 story |
| `bmad-pm` | Product Manager（John） | 创建与校验 PRD | | `bmad-agent-pm` | Product Manager（John） | 创建与校验 PRD |
| `bmad-architect` | Architect（Winston） | 架构设计与约束定义 | | `bmad-agent-architect` | Architect（Winston） | 架构设计与约束定义 |
完整列表见 [智能体参考](./agents.md)。 完整列表见 [智能体参考](./agents.md)。

2
website/public/workflow-map-diagram-fr.html
View File

@ -203,7 +203,7 @@
</div> </div>
<div class="workflow-meta"> <div class="workflow-meta">
<div class="agent"><div class="agent-icon sally">S</div><span class="agent-name">Sally</span></div> <div class="agent"><div class="agent-icon sally">S</div><span class="agent-name">Sally</span></div>
<span class="output">ux-spec.md →</span> <span class="output">ux-design-specification.md →</span>
</div> </div>
</div> </div>
</div> </div>

2
website/public/workflow-map-diagram.html
View File

@ -214,7 +214,7 @@
</div> </div>
<div class="workflow-meta"> <div class="workflow-meta">
<div class="agent"><div class="agent-icon sally">S</div><span class="agent-name">Sally</span></div> <div class="agent"><div class="agent-icon sally">S</div><span class="agent-name">Sally</span></div>
<span class="output">ux-spec.md →</span> <span class="output">ux-design-specification.md →</span>
</div> </div>
</div> </div>
</div> </div>