Dùng với Claude Code

Claude Code là runtime được BA-kit hỗ trợ tốt nhất. Bạn dùng slash command (/ba-start, /ba-do, /ba-collab) - không cần nhớ prompt dài.

Cài đặt

Từ thư mục repo BA-kit:

./install.sh

Script sẽ copy skills, rules, templates vào ~/.claude/.

Kiểm tra: Mở Claude Code, gõ /ba-start. Nếu thấy menu hiện ra → thành công.

Ba entry point chính

/ba-do - Router tự do

Dùng khi bạn không biết chính xác cần lệnh gì:

/ba-do Tôi có file yêu cầu từ khách hàng, muốn tạo tài liệu BA
/ba-do Đang làm SRS thì có thêm yêu cầu audit log
/ba-do Xem next step cho project warehouse-rfp

ba-do sẽ tự phân tích và route đến đúng skill.

/ba-start - Lifecycle engine

Dùng khi bạn biết chính xác step cần chạy:

/ba-start                                    # Xem menu
/ba-start intake requirements.pdf            # Bắt đầu dự án mới
/ba-start options --slug warehouse-rfp       # So sánh hướng giải pháp
/ba-start backbone --slug warehouse-rfp      # Khóa source of truth
/ba-start stories --slug warehouse-rfp --module auth-flow
/ba-start srs --slug warehouse-rfp --module auth-flow
/ba-start package --slug warehouse-rfp       # Đóng gói bàn giao
/ba-start status --slug warehouse-rfp        # Xem trạng thái
/ba-start next --slug warehouse-rfp          # Bước tiếp theo
/ba-start impact --slug warehouse-rfp "thay đổi"  # Phân tích tác động
/ba-start reverse --slug warehouse-rfp       # Reverse BA

/ba-collab - Collaboration

Dùng khi làm việc nhóm:

/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 Lead BA approve module auth-flow
/ba-collab Tạo PR cho module reporting

Flow khuyến nghị

1. Đưa raw requirement vào Claude Code
2. Chạy /ba-start intake để chuẩn hóa
3. Nếu intake gợi ý nhiều hướng → chạy options
4. Chạy backbone để khóa source of truth
5. Sinh FRD, stories, SRS khi gate phù hợp
6. Nếu có UI → chuẩn bị DESIGN.md rồi sync Figma
7. Package và bàn giao

Ví dụ prompt thực tế

Full workflow

/ba-start
Dùng hybrid mode cho solo IT BA.
Parse yêu cầu trong docs/raw/warehouse-rfp.pdf.
Nếu intake đề xuất nhiều hướng solution, chạy options flow trước.
Sau đó build backbone và sinh downstream artifacts khi justified.

Impact analysis

/ba-start impact --slug warehouse-rfp
Yêu cầu mới: Export CSV phải cần permission, ghi audit log, và hiển thị banner thành công hoặc thất bại.

Quy tắc 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 → phải dừng và hỏi rõ
• Nếu context bị trôi → phục hồi từ artifact trên đĩa, không yêu cầu user nhắc lại
• Với source lớn → đọc summary.md và chunk-index.md trước
• Runtime memory của Claude Code không phải nguồn chuẩn → đọc backbone và project memory trên disk

Tiếp theo

• Codex - nếu bạn dùng Codex
• Antigravity - nếu bạn dùng Antigravity
• Hướng dẫn từng bước - flow thực tế