Hướng Dẫn Phong Cách Tài Liệu

:::tip[Tiêu đề]
Lối tắt, best practice
:::

:::note[Tiêu đề]
Ngữ cảnh, định nghĩa, ví dụ, điều kiện tiên quyết
:::

:::caution[Tiêu đề]
Lưu ý, vấn đề có thể xảy ra
:::

:::danger[Tiêu đề]
Chỉ dùng cho cảnh báo nghiêm trọng — mất dữ liệu, vấn đề bảo mật
:::

| Phase | Tên | Điều xảy ra |
| ----- | --- | ------------ |
| 1     | Analysis | Brainstorm, nghiên cứu *(tùy chọn)* |
| 2     | Planning | Yêu cầu — PRD hoặc spec *(bắt buộc)* |

| Skill | Agent | Mục đích |
| ----- | ----- | -------- |
| `bmad-brainstorming` | Analyst | Brainstorm cho dự án mới |
| `bmad-create-prd` | PM | Tạo tài liệu yêu cầu sản phẩm |

```
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
│   ├── implementation-artifacts/
│   └── project-context.md                   # Quy tắc triển khai (tùy chọn)
└── ...
```

1. Tiêu đề + Hook (1-2 câu mô tả kết quả)
2. Thông báo phiên bản/module (admonition info hoặc warning) (tùy chọn)
3. Bạn sẽ học được gì (danh sách kết quả)
4. Điều kiện tiên quyết (admonition info)
5. Lối đi nhanh (admonition tip - tóm tắt TL;DR)
6. Hiểu về [Chủ đề] (ngữ cảnh trước các bước - bảng cho phase/agent)
7. Cài đặt (tùy chọn)
8. Bước 1: [Nhiệm vụ lớn đầu tiên]
9. Bước 2: [Nhiệm vụ lớn thứ hai]
10. Bước 3: [Nhiệm vụ lớn thứ ba]
11. Bạn đã hoàn thành những gì (tóm tắt + cấu trúc thư mục)
12. Tra cứu nhanh (bảng skill)
13. Câu hỏi thường gặp (định dạng FAQ)
14. Nhận hỗ trợ (liên kết cộng đồng)
15. Điểm chính cần nhớ (admonition tip)

1. Tiêu đề + Hook (một câu: "Sử dụng workflow `X` để...")
2. Khi nào nên dùng (danh sách kịch bản)
3. Khi nào nên bỏ qua (tùy chọn)
4. Điều kiện tiên quyết (admonition note)
5. Các bước (mục con `###` có đánh số)
6. Bạn sẽ nhận được gì (output / artifact)
7. Ví dụ (tùy chọn)
8. Mẹo (tùy chọn)
9. Bước tiếp theo (tùy chọn)

1. Tiêu đề + Hook (1-2 câu)
2. Tổng quan / định nghĩa (nó là gì, vì sao quan trọng)
3. Khái niệm chính (các mục `###`)
4. Bảng so sánh (tùy chọn)
5. Khi nào nên dùng / không nên dùng (tùy chọn)
6. Sơ đồ (tùy chọn - mermaid, tối đa 1 sơ đồ mỗi tài liệu)
7. Bước tiếp theo (tùy chọn)

1. Tiêu đề + Hook (một câu)
2. Bảng nội dung (liên kết kèm mô tả)
3. Bắt đầu từ đâu (danh sách có đánh số)
4. Chọn hướng đi của bạn (tùy chọn - cây quyết định)

1. Tiêu đề + Hook (nó là gì)
2. Loại / nhóm (các mục `###`) (tùy chọn)
3. Bảng khác biệt chính
4. Thành phần / bộ phận
5. Nên chọn cái nào?
6. Cách tạo / tùy chỉnh (trỏ sang how-to)

1. Tiêu đề + Hook (nó làm gì)
2. Thông tin nhanh (tùy chọn - "Phù hợp với:", "Mất bao lâu:")
3. Khi nào nên dùng / không nên dùng
4. Cách nó hoạt động (mermaid tùy chọn)
5. Lợi ích chính
6. Bảng so sánh (tùy chọn)
7. Khi nào nên nâng cấp / chuyển hướng (tùy chọn)

1. Tiêu đề + Hook (nguyên tắc)
2. Vấn đề
3. Giải pháp
4. Nguyên tắc chính (các mục `###`)
5. Lợi ích
6. Khi nào áp dụng

1. Tiêu đề + Hook (một câu)
2. Các phần nội dung (`##` cho từng nhóm)
   - Danh sách gạch đầu dòng với liên kết và mô tả

1. Tiêu đề + Hook
2. Các mục (`##` cho từng mục)
   - Mô tả ngắn (một câu)
   - **Skills:** hoặc **Thông tin chính:** ở dạng danh sách phẳng
3. Phần dùng chung / toàn cục (`##`) (tùy chọn)

1. Tiêu đề + Hook (một câu nêu mục đích)
2. Thông tin nhanh (admonition note, tùy chọn)
   - Module, Skill, Input, Output dưới dạng danh sách
3. Mục đích / tổng quan (`##`)
4. Cách gọi (code block)
5. Các phần chính (`##` cho từng khía cạnh)
   - Dùng `###` cho các tùy chọn con
6. Ghi chú / lưu ý (admonition tip hoặc caution)

1. Tiêu đề + Hook
2. Mục lục (jump link nếu có từ 4 mục trở lên)
3. Các mục (`##` cho từng config / task)
   - **Tóm tắt in đậm** — một câu
   - **Dùng khi:** danh sách gạch đầu dòng
   - **Cách hoạt động:** các bước đánh số (tối đa 3-5 bước)
   - **Output:** kết quả mong đợi (tùy chọn)

1. Tiêu đề + Hook
2. Tổng quan (`##`)
   - Sơ đồ hoặc bảng mô tả cách tổ chức
3. Các phần lớn (`##` cho từng phase / nhóm)
   - Các mục (`###` cho từng mục)
   - Các trường chuẩn hóa: Skill, Agent, Input, Output, Description
4. Bước tiếp theo (tùy chọn)

## Tên nhóm

| Thuật ngữ | Định nghĩa |
| --------- | ---------- |
| **Agent** | AI persona chuyên biệt với chuyên môn cụ thể để dẫn dắt người dùng qua workflow. |
| **Workflow** | Quy trình nhiều bước có hướng dẫn, điều phối hoạt động của agent AI để tạo deliverable. |

## Các câu hỏi

- [Lúc nào cũng cần kiến trúc à?](#luc-nao-cung-can-kien-truc-a)
- [Tôi có thể đổi kế hoạch về sau không?](#toi-co-the-doi-ke-hoach-ve-sau-khong)

### Lúc nào cũng cần kiến trúc à?

Chỉ với nhánh BMad Method và Enterprise. Quick Flow bỏ qua để đi thẳng vào triển khai.

### Tôi có thể đổi kế hoạch về sau không?

Có. Workflow `bmad-correct-course` xử lý thay đổi phạm vi giữa chừng.

**Có câu hỏi chưa được trả lời ở đây?** [Mở issue](...) hoặc hỏi trên [Discord](...).

npm run docs:fix-links            # Xem trước các sửa định dạng link
npm run docs:fix-links -- --write # Áp dụng các sửa
npm run docs:validate-links       # Kiểm tra link tồn tại
npm run docs:build                # Xác minh không có lỗi build