Làm việc nhóm với BA-kit

Trang này hướng dẫn BA team làm việc theo module. BA-kit dùng Git bên dưới để quản lý phiên bản và phân chia công việc — nhưng bạn không cần biết Git sâu. Bạn nói intent bằng tiếng Việt, agent lo phần kỹ thuật.

Git cho BA (phiên bản 5 phút)

Nếu bạn chưa từng dùng Git, đây là những khái niệm cơ bản nhất:

Workflow chuẩn cho Module BA

1. Lead BA tạo project, chạy intake + backbone, chia module
2. Module BA nhận module: "Tôi nhận module auth-flow"
3. Module BA làm việc trong 03_modules/auth-flow/
4. Làm xong, tự kiểm tra: đúng scope chưa? Còn thiếu state nào không?
5. Gửi review: "Gửi module auth-flow cho Lead BA review"
6. Agent tạo review packet (local) hoặc PR (nếu approve)
7. Lead BA review, có thể yêu cầu sửa (changes-requested) hoặc approve
8. Sau khi approve, Lead BA merge

Branch và module — first-come-first-serve

Khi làm việc với Git, mỗi module BA làm trên branch riêng:

ba/{slug}/{module_slug}

Ví dụ: ba/warehouse-rfp/auth-flow, ba/warehouse-rfp/reporting

Nguyên tắc first-come-first-serve:

• Ai nhận module trước, người đó làm module đó
• Không ai được sửa module của người khác
• Nếu cần sửa shared artifact → báo Lead BA
• Merge PR theo thứ tự: core PR trước, module PR sau

Review packet (không cần GitHub)

Trước khi tạo PR thật, BA-kit dùng review packet — file markdown local:

delegation/review-packets/{module_slug}.md

Review packet chứa:

• Tóm tắt thay đổi
• File đã sửa
• Trace IDs bị ảnh hưởng
• Cross-module risk (nếu có)
• Open questions

Lead BA review packet trước. Chỉ khi approve mới tạo PR thật.

Conflict — xử lý thế nào

Conflict xảy ra khi 2 người cùng sửa một file. Với BA-kit:

1. Agent phát hiện conflict → dừng, không tự giải quyết
2. Agent báo: file nào, section nào bị conflict
3. Lead BA (hoặc người được chỉ định) quyết định giữ bản nào
4. Agent áp dụng resolution
5. Tiếp tục flow

BA không tự xử lý conflict. Nếu không quen Git, báo Lead BA.

Ví dụ: 2 BA cùng làm dự án warehouse-rfp

Ngày 1: Lead BA setup

# Lead BA (Claude Code)
/ba-start intake requirements/warehouse-rfp.pdf
/ba-start backbone --slug warehouse-rfp

Kết quả: backbone.md với 2 module: quote-intake, reporting

Ngày 1: Phân công

Module BA 1 (chị Lan):

/ba-collab Tôi nhận module quote-intake

Module BA 2 (anh Nam):

/ba-collab Tôi nhận module reporting

COLLAB-HOME.md cập nhật: quote-intake → Lan (assigned), reporting → Nam (assigned)

Ngày 2-3: Làm việc song song

Chị Lan:

/ba-start stories --slug warehouse-rfp --module quote-intake
/ba-start srs --slug warehouse-rfp --module quote-intake

Anh Nam:

/ba-start stories --slug warehouse-rfp --module reporting
/ba-start srs --slug warehouse-rfp --module reporting

Ngày 4: Review

Chị Lan gửi review trước:

/ba-collab Tôi làm xong module quote-intake, gửi Lead BA review

Lead BA review → approve → merge.

Anh Nam gửi review sau:

/ba-collab Tôi làm xong module reporting, gửi Lead BA review

Tình huống: Anh Nam phát hiện cần thêm actor

Anh Nam thấy backbone.md thiếu actor "Auditor" cho module reporting.

Đúng: Báo Lead BA, không tự sửa backbone.

/ba-collab Phát hiện thiếu actor Auditor trong backbone, cần cho module reporting. Báo Lead BA.

Sai: Tự thêm actor vào backbone trong PR module.

Lead BA xử lý:

/ba-start impact --slug warehouse-rfp "Thêm actor Auditor"

→ Impact báo: cần cập nhật backbone.md → Lead BA sửa backbone, merge core PR trước → Anh Nam sync module với main, tiếp tục làm

Approval gate

Các hành động sau luôn cần approval rõ từ user:

• Commit
• Push lên GitHub
• Tạo Pull Request
• Request reviewer
• Merge PR vào main

Agent phải hiển thị action plan trước khi chạy và chờ user confirm.

Runtime invocation

Tiếp theo

• Xử lý thay đổi — 5 tình huống thường gặp khi dự án đang chạy
• Hướng dẫn từng bước — flow BA tổng quan