Cách nâng cấp lên v6

Sử dụng trình cài đặt BMad để nâng cấp từ v4 lên v6, bao gồm khả năng tự động phát hiện bản cài đặt cũ và hỗ trợ di chuyển.

Khi nào nên dùng

• Bạn đang dùng BMad v4 (thư mục .bmad-method)
• Bạn muốn chuyển sang kiến trúc v6 mới
• Bạn có các planning artifact hiện có cần giữ lại

:::note[Điều kiện tiên quyết]

• Node.js 20+
• Bản cài đặt BMad v4 hiện có :::

Các bước thực hiện

1. Chạy trình cài đặt

Làm theo Hướng dẫn cài đặt.

2. Xử lý bản cài đặt cũ

Khi v4 được phát hiện, bạn có thể:

• Cho phép trình cài đặt sao lưu và xóa .bmad-method
• Thoát và tự xử lý dọn dẹp thủ công

Nếu trước đây bạn đặt tên thư mục BMad khác - bạn sẽ phải tự xóa thư mục đó.

3. Dọn dẹp skill IDE cũ

Tự xóa các command/skill IDE cũ của v4 - ví dụ nếu bạn dùng Claude Code, hãy tìm các thư mục lồng nhau bắt đầu bằng bmad và xóa chúng:

• .claude/commands/

Các skill v6 mới sẽ được cài tại:

• .claude/skills/

4. Di chuyển planning artifacts

Nếu bạn có tài liệu lập kế hoạch (Brief/PRD/UX/Architecture):

Di chuyển chúng vào _bmad-output/planning-artifacts/ với tên mô tả rõ ràng:

• Tên tệp PRD nên chứa PRD
• Tên tệp tương ứng nên chứa brief, architecture, hoặc ux-design
• Tài liệu đã chia nhỏ có thể đặt trong các thư mục con đặt tên phù hợp

Nếu bạn đang lập kế hoạch dở dang: Hãy cân nhắc bắt đầu lại với workflow v6. Bạn vẫn có thể dùng các tài liệu hiện có làm input - các workflow discovery tiên tiến trong v6, kết hợp web search và chế độ plan trong IDE, cho kết quả tốt hơn.

5. Di chuyển công việc phát triển đang dở dang

Nếu bạn đã có các story được tạo hoặc đã triển khai:

1. Hoàn thành cài đặt v6
2. Đặt epics.md hoặc epics/epic*.md vào _bmad-output/planning-artifacts/
3. Chạy workflow bmad-sprint-planning của Scrum Master
4. Nói rõ với SM những epic/story nào đã hoàn thành

Bạn nhận được gì

Cấu trúc thống nhất của v6:

du-an-cua-ban/
├── _bmad/               # Thư mục cài đặt duy nhất
│   ├── _config/         # Các tùy chỉnh của bạn
│   │   └── agents/      # Tệp tùy chỉnh agent
│   ├── core/            # Framework core dùng chung
│   ├── bmm/             # Module BMad Method
│   ├── bmb/             # BMad Builder
│   └── cis/             # Creative Intelligence Suite
└── _bmad-output/        # Thư mục output (là thư mục docs trong v4)

Di chuyển module

Các thay đổi chính