Knowledge Base Index — lane ba/

Nơi AI tra cứu hệ thống hiện tại khi làm Bước 5 (Related Features & Docs Map), Impact Matrix, Field Intake (A2), /document-existing và Review.

⭐ Quy tắc vàng: với hệ thống có code, code + API docs là sự thật, knowledge base chỉ là mục lục. Mọi kết luận "Existing" (field/màn/API đã tồn tại) phải ghi nguồn là file cụ thể đã đọc — không kết luận từ trí nhớ hay từ tên tính năng.

1. Hệ thống đích — ../system-profile.md

Toàn bộ thông tin riêng của dự án đang phân tích (hiện tại: mind_keep) nằm ở một file duy nhất:

Cần	Section
Hệ thống gồm những thành phần nào	§1
Mỗi loại thông tin (API, data, rule, job, quyền, màn hình…) đọc ở đâu	§2
Truy vết một tính năng từ màn hình xuống database	§3
Được / không được ghi vào đâu	§4
Quy ước (ngôn ngữ, mã BU, role, môi trường chụp màn hình)	§5

Đổi sang dự án khác → thay system-profile.md theo template; các skill không cần sửa.

2. Knowledge base ngoài code

KB	Thư mục	Dùng khi
SAPP Academy (clone từ ba-ai) — LMS-Pro / Ops / HubSpot, mục lục link Confluence	sapp/	Yêu cầu chạm hệ thống SAPP (vd tool sapp-* của mind_keep)

Link Confluence đọc qua connector Atlassian (nếu đã kết nối). Không đọc được → ghi rõ giới hạn trong artifact, không đoán nội dung trang.

Thêm KB cho hệ thống khác → tạo thư mục mới ở đây + 1 dòng vào bảng trên + dòng trong system-profile.md §6.

3. Cập nhật knowledge base

• Chỉ đề xuất cập nhật KB (theo ../_workflow/templates/knowledge-base-update/Template.md); ghi khi BA duyệt.
• Tách Reusable Knowledge (ghi vào đây) và Project-Specific Knowledge (giữ trong ba/projects/<project>/).
• Phát hiện doc/map của hệ thống đích sai → không sửa (ranh giới system-profile.md §4): ghi Drift / Open Question và báo BA.