Bắt đầu

Xây dựng phần mềm nhanh hơn bằng các workflow vận hành bởi AI, với những agent chuyên biệt hướng dẫn bạn qua các bước lập kế hoạch, kiến trúc và triển khai.

Bạn Sẽ Học Được Gì

Cài đặt và khởi tạo BMad Method cho một dự án mới
Dùng BMad-Help — trợ lý thông minh biết bước tiếp theo bạn nên làm gì
Chọn độ sâu lập kế hoạch phù hợp với công việc
Đi qua các phase từ yêu cầu đến code chạy được
Sử dụng agent và workflow hiệu quả

Làm Quen Với BMad-Help: Người Dẫn Đường Thông Minh Của Bạn

BMad-Help là cách nhanh nhất để bắt đầu với BMad. Bạn không cần phải nhớ workflow hay phase nào cả, chỉ cần hỏi, và BMad-Help sẽ:

Kiểm tra dự án của bạn để xem những gì đã hoàn thành
Hiển thị các lựa chọn dựa trên những module bạn đã cài
Đề xuất bước tiếp theo — bao gồm cả tác vụ bắt buộc đầu tiên
Trả lời câu hỏi như “Tôi có ý tưởng cho một sản phẩm SaaS, tôi nên bắt đầu từ đâu?”

Cách Dùng BMad-Help

Chạy trong AI IDE của bạn bằng cách gọi skill:

bmad-help

Hoặc ghép cùng câu hỏi để nhận hướng dẫn có ngữ cảnh:

bmad-help I have an idea for a SaaS product, I already know all the features I want. where do I get started?

BMad-Help sẽ trả lời:

Điều gì được khuyến nghị trong tình huống của bạn
Tác vụ bắt buộc đầu tiên là gì
Phần còn lại của quy trình sẽ trông như thế nào

Nó Cũng Điều Khiển Workflow

BMad-Help không chỉ trả lời câu hỏi — nó còn tự động chạy ở cuối mỗi workflow để cho bạn biết chính xác bước tiếp theo cần làm là gì. Không phải đoán, không phải lục tài liệu, chỉ có chỉ dẫn rõ ràng về workflow bắt buộc tiếp theo.

Hiểu Về BMad

BMad giúp bạn xây dựng phần mềm thông qua các workflow có hướng dẫn với những AI agent chuyên biệt. Quy trình gồm bốn phase:

Phase	Tên	Điều xảy ra
1	Analysis	Brainstorming, nghiên cứu, product brief hoặc PRFAQ (tùy chọn)
2	Planning	Tạo tài liệu yêu cầu (PRD hoặc spec)
3	Solutioning	Thiết kế kiến trúc khi cần
4	Implementation	Triển khai mọi thay đổi hoặc story đã lập kế hoạch, có thể thông qua điều phối tự động

Mở Workflow Map để khám phá các phase, workflow và cách quản lý context.

Độ sâu lập kế hoạch có thể thay đổi:

Độ sâu	Phù hợp nhất với	Ngữ cảnh trước triển khai
Trực tiếp	Bản sửa, tính năng, issue hoặc spec đã rõ	Ý định, issue hoặc spec
Lập kế hoạch sản phẩm	Sản phẩm, nền tảng và tính năng phức tạp	PRD và UX tùy chọn
Định hình giải pháp đầy đủ	Sáng kiến phối hợp, rủi ro cao hoặc liên hệ thống	PRD, UX, kiến trúc, epic, story và kế hoạch sprint

Cài Đặt

Mở terminal trong thư mục dự án và chạy:

npx bmad-method install

Nếu bạn muốn dùng bản prerelease mới nhất thay vì kênh release mặc định, hãy dùng npx bmad-method@next install.

Khi được hỏi chọn module, hãy chọn BMad Method.

Trình cài đặt sẽ tạo hai thư mục:

_bmad/ — agents, workflows, tasks và cấu hình
_bmad-output/ — hiện tại để trống, nhưng đây là nơi các artifact của bạn sẽ được lưu

Mở AI IDE trong thư mục dự án rồi chạy:

bmad-help

BMad-Help sẽ nhận biết bạn đã làm đến đâu và đề xuất chính xác bước tiếp theo. Bạn cũng có thể hỏi những câu như “Tôi có những lựa chọn nào?” hoặc “Tôi có ý tưởng SaaS, nên bắt đầu từ đâu?”

Bước 1: Chọn Độ Sâu Lập Kế Hoạch

Chỉ dùng những phần cần thiết trong phase 1-3. Với công việc rõ ràng, có phạm vi hữu hạn, bạn có thể đi thẳng đến Bước 2. Dùng chat mới cho từng workflow.

Phase 1: Analysis (Tùy chọn)

Tất cả workflow trong phase này đều là tùy chọn. Chưa chắc nên dùng cái nào?

brainstorming (bmad-brainstorming) — Gợi ý ý tưởng có hướng dẫn
research (bmad-deep-recon) — Soạn prompt nghiên cứu chuyên sâu cho công cụ AI của riêng bạn, xử lý báo cáo hoàn chỉnh thành bản tóm tắt sẵn sàng cho các bước sau, hoặc thực hiện nghiên cứu ngay tại đây — thị trường, miền nghiệp vụ, kỹ thuật, cạnh tranh, tiếng nói người dùng và học thuật — kèm kiểm chứng luận điểm và vòng đời làm mới
product-brief (bmad-product-brief) — Tài liệu nền tảng được khuyến nghị khi concept của bạn đã rõ
prfaq (bmad-prfaq) — Bài kiểm tra Working Backwards để stress-test và rèn sắc concept sản phẩm của bạn

Phase 2: Planning (Khi cần)

Với công việc cần lập kế hoạch sản phẩm:

Gọi PM agent (bmad-agent-pm) trong một chat mới
Chạy workflow bmad-prd (bmad-prd)
Kết quả: PRD.md

Phase 3: Solutioning (Khi cần)

Tạo Architecture

Gọi Architect agent (bmad-agent-architect) trong một chat mới
Chạy bmad-architecture (bmad-architecture)
Kết quả: tài liệu kiến trúc chứa các quyết định kỹ thuật

Tạo Epics và Stories

Gọi PM agent (bmad-agent-pm) trong một chat mới
Chạy bmad-create-epics-and-stories (bmad-create-epics-and-stories)
Workflow sẽ dùng cả PRD lẫn Architecture để tạo story có đủ ngữ cảnh kỹ thuật

Kiểm tra mức sẵn sàng để triển khai (Rất nên dùng)

Gọi Architect agent (bmad-agent-architect) trong một chat mới
Chạy bmad-sprint-planning (bmad-sprint-planning) — mở đầu bằng cổng kiểm tra mức sẵn sàng
Xác nhận tính nhất quán giữa toàn bộ tài liệu lập kế hoạch

Bước 2: Xây Dựng Dự Án

Chuyển sang implementation với ngữ cảnh đang có: yêu cầu trực tiếp, issue, spec hoặc story đã được lập kế hoạch đầy đủ. Mỗi workflow nên chạy trong một chat mới.

Với công việc đã lập kế hoạch, chạy bmad-build và nêu rõ story hoặc hạng mục sprint đã chọn, ví dụ: Triển khai story 2.3 từ _bmad-output/planning-artifacts/epics.md.

Khởi Tạo Sprint Planning (Cho công việc đã lập kế hoạch)

Gọi Developer agent (bmad-agent-dev) và chạy bmad-sprint-planning (bmad-sprint-planning). Workflow này sẽ tạo sprint-status.yaml để theo dõi toàn bộ epic và story.

Khi Build nhận diện được story đã chọn trong file này, workflow chuyển story sang in-progress trong lúc triển khai và sang review khi triển khai hoàn tất.

Chu Trình Xây Dựng

Với mỗi thay đổi trực tiếp hoặc story đã lập kế hoạch, lặp lại chu trình này trong chat mới:

Bước	Agent	Workflow	Lệnh	Mục đích
1	DEV	`bmad-build`	`bmad-build`	Làm rõ, lập kế hoạch, triển khai, review và trình bày
2	DEV	`bmad-code-review`	`bmad-code-review`	Kiểm tra chất lượng bổ sung (khuyến nghị)

Review của Build là một phần của mọi lần chạy. bmad-code-review là lớp xác thực độc lập, tùy chọn trong một ngữ cảnh mới.

Sau khi hoàn tất tất cả story trong một epic, hãy gọi Developer agent (bmad-agent-dev) và chạy bmad-retrospective (bmad-retrospective).

Bạn Đã Hoàn Thành Những Gì

Bạn đã nắm được nền tảng để xây dựng với BMad:

Đã cài BMad và cấu hình cho IDE của bạn
Đã chọn độ sâu lập kế hoạch phù hợp với công việc
Đã tạo các tài liệu lập kế hoạch (PRD, Architecture, Epics và Stories)
Đã hiểu chu trình triển khai trong implementation

Dự án của bạn bây giờ sẽ có dạng:

your-project/
├── _bmad/                                   # Cấu hình BMad
├── _bmad-output/
│   ├── planning-artifacts/
│   │   ├── PRD.md                           # Tài liệu yêu cầu của bạn
│   │   ├── architecture.md                  # Các quyết định kỹ thuật
│   │   └── epics/                           # Các file epic và story
│   ├── implementation-artifacts/
│   │   └── sprint-status.yaml               # Theo dõi sprint
│   └── project-context.md                   # Quy tắc triển khai (tùy chọn)
└── ...

Tra Cứu Nhanh

Workflow	Lệnh	Agent	Mục đích
`bmad-help` ⭐	`bmad-help`	Bất kỳ	Người dẫn đường thông minh của bạn — hỏi gì cũng được!
`bmad-prd`	`bmad-prd`	PM	Tạo tài liệu yêu cầu sản phẩm
`bmad-architecture`	`bmad-architecture`	Architect	Tạo tài liệu kiến trúc
`bmad-generate-project-context`	`bmad-generate-project-context`	Analyst	Tạo file project context
`bmad-create-epics-and-stories`	`bmad-create-epics-and-stories`	PM	Phân rã PRD thành epics
`bmad-sprint-planning`	`bmad-sprint-planning`	DEV	Cổng sẵn sàng + khởi tạo theo dõi sprint + xem trạng thái
`bmad-build`	`bmad-build`	DEV	Triển khai ý định, issue, tính năng, bản sửa hoặc story
`bmad-code-review`	`bmad-code-review`	DEV	Review phần code đã triển khai

Câu Hỏi Thường Gặp

Lúc nào cũng cần kiến trúc à? Không. Dùng kiến trúc khi cần làm rõ quyết định kỹ thuật hoặc ràng buộc liên hệ thống. Công việc rõ ràng có thể đi thẳng vào bmad-build; sáng kiến lớn đưa các artifact lập kế hoạch vào cùng workflow đó.

Tôi có thể đổi kế hoạch về sau không? Có. Workflow bmad-correct-course (bmad-correct-course) xử lý thay đổi phạm vi giữa chừng.

Nếu tôi muốn brainstorming trước thì sao? Gọi Analyst agent (bmad-agent-analyst) và chạy bmad-brainstorming (bmad-brainstorming) trước khi bắt đầu PRD.

Tôi có cần tuân theo đúng thứ tự tuyệt đối không? Không hẳn. Khi đã quen flow, bạn có thể chạy workflow trực tiếp bằng bảng Tra Cứu Nhanh ở trên.

Nhận Hỗ Trợ

Trong workflow — Các agent sẽ hướng dẫn bạn bằng câu hỏi và giải thích
Cộng đồng — Discord (#bmad-method-help, #report-bugs-and-issues)

Những Điểm Cần Ghi Nhớ

Sẵn sàng bắt đầu chưa? Hãy cài BMad, gọi bmad-help, và để người dẫn đường thông minh của bạn đưa bạn đi tiếp.