Quy tắc Phiên bản

Rule này quản lý phiên bản — khi nào agent được tự động bump version, khi nào phải hỏi người dùng, và cách đồng bộ tất cả vị trí chứa version.

1. Định dạng Version

BẮT BUỘC dùng Semantic Versioning (MAJOR.MINOR.PATCH). BẮT BUỘC ghi version hiện tại trong frontmatter project.md hoặc .para-workspace.yml.

2. Mức Tự chủ của Agent

Mức	Quyền hạn	Ví dụ
PATCH	Agent ĐƯỢC tự tăng	Sửa bug, lỗi typo
MINOR	Agent BẮT BUỘC hỏi người dùng	Tính năng mới
MAJOR	Agent BẮT BUỘC trình bày kế hoạch	Thay đổi đứt gãy

3. Cổng Phê duyệt (QUAN TRỌNG)

BẮT BUỘC KHÔNG tăng MINOR hoặc MAJOR khi chưa được người dùng cho phép.
NÊN đề xuất bump trong session log và chờ xác nhận.
BẮT BUỘC mặc định PATCH cho tới khi milestone phát hành được phê duyệt.

4. Đồng bộ

Khi bump version, BẮT BUỘC cập nhật TẤT CẢ vị trí:

Vị trí	File
Changelog	`CHANGELOG.md` (entry mới ở đầu)
File version	`VERSION` (nếu có ở gốc repo)
Hợp đồng dự án	Frontmatter `project.md`
Package config	`package.json` version (nếu áp dụng)
UI elements	Footer, badges (nếu áp dụng)

5. Governed Library Items

BẮT BUỘC KHÔNG thay đổi kernel_min/kernel_max trong catalog.yml khi chưa hiểu tương thích.
NÊN tăng version của item khi nội dung thay đổi đáng kể.

Tham khảo

Rule governance — Ràng buộc version Kernel
Rule vcs — An toàn git tagging

→ Trở về Rules Catalog