Imported from HaPhiHung-HE186793/mugen (AGENTS.md). Install upstream with npx skills add HaPhiHung-HE186793/mugen. Copyright stays with the author.

Quy tắc an toàn bắt buộc cho AI

Phạm vi của file này là toàn bộ thư mục game và mọi thư mục con.

Nguyên tắc không được vi phạm

1. Không sửa, xóa, đổi tên hoặc di chuyển file nếu người dùng chỉ yêu cầu phân tích, giải thích, kiểm tra hoặc chẩn đoán.
2. Trước mọi thay đổi, phải chạy git status --short --branch và đọc diff hiện có. Mọi thay đổi có sẵn đều thuộc về người dùng; không được ghi đè, xóa hoặc hoàn tác chúng.
3. Nếu chưa có commit baseline, phải dừng việc sửa và tạo/đề nghị tạo baseline trước.
4. Không làm việc trực tiếp trên nhánh main. Mỗi yêu cầu sửa phải dùng một nhánh riêng có tên ai/<mo-ta-ngan>.
5. Trước khi sửa một nhóm file, phải tạo một commit checkpoint nếu working tree đang sạch và có thay đổi hợp lệ chưa được lưu. Không được dùng git reset --hard, git clean -fd, git checkout -- . hoặc lệnh phá hủy tương đương.
6. Chỉ sửa những file cần thiết cho yêu cầu. Không tự ý format hàng loạt, nâng cấp, dọn dẹp hoặc thay đổi file không liên quan.
7. Không sửa các asset nhị phân hoặc file lớn (.sff, .snd, audio, ảnh, archive, executable, PSD) trừ khi người dùng yêu cầu rõ ràng và đã có phương án backup riêng cho đúng file đó.
8. Không tự ý thêm asset lớn vào Git, Git LFS hoặc GitHub. Không được dùng git add -f để vượt .gitignore nếu chưa có xác nhận rõ ràng của người dùng.
9. Sau khi sửa, phải chạy kiểm tra phù hợp, rồi hiển thị/tóm tắt git diff --stat và các thay đổi quan trọng. Không tuyên bố hoàn thành nếu chưa kiểm tra.
10. Mỗi nhóm thay đổi hoàn chỉnh phải là một commit nhỏ, có thông điệp rõ ràng. Không amend, squash, force-push hoặc rewrite lịch sử nếu người dùng chưa yêu cầu rõ ràng.
11. Không push lên GitHub nếu chưa xác nhận không có file lớn, dữ liệu cá nhân, token, mật khẩu hoặc nội dung ngoài phạm vi. Không force-push.
12. Khi bàn giao, luôn cung cấp tên nhánh, commit ID, file đã sửa, kết quả kiểm tra và lệnh rollback an toàn.

Quy trình bắt buộc khi sửa

1. Kiểm tra: git status --short --branch.
2. Đồng bộ thông tin từ remote bằng thao tác không ghi đè dữ liệu, nếu cần.
3. Xác nhận đang có baseline và working tree không chứa thay đổi xung đột.
4. Tạo nhánh: git switch -c ai/<mo-ta-ngan>.
5. Sửa tối thiểu trong phạm vi yêu cầu.
6. Kiểm tra diff: git diff --check, git diff --stat, và git diff cho file liên quan.
7. Chạy test hoặc kiểm tra cú pháp phù hợp.
8. Commit các file cụ thể; không dùng git add -A một cách mù quáng.
9. Push nhánh AI, không push thẳng main, trừ khi người dùng yêu cầu rõ ràng.
10. Báo cách hoàn tác.

Cách hoàn tác an toàn

• Bỏ thay đổi chưa commit của một file: git restore -- <duong-dan-file>.
• Hoàn tác một commit đã lưu: git revert <commit-id>.
• Trở về nhánh gốc mà không xóa nhánh thử nghiệm: git switch main.
• Khôi phục một file từ baseline: git restore --source <baseline-commit> -- <duong-dan-file>.

Nếu rollback có thể làm mất thay đổi chưa commit của người dùng, AI phải dừng và hỏi trước.

Quy định riêng của dự án M.U.G.E.N / Ikemen GO

• File cấu hình đang hoạt động chính là save/config.json; không giả định data/mugen.cfg đang được engine sử dụng.
• Ưu tiên thay đổi file text và từng tham số một để dễ kiểm thử/rollback.
• Không sửa Ikemen_GO.exe hoặc nội dung nhân vật/stage ngoài yêu cầu.
• Thư mục chars/ bị bỏ qua mặc định. Trước khi sửa file text của một nhân vật, phải thêm ngoại lệ hẹp vào .gitignore, commit file gốc của đúng nhân vật đó, rồi mới tạo commit sửa đổi. Không dùng git add -f để bỏ qua bước baseline này.
• Với file save/progress, phải phân biệt cấu hình với tiến trình người chơi và không ghi đè tiến trình ngoài phạm vi.