Workflow cộng tác thân thiện cho BA

Mục tiêu

ba-collab giúp BA team vận hành module ownership, review và handoff mà không cần bắt đầu bằng thuật ngữ Git. BA chỉ cần nói intent nghiệp vụ; agent map intent đó sang artifact cộng tác, kiểm tra scope, tạo review packet và GitHub handoff có approval gate.

Ví dụ intent BA giống nhau, nhưng cách gọi khác nhau theo runtime:

Claude Code

Claude Code dùng slash command:

/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

Codex

Codex dùng skill mention $ba-collab hoặc prompt repo-native có AGENTS.md:

$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

Nếu skill mention không tiện dùng, viết rõ:

Use AGENTS.md and the ba-collab workflow.
Tôi nhận module auth-flow.
Resolve project/module exactly, update collaboration artifacts or run local sync only when safe, and do not commit/push/create PR without explicit approval.

Antigravity

Antigravity không có slash command hoặc $skill native. Dùng prompt tương đương và yêu cầu đọc Knowledge Item / workflow đã cài:

Đọc BA-kit collaboration workflow và chạy intent sau:
Tôi nhận module auth-flow.

Hãy resolve đúng project/module, cập nhật COLLAB-HOME.md hoặc MODULE-HOME.md nếu an toàn, local sync nếu cần, và không commit/push/tạo PR nếu tôi chưa approve rõ.

Artifact mới trong collaboration flow

Các dashboard này giúp BA nhìn workflow bằng trạng thái nghiệp vụ như assigned, in-progress, ready-for-review, approved, integrated thay vì phải tự nhớ branch, commit hoặc PR.

Intent BA được hỗ trợ

Trạng thái chuẩn

Trạng thái module:

• unassigned
• assigned
• in-progress
• ready-for-review
• changes-requested
• approved
• integrated
• blocked

Trạng thái review:

• none
• local-packet
• draft-pr
• review-requested
• changes-requested
• approved
• merged
• conflict

Scope và ownership

Module BA chỉ nên sửa artifact trong:

plans/{slug}-{date}/03_modules/{module_slug}/

Nếu thay đổi chạm các vùng sau, agent phải flag escalation cho Lead BA:

• 02_backbone/backbone.md
• designs/{slug}/DESIGN.md
• hot/global project memory
• module khác trong 03_modules/
• actor, portal, navigation, shared rule hoặc cross-module dependency

Nếu request thực chất là đổi requirement, scope, rule hoặc shared decision, không xử lý trực tiếp bằng ba-collab; route qua ba-impact trước.

Local Git là implementation detail

Nếu agent đang chạy trong môi trường có quyền Git, BA không cần tự chạy lệnh như git checkout, git pull hoặc git merge. BA nên nói bằng NLP:

Cập nhật module reporting theo bản mới nhất
Đồng bộ module reporting với main trước khi tôi làm tiếp

Agent có thể tự chạy các thao tác local, không publish sau khi hiển thị plan ngắn:

1. Kiểm tra branch hiện tại và module target.
2. Kiểm tra uncommitted changes.
3. Fetch/pull main theo policy của repo.
4. Switch sang branch module nếu resolve được chính xác.
5. Merge hoặc rebase main vào branch module theo policy.
6. Nếu có conflict, dừng và giải thích bằng ngôn ngữ BA.

Guardrails bắt buộc:

• Nếu có local changes chưa commit, agent phải dừng hoặc hỏi cách xử lý; không tự stash, overwrite hoặc discard.
• Nếu merge conflict, agent không tự đoán resolution cho requirement docs; phải báo file/section conflict và hỏi Lead BA hoặc owner.
• Nếu không resolve được branch/module chính xác, agent phải hỏi lại.
• Local sync không được tự commit hoặc push.

Ví dụ output trước khi chạy:

Tôi sẽ:
1. Kiểm tra module reporting có thay đổi local không.
2. Cập nhật main từ origin.
3. Merge main vào branch module reporting.
4. Nếu có conflict, tôi sẽ dừng và liệt kê phần BA cần quyết định.

Không commit/push trong bước này.

Approval gate cho publish actions

ba-collab được phép tạo hoặc cập nhật artifact local như COLLAB-HOME.md, MODULE-HOME.md, review packet và thực hiện local sync an toàn khi không có blocker. Nhưng các hành động publish/audit trail sau luôn cần approval rõ:

• commit
• push
• tạo Pull Request
• request reviewer
• merge Pull Request vào branch shared như main

Trước khi chạy các hành động này, agent phải hiển thị:

• action plan chính xác
• danh sách file sẽ được đưa vào
• branch, commit message hoặc PR title nếu có
• câu hỏi xin approval rõ từ user

Nếu chưa có approval, workflow dừng ở review packet local hoặc local sync đã hoàn tất, không publish.

Kết quả agent nên trả về

Sau mỗi lần chạy, agent nên hiển thị theo dạng BA-friendly:

BA Collaboration

Project: {slug}
Module: {module}
Action: {friendly action}
Status: {collab_module status}
Review: {collab_review status}
Updated: {paths updated}
Next: {next BA-friendly step}
External GitHub action: {not requested | approval required | completed}

Khi nào đọc tiếp tài liệu GitHub

Nếu team chỉ cần nhận module, đồng bộ local, gửi review local và Lead BA kiểm soát scope, trang này là đủ để bắt đầu. Khi cần tạo branch trên GitHub web, commit, PR hoặc merge PR thật trên GitHub, đọc tiếp Làm việc theo module với GitHub.

Runtime cheat sheet