ba-impact

Khi khách hàng hoặc người liên quan thay đổi yêu cầu giữa chừng, ba-impact giúp bạn biết chính xác những tài liệu nào bị ảnh hưởng và cần sửa gì. Từ v2.1.0, impact có 2 phase: lập plan và thực thi (cook).

Cách gọi

Phase 1: Phân tích và lập change plan

/ba-impact --slug ten-du-an "Export CSV phải có audit log"
/ba-impact --slug ten-du-an docs/changes/new-rule.md

1. Nhận mô tả thay đổi từ bạn (bằng tiếng Việt tự nhiên, hoặc file)
2. Đọc toàn bộ tài liệu hiện có của dự án
3. Tính closure set deterministic từ artifact-dependency graph — tập đầy đủ artifact phải cập nhật cùng nhau
4. Sinh change plan: impacts/CR-{id}-plan.md với từng closure artifact kèm Action

Phase này không sửa canon — chỉ phân tích và lập plan. Bạn xem plan và quyết định có áp dụng không.

Phase 2: Thực thi change plan (cook)

/ba-impact cook --slug ten-du-an --cr 20260811-001
/ba-impact cook --slug ten-du-an --auto

Cook đọc change plan và thực thi:

• Artifact governed (backbone, stories, SRS, ...) → đi qua lifecycle command sở hữu của nó, giữ nguyên review gates
• Artifact derived (index, compiled, ...) → controller ghi trực tiếp
• L1/L2 change notification trước mỗi lần ghi file, mặc định BẬT; chỉ tắt được bằng --auto

Không có change plan → cook từ chối và route về phase 1 trước.

Kết quả tạo ra

• impacts/CR-{id}-plan.md — change plan với closure set, mức độ ảnh hưởng, Action per artifact
• Sau cook: toàn bộ closure set được cập nhật nhất quán, verified fresh trước khi báo done