Bắt đầu nhanh

1. Clone repository

git clone https://github.com/anhdam2/bakit.git
cd bakit

2. Chọn runtime

BA-kit hiện hỗ trợ ba runtime chính:

• Codex: mở repo trực tiếp và dùng AGENTS.md
• Claude Code: chạy installer để copy assets vào ~/.claude
• Antigravity: dùng repo-native prompt hoặc installer để tạo Knowledge Item

3. Dùng ngay với Codex

Chỉ cần mở repo này trong Codex. Với các tác vụ BA không rõ bước, bắt đầu bằng router:

Use AGENTS.md and skills/ba-do/SKILL.md.
Route this BA request to the correct BA-kit command.

Nếu đã biết bước lifecycle:

Use AGENTS.md and skills/ba-start/SKILL.md.
Run the equivalent of /ba-start backbone --slug warehouse-rfp.

4. Cài cho Claude Code

./install.sh

Sau khi cài, restart Claude Code nếu đang mở.

5. Cài cho Antigravity

bash scripts/install-antigravity-ba-kit.sh

Antigravity không có slash command native; sau khi cài, dùng prompt tương đương như:

Read skills/ba-start/SKILL.md and run status for slug warehouse-rfp.

6. Các lệnh chính theo runtime

Claude Code:

/ba-start
/ba-start intake <file>
/ba-start backbone --slug <slug>
/ba-start frd --slug <slug> --module <module_slug>
/ba-start stories --slug <slug> --module <module_slug>
/ba-start srs --slug <slug> --module <module_slug>
/ba-start wireframes --slug <slug> --module <module_slug>
/ba-start package --slug <slug>
/ba-start status --slug <slug>
/ba-collab Tôi nhận module <module_slug>
/ba-collab Gửi module <module_slug> cho Lead BA review

Codex:

$ba-start
$ba-start intake <file>
$ba-start backbone --slug <slug>
$ba-start frd --slug <slug> --module <module_slug>
$ba-start stories --slug <slug> --module <module_slug>
$ba-start srs --slug <slug> --module <module_slug>
$ba-start wireframes --slug <slug> --module <module_slug>
$ba-start package --slug <slug>
$ba-start status --slug <slug>
$ba-collab Tôi nhận module <module_slug>
$ba-collab Gửi module <module_slug> cho Lead BA review

Antigravity:

Đọc BA-kit workflow đã cài và chạy intake cho file <file>.
Đọc BA-kit workflow đã cài và chạy backbone cho slug <slug>.
Đọc BA-kit workflow đã cài và chạy srs cho slug <slug>, module <module_slug>.
Đọc BA-kit collaboration workflow và chạy intent: Tôi nhận module <module_slug>.
Đọc BA-kit collaboration workflow và chạy intent: Gửi module <module_slug> cho Lead BA review.

7. Khi nào dùng ba-do

Dùng ba-do khi người dùng mô tả nhu cầu theo ngôn ngữ tự nhiên, ví dụ:

Claude Code:

/ba-do đang làm dở SRS thì có thêm yêu cầu audit log
/ba-do publish SRS lên Notion
/ba-do xem next step cho project này
/ba-do Tôi nhận module payment
/ba-do Gửi module auth-flow cho Lead BA review

Codex:

$ba-do đang làm dở SRS thì có thêm yêu cầu audit log
$ba-do publish SRS lên Notion
$ba-do xem next step cho project này
$ba-do Tôi nhận module payment
$ba-do Gửi module auth-flow cho Lead BA review

Antigravity:

Đọc BA-kit router workflow và route yêu cầu sau: đang làm dở SRS thì có thêm yêu cầu audit log.
Đọc BA-kit router workflow và route yêu cầu sau: Tôi nhận module payment.

8. Khi nào dùng ba-collab

Dùng ba-collab khi team có nhiều BA cùng làm theo module và người dùng muốn nói bằng ngôn ngữ nghiệp vụ thay vì Git:

Claude Code:

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

Codex:

$ba-collab Tôi nhận module auth-flow
$ba-collab Kiểm tra module payment trước khi gửi review
$ba-collab Lead BA approve module inventory
$ba-collab Tạo PR cho module reporting

Antigravity:

Đọc BA-kit collaboration workflow và chạy intent: Tôi nhận module auth-flow.
Đọc BA-kit collaboration workflow và chạy intent: Kiểm tra module payment trước khi gửi review.
Đọc BA-kit collaboration workflow và chạy intent: Lead BA approve module inventory.
Đọc BA-kit collaboration workflow và chạy intent: Tạo PR cho module reporting.

ba-collab có thể tạo hoặc cập nhật COLLAB-HOME.md, MODULE-HOME.md, review packet và thực hiện local sync an toàn như “Đồng bộ module reporting với main” nếu workspace có quyền Git. Các hành động publish như commit, push, tạo PR hoặc merge PR luôn cần approval rõ trước khi chạy.

9. Runtime defaults

• Ngôn ngữ mặc định: tiếng Việt
• Mode mặc định: hybrid
• UI baseline mặc định: Shadcn UI nếu DESIGN.md chưa override
• Runtime-local memory không phải source of truth; project memory phải nằm trong plans/{slug}-{date}/02_backbone/

10. Lưu ý quan trọng

• Không sửa artifact downstream trực tiếp từ một câu correction ngắn; route qua impact trước.
• Không đoán slug, date hoặc module theo file mới nhất.
• plans/ là workspace runtime, không phải source content của chính toolkit.
• Nếu dự án có nhiều module/owner, kiểm tra project memory và activation state trước khi rerun artifact mutating.
• Với diagram: dùng PlantUML cho swimlane; dùng Mermaid cho sequence, DFD, ERD hoặc flow đơn giản không cần swimlane.