BakitTừng skill Bakit
ba-review — Review gate độc lập
Review độc lập, hash-bound cho từng nhóm artifact BA theo 4 gate: Scope, Behavior, Specification, Release. Chạy tự động bởi controller.
ba-review
ba-review là skill review độc lập của Bakit. Nó đánh giá một nhóm artifact giới hạn (review packet) và sinh bằng chứng review — không bao giờ tự sửa tài liệu. Đây là cơ chế governance đảm bảo mọi artifact được duyệt bởi một bên độc lập trước khi đi tiếp.
Không gọi trực tiếp. ba-review do controller tự động dispatch khi bạn chạy các bước lifecycle (srs, use-case, wireframe, package, ...). Bạn không cần và không nên gọi skill này bằng tay.
4 gate review
Mỗi gate chặn các bước downstream cho đến khi được duyệt:
| Gate | Duyệt cái gì | Chặn bước nào nếu chưa duyệt |
|---|---|---|
| Scope | Intake, backbone, scope lock | FRD, stories, SRS, ASCII, compile, package |
| Behavior | Use cases, behavior canon | ASCII, specification review, compile, package |
| Specification | SRS spec, screen canon | Compile, staging, promotion |
| Release | Staged deliverables | Promotion và trạng thái finished |
Cách hoạt động
- Controller tạo review packet giới hạn: node/attempt IDs, source paths, SHA-256 hashes, write scope, trace IDs
- Reviewer (role
ba-reviewer, chạy độc lập với producer) đọc đúng packet, không mở rộng nguồn - Recompute SHA-256 cho mọi source — hash lệch → receipt
stalehoặcblocked - Chạy mọi validator bắt buộc của gate; validator fail = blocker
- Phân loại findings: blocker / observation / unresolved business decision
- Sinh receipt hash-bound: chỉ
approvedkhi zero blockers + hashes current + validators pass
Kết quả tạo ra
review-report.md— findings kèm evidence, severity, recommendationreview-backlog.md— danh sách blocker/observation kèm owner role và target pathreview-receipt.yaml— quyết định machine-readable, hash-bound
Nguyên tắc cốt lõi
- Read-only với producer sources — findings được route về producer sở hữu để sửa, reviewer không sửa thay
- Độc lập tuyệt đối — reviewer và producer phải là execution identity khác nhau
- Score không override blocker — điểm số chỉ mang tính tham khảo; approval đòi hỏi zero blockers
- Receipt stale khi source đổi — bất kỳ thay đổi nào vào source đã review đều làm receipt hết hiệu lực và chặn lại
- Tối đa 2 vòng remediation tự động per node — sau đó escalate lên người dùng
Xem changelog để biết thêm chi tiết.