Foundations
Danh mục kỹ năng
`ba-start` có thể chạy full lifecycle hoặc step-level rerun:
Danh mục kỹ năng
Các skill chính
| Skill | Vai trò |
|---|---|
ba-start | Lifecycle engine cho toàn bộ BA flow |
ba-do | Router cho yêu cầu BA dạng tự nhiên |
ba-collab | Router cộng tác cho nhận module, gửi review, approve, integrate và GitHub handoff có approval gate |
ba-impact | Phân tích tác động khi requirement thay đổi |
ba-next | Xác định bước kế tiếp từ artifact set hiện tại |
ba-notion | Publish artifact lên Notion |
ba-kit-update | Cập nhật runtime BA-kit đã cài |
ba-start làm gì
ba-start có thể chạy full lifecycle hoặc step-level rerun:
intakeimpactbackbonefrdstoriessrswireframespackagestatus
ba-collab làm gì
ba-collab giúp BA nói bằng intent nghiệp vụ thay vì phải bắt đầu bằng Git. Skill này map các câu như “Tôi nhận module payment”, “Gửi module auth-flow cho Lead BA review”, “Approve module inventory” hoặc “Tạo PR cho module reporting” sang workflow an toàn.
Artifact cộng tác chính:
COLLAB-HOME.md: dashboard ai đang làm module nào, trạng thái BA, trạng thái review, blocker và bước tiếp theo.MODULE-HOME.md: dashboard riêng cho Module BA, gồm phạm vi được sửa, checklist trước review và rủi ro chéo module.- Module review packet: gói gửi Lead BA review, gồm artifact đã chạm, trace IDs ảnh hưởng, cross-module risk và GitHub mapping optional.
Quy tắc an toàn:
- Requirement change hoặc thay đổi scope/shared decision phải route qua
ba-impacttrước. - Module BA chỉ sửa trong
03_modules/{module_slug}/nếu chưa có approval escalation. - Local sync không publish có thể chạy sau plan ngắn nếu không có local changes/conflict.
- Commit, push, tạo PR, request reviewer và merge PR chỉ được làm sau khi user approve rõ.
Runtime invocation:
| Runtime | Cách gọi |
|---|---|
| Claude Code | /ba-collab Tôi nhận module payment |
| Codex | $ba-collab Tôi nhận module payment hoặc Use AGENTS.md and the ba-collab workflow... |
| Antigravity | Đọc BA-kit collaboration workflow và chạy intent: Tôi nhận module payment. |
Agent boundaries
| Agent | Trách nhiệm |
|---|---|
requirements-engineer | Backbone, FRD, stories, SRS |
ui-ux-designer | Constraint pack và handoff cho wireframe |
ba-documentation-manager | Kiểm tra tính nhất quán và packaging |
ba-researcher | Research khi cần domain context |
Runtime và memory support
Các skill BA không được tự đọc toàn bộ project tree khi chỉ cần một step cụ thể. Contract hiện tại yêu cầu:
- đọc
core/contract.yamlđể lấy path, threshold và state chuẩn - đọc
core/contract-behavior.mdđể lấy policy routing, memory, governance và stop condition - đọc
project-memory.mdhoặc shard liên quan khi cần support context - không đọc
log.md,cold/hoặc shard module không liên quan nếu không có lý do escalation
Với teamwork nhiều module, memory packet phải truyền objective, write scope, trace IDs và excerpt cần thiết thay vì gửi toàn bộ memory tree cho sub-agent.
Quality bar
- Requirement có acceptance criteria
- Use case có primary và alternate flow
- Screen mô tả được validation và state
- Traceability phải nhìn thấy được từ business goal xuống artifact