Dùng với Claude Code

Cài đặt

Từ root của repository:

./install.sh

Script sẽ copy skill, rule, template và shared workflow vào runtime của Claude Code.

Cách vận hành trong Claude Code

Claude Code là runtime có mức tương thích cao nhất với BA-kit vì hỗ trợ slash command style và đọc trực tiếp các instruction đã cài trong ~/.claude.

Sau khi cài, BA-kit có 2 entry point chính:

• ba-do cho yêu cầu BA tự nhiên
• ba-start cho lifecycle step rõ ràng
• ba-collab cho module ownership, review packet và GitHub handoff có approval gate

Entry points chính

/ba-do <mô tả BA task>
/ba-start
/ba-start status --slug <slug>
/ba-collab Tôi nhận module <module_slug>
/ba-notion srs --slug <slug> --page <url> --mode overwrite

Khi nào dùng ba-do và khi nào dùng ba-start

Dùng ba-do

Dùng khi anh chưa muốn tự quyết step. Ví dụ:

/ba-do đang làm dở SRS thì có thêm yêu cầu audit log
/ba-do xem next step cho project này
/ba-do publish SRS lên Notion

Dùng ba-start

Dùng khi anh đã biết chính xác workflow cần chạy:

/ba-start
/ba-start backbone --slug warehouse-rfp
/ba-start stories --slug warehouse-rfp --module auth-flow
/ba-start srs --slug warehouse-rfp --module auth-flow

Dùng ba-collab

Dùng khi BA team làm theo module và cần nhận module, gửi review, approve, integrate hoặc tạo PR có kiểm soát:

/ba-collab Tôi nhận module auth-flow
/ba-collab Kiểm tra module payment trước khi gửi review
/ba-collab Tôi làm xong module payment, gửi Lead BA review
/ba-collab Tạo PR cho module auth-flow

ba-collab có thể cập nhật COLLAB-HOME.md, MODULE-HOME.md, review packet và chạy local sync an toàn sau plan ngắn. Commit, push, tạo PR, request reviewer hoặc merge PR chỉ được làm sau khi user approve rõ.

Khi nào dùng từng lệnh

Flow khuyến nghị

1. Đưa raw requirement hoặc business context vào Claude Code.
2. Cho BA-kit chạy intake và khóa scope.
3. Sinh backbone trước mọi artifact formal.
4. Chỉ sinh FRD, stories, SRS khi gate phù hợp.
5. Nếu có UI scope, chuẩn bị DESIGN.md và wireframe handoff pack.
6. Để user/designer tự tạo mockup cuối và attach lại vào SRS.

Ví dụ prompt thực tế

Full workflow

/ba-start
Use hybrid mode for a solo IT BA.
Parse the requirements in docs/raw/warehouse-rfp.pdf.
Build the backbone first, then emit downstream artifacts only when justified.

Step-level rerun

/ba-start wireframes --slug warehouse-rfp --module auth-flow
Reuse the approved DESIGN.md if it already exists.
Do not regenerate FRD or stories.

Change impact

/ba-start impact --slug warehouse-rfp
New requirement: Export CSV must require permission, write an audit log, and show a success or failure banner.

Quy tắc vận hành quan trọng

• Nếu có nhiều slug, hệ thống phải dừng và hỏi rõ
• Nếu một slug có nhiều dated set, hệ thống phải dừng và hỏi rõ
• Nếu context bị trôi, phục hồi từ artifact trên đĩa thay vì yêu cầu user nhắc lại từ đầu
• Nếu delegation bị stall, chỉ rerun slice bị nghẽn
• Không sửa artifact downstream trực tiếp từ một correction statement ngắn; route qua impact trước
• Deliverable mặc định viết bằng tiếng Việt nếu anh không yêu cầu tiếng Anh
• Runtime memory của Claude Code không phải nguồn chuẩn; khi tiếp tục project phải đọc backbone và project memory trên disk
• Với shard memory, chỉ đọc shard được project-memory/index.md định tuyến thay vì nạp toàn bộ memory tree