docs/vi-vn/tutorials/getting-started.md
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.
:::note[Điều kiện tiên quyết]
:::tip[Cách Dễ Nhất]
Cài đặt → npx bmad-method install
Hỏi → bmad-help what should I do first?
Xây dựng → Để BMad-Help dẫn bạn qua từng workflow
:::
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ẽ:
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:
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.
:::tip[Bắt Đầu Từ Đây]
Sau khi cài BMad, hãy gọi skill bmad-help ngay. Nó sẽ nhận biết các module bạn đã cài và hướng bạn đến điểm bắt đầu phù hợp cho dự án.
:::
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 |
:::note
Đây không phải các nhánh triển khai riêng. Mọi đầu vào đều hội tụ vào bmad-build; lập kế hoạch chỉ thay đổi lượng ngữ cảnh sẵn có.
:::
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:::tip[Bước Tiếp Theo Của Bạn] 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?” :::
:::note[Cách Nạp Agent Và Chạy Workflow]
Mỗi workflow có một skill được gọi bằng tên trong IDE của bạn, ví dụ bmad-prd. Công cụ AI sẽ nhận diện tên bmad-* và chạy nó, bạn không cần nạp agent riêng. Bạn cũng có thể gọi trực tiếp skill của agent để trò chuyện tổng quát, ví dụ bmad-agent-pm cho PM agent.
:::
:::caution[Chat Mới] Luôn bắt đầu một chat mới cho mỗi workflow. Điều này tránh các vấn đề do giới hạn context gây ra. :::
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.
:::tip[Project Context (Tùy chọn)]
Trước khi bắt đầu, hãy cân nhắc tạo project-context.md để ghi lại các ưu tiên kỹ thuật và quy tắc triển khai. Nhờ vậy mọi AI agent sẽ tuân theo cùng một quy ước trong suốt dự án.
Bạn có thể tạo thủ công tại _bmad-output/project-context.md hoặc sinh ra sau phần kiến trúc bằng bmad-generate-project-context. Xem thêm.
:::
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?
bmad-brainstorming) — Gợi ý ý tưởng có hướng dẫnbmad-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ớibmad-product-brief) — Tài liệu nền tảng được khuyến nghị khi concept của bạn đã rõbmad-prfaq) — Bài kiểm tra Working Backwards để stress-test và rèn sắc concept sản phẩm của bạnVới công việc cần lập kế hoạch sản phẩm:
bmad-agent-pm) trong một chat mớibmad-prd (bmad-prd)PRD.md:::note[Thiết kế UX (Tùy chọn)]
Nếu dự án của bạn có giao diện người dùng, hãy gọi UX-Designer agent (bmad-agent-ux-designer) và chạy workflow thiết kế UX (bmad-ux) sau khi tạo PRD.
:::
Tạo Architecture
bmad-agent-architect) trong một chat mớibmad-architecture (bmad-architecture)Tạo Epics và Stories
:::tip[Cải tiến trong V6] Epics và stories giờ được tạo sau kiến trúc. Điều này giúp story có chất lượng tốt hơn vì các quyết định kiến trúc như database, API pattern và tech stack ảnh hưởng trực tiếp đến cách chia nhỏ công việc. :::
bmad-agent-pm) trong một chat mớibmad-create-epics-and-stories (bmad-create-epics-and-stories)Kiểm tra mức sẵn sàng để triển khai (Rất nên dùng)
bmad-agent-architect) trong một chat mớibmad-sprint-planning (bmad-sprint-planning) — mở đầu bằng cổng kiểm tra mức sẵn sàngChuyể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.
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.
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 đã nắm được nền tảng để xây dựng với BMad:
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)
└── ...
| 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 |
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.
:::tip[Điểm Dừng Đầu Tiên: BMad-Help]
Hãy gọi bmad-help bất cứ lúc nào — đây là cách nhanh nhất để gỡ vướng. Bạn có thể hỏi:
BMad-Help sẽ kiểm tra dự án, phát hiện những gì bạn đã hoàn thành và chỉ cho bạn chính xác bước cần làm tiếp theo. :::
:::tip[Hãy Nhớ Các Điểm Này]
bmad-help — Trợ lý thông minh hiểu dự án và các lựa chọn của bạnbmad-buildSẵ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.