Source document: docs/project-brain/12-BRAIN-VERSIONING.md
Source version: 1.0.0
Generated time: 2026-07-06T14:59:23.038Z
Owner: Unassigned
Audience: Internal
Status: Approved

12 — BRAIN VERSIONING

Semantic version cho từng Brain Pack. Giúp consumer biết Brain đổi cỡ nào (major/minor/patch). Version ghi ở đầu mỗi Brain (khi áp dụng) + tổng hợp ở đây.

Quy tắc semver cho Brain

MAJOR.MINOR.PATCH:

MAJOR — đổi phạm vi/ranh giới brain (gộp/tách brain, đổi domain nó phủ), hoặc snapshot cũ không còn đúng (state đảo chiều: vd "RLS staging on" → "off"). Consumer phải đọc lại.
MINOR — thêm mục/section, cập nhật state tiến triển (vd thêm sprint mới, thêm canonical link, đổi status design→partial). Backward-compatible.
PATCH — sửa typo, sửa link, làm rõ câu chữ. Không đổi nghĩa.

Bảng version hiện tại (khởi tạo OMS-2)

Brain	Version	Ghi chú
00-BRAIN-ROUTER	1.0.0	Khởi tạo (rule-based router)
01-BACKEND	1.0.0	Khởi tạo
02-PLATFORM	1.0.0	Khởi tạo
03-BUSINESS	1.0.0	Khởi tạo
04-FOUNDER	1.0.0	Khởi tạo (M4A viewer)
05-KNOWLEDGE	1.0.0	Khởi tạo
06-DEPLOYMENT	1.0.0	Khởi tạo
07-SECURITY	1.0.0	Khởi tạo
08-ROADMAP	1.0.0	Khởi tạo

Quy trình bump

Sửa Brain → xác định cấp (major/minor/patch) theo quy tắc trên.
Bump version trong bảng này + 09-BRAIN-MANIFEST (Last updated = sprint tag).
Nếu MAJOR → note lý do (state đảo/ranh giới đổi) để consumer đọc lại.

Version = độ tin cậy của snapshot. Đổi state lớn (vd bật RLS production) = MAJOR bump 07-SECURITY + 06-DEPLOYMENT.

Liên hệ

Handoff (khi nào bump): 11-BRAIN-HANDOFF. Semver dự án/API: engineering/08-RELEASE-TRAIN, travel-os/06-API-GUIDELINES.

Nguồn sự thật (Source of Truth): docs/project-brain/12-BRAIN-VERSIONING.md · v1.0.0 · sinh tự động lúc 2026-07-06T14:59:23.038Z. Trang này là view suy dẫn — không sửa trực tiếp.