FCI BMad Kit
Một BMad Method module định nghĩa 4 agent theo quy trình FCI:
| Slash command | Agent | Tên | Vai trò |
|---|
/fci-po | Product Owner | Thanh | Viết PRD, tạo Epics, sign-off |
/fci-ba | Business Analyst | Vanh | Viết User Stories (INVEST) |
/fci-dev | Developer | Hieu | Implement + Codegraph MCP |
/fci-tester | QA Tester | Hanh | Test plan, execute, bug report |
Cài trực tiếp qua BMad installer bằng cách dán link git này — không cần copy file thủ công.
Yêu cầu (prerequisites)
Các agent FCI dispatch sang skill của 2 module BMad khác, nên phải cài kèm trong cùng lần install:
bmm (built-in của BMad) — cung cấp: bmad-prd, bmad-create-story, bmad-create-epics-and-stories, bmad-dev-story, bmad-quick-dev, bmad-code-review, bmad-investigate.tea (external: bmad-method-test-architecture-enterprise) — cung cấp: bmad-testarch-automate, bmad-testarch-test-review, bmad-testarch-trace.
Nếu thiếu bmm/tea, agent FCI vẫn chạy nhưng các menu trỏ tới skill của 2 module đó sẽ không resolve được.
Cài đặt
Cách 1 — Cài nhanh (script, không hỏi-đáp)
Có 3 script ở gốc repo:
Cài tất cả (1 lệnh):
# trong thư mục project của bạn
curl -fsSL https://raw.githubusercontent.com/vncharles/fci-bmad-kit/main/install.sh | bash
Chạy riêng từng phần (local sau khi clone, hoặc qua curl):
./install-bmad.sh # chỉ BMad
./install-codegraph.sh # chỉ Codegraph MCP
./install.sh # cả hai (= bmad rồi codegraph)
install.sh ưu tiên dùng 2 script con cạnh nó; khi chạy qua curl | bash (không có file local) nó tự tải 2 script con từ RAW_BASE (mặc định nhánh main của repo này).
Override mặc định qua biến môi trường (tất cả đều optional):
TARGET_DIR=/path/to/project \
USER_NAME="Trong" \
COMM_LANG="Vietnamese" \
DOC_LANG="Vietnamese" \
HANDOFF_FOLDER="handoff" \
CHANNEL="stable" \
./install.sh
| Biến env | Mặc định | Ý nghĩa |
|---|
TARGET_DIR | . | Thư mục cài |
MODULES | bmm,tea,fci | Module cần cài |
TOOLS | claude-code | IDE/tool |
CUSTOM_SOURCE | git URL repo này | Nguồn module fci |
CHANNEL | stable | stable | next |
USER_NAME | username hệ thống | Tên agent gọi bạn |
COMM_LANG / DOC_LANG | Vietnamese | Ngôn ngữ giao tiếp / tài liệu |
OUTPUT_FOLDER | _bmad-output | Thư mục output |
HANDOFF_FOLDER | handoff | Nơi lưu handoff giữa các role |
SETUP_CODEGRAPH | 1 | 1 = tự cài & setup Codegraph MCP, 0 = bỏ qua |
AUTO_INSTALL_NODE | 1 | 1 = tự cài Node qua nvm nếu thiếu/cũ, 0 = chỉ báo lỗi |
NODE_VERSION | 20 | Major Node sẽ cài khi auto-install |
Node: bmad-method 6.8+ cần Node >=20.12. Script tự kiểm tra; nếu máy chưa có Node hoặc Node quá cũ, mặc định nó tự cài Node qua nvm (cài luôn nvm vào $HOME nếu chưa có — user-space, không cần sudo). Muốn tự quản lý Node thì đặt AUTO_INSTALL_NODE=0.
Sau đó script chạy npx bmad-method install (đầy đủ flag non-interactive), rồi setup Codegraph MCP cho project: kiểm tra codegraph --version → npm install -g codegraph nếu thiếu → codegraph init + codegraph status → claude mcp add codegraph -- codegraph serve --mcp --path <project>. Các agent đọc code (dev/ba/tester) dùng Codegraph để duyệt code nhanh; nếu không cần, đặt SETUP_CODEGRAPH=0.
Cách 2 — Cài tương tác (qua BMad installer)
Trong thư mục project của bạn:
npx bmad-method install
Khi installer hỏi chọn module:
-
Chọn bmm (Core / BMad Method).
-
Chọn tea (Test Architect).
-
Chọn Custom module (hoặc "Add a module from a git URL"), rồi dán:
https://github.com/vncharles/fci-bmad-kit
Installer sẽ đọc src/module.yaml, compile 4 agent vào _bmad/fci/, và đăng ký 4 skill /fci-po, /fci-ba, /fci-dev, /fci-tester.
Dùng ngay trong Claude Code
/fci-po → Thanh (Product Owner)
/fci-ba → Vanh (Business Analyst)
/fci-dev → Hieu (Developer)
/fci-tester → Hanh (QA Tester)
Workflow
PO (Thanh) → BA (Vanh) → Dev (Hieu) → Tester (Hanh) → PO sign-off
Handoff files (file-based, mặc định trong handoff/):
handoff/po-to-ba-[feature].mdhandoff/ba-to-dev-[feature].mdhandoff/dev-to-tester-[story-id].mdhandoff/tester-to-po-[story-id]-approved.mdhandoff/tester-to-dev-BUG-[id].md
Cấu trúc module (cho người maintain)
