Cách BA-kit hoạt động

Lifecycle chuẩn

Raw input
-> Intake + Gap Analysis
-> PROJECT-HOME.md
-> Requirements Backbone
-> Project Memory
-> COLLAB-HOME.md / MODULE-HOME.md khi có teamwork
-> FRD / User Stories
-> SRS
-> DESIGN.md + wireframe-input.md + wireframe-map.md
-> User tự tạo wireframe/mockup
-> Final packaging

Nguyên tắc vận hành

1. Backbone-first

Sau intake, backbone trở thành source of truth chính. Các artifact sau đó phải bám theo backbone thay vì diễn giải lại từ raw input.

2. Gated artifact emission

Không phải dự án nào cũng cần sinh mọi artifact với cùng độ sâu. BA-kit chỉ phát hành FRD, stories, SRS hoặc wireframe handoff khi điều kiện phù hợp.

3. Project memory không thay backbone

Sau backbone, BA-kit có thể tạo project-memory.md để lưu vocabulary, decisions, assumptions, corrections và push-back triggers đã được chấp nhận. Với dự án phức tạp, memory có thể mở rộng thành cây shard project-memory/, nhưng backbone.md vẫn là source of truth chính.

4. Exact resolution

Hệ thống ưu tiên:

• --slug explicit
• --date explicit
• --module explicit

BA-kit không được chọn theo mtime hoặc pattern mơ hồ.

5. Impact-first cho requirement change

Nếu project đã có artifact và xuất hiện thay đổi requirement, rule, actor hoặc screen behavior, đường đi đúng là impact trước, không mutate trực tiếp artifact đích.

6. Manual wireframe handoff

Bước wireframes không sinh UI cuối. Nó chuẩn bị:

• designs/{slug}/DESIGN.md
• wireframe-input.md
• wireframe-map.md
• wireframe-state.md

User hoặc designer sẽ tạo wireframe/mockup ở ngoài và attach ngược lại vào SRS.

7. BA-friendly collaboration trước GitHub

Khi dự án có nhiều module hoặc nhiều BA, BA-kit dùng ba-collab để điều phối bằng intent nghiệp vụ:

• nhận hoặc assign module
• kiểm tra module trước review
• gửi Lead BA review
• mark changes-requested, approved, integrated hoặc blocked
• tạo GitHub handoff chỉ sau approval rõ

COLLAB-HOME.md, MODULE-HOME.md và review packet là coordination layer. Chúng không thay thế backbone.md, DESIGN.md, project memory hoặc artifact module.

8. Runtime-neutral behavior

Claude Code, Codex và Antigravity có syntax khác nhau, nhưng phải giữ cùng rule về path resolution, prerequisite, overwrite approval, impact routing, activation và memory read scope. Runtime-local memory không phải nguồn chuẩn; nguồn tái sử dụng phải nằm trên disk trong artifact set của dự án.

Vai trò của từng lớp

Chất lượng tối thiểu

• Mỗi requirement có acceptance criteria
• Use case có primary và alternate flow khi SRS tồn tại
• Screen description có navigation, validation và state
• Recommendation phải gắn với business value, risk hoặc outcome
• Memory không được biến thành transcript dump hoặc source of truth thứ hai
• Collaboration dashboard không được dùng để âm thầm đổi requirement hoặc shared decision
• Khi uncertainty ảnh hưởng scope, actor, rule hoặc artifact owner, agent phải fail-closed và hỏi lại