# Giao thức Kiểm soát Ảo giác (Hallucination Prevention Checklist)

Giao thức này cung cấp bộ checklist bắt buộc để các Review Agents và bản thân Sub-agents đối chiếu chéo kết quả nhằm triệt tiêu hoàn toàn hiện tượng ảo giác (hallucination).

## 1. Nguyên lý đối chiếu chéo (Grounding)
- Không có bất kỳ chi tiết thiết kế hoặc logic code nào được phép tự ý phát minh nếu không có cơ sở chứng cứ rõ ràng từ:
  - Tài liệu Yêu cầu nghiệp vụ (`docs/input/okr-requirement.md`).
  - Bản vẽ thiết kế Basic Design (`bd-*.md`) hoặc Detail Design (`dd-*.md`).
  - Tệp thông tin Context hiện tại (`pipeline-context.yaml`).

## 2. Checklist rà soát chất lượng (Hallucination Checks)
Trước khi đánh dấu một bước là hoàn thành, Agent phải tự xác nhận qua checklist sau:

- [ ] **Sự nhất quán dữ liệu (Data Conformance):** Các kiểu dữ liệu, các bảng và trường thông tin trong code có khớp 100% với file `data-model.md` và `plan.md` không?
- [ ] **Xác thực đường dẫn (Path Verification):** Mọi đường dẫn file được tham chiếu trong spec/plan/tasks có tồn tại vật lý trên đĩa hoặc được định nghĩa trong context không? (Tuyệt đối không đoán đường dẫn).
- [ ] **Độ phủ yêu cầu (Requirement Coverage):** Tất cả các câu trả lời và dòng code có giải quyết đúng mục tiêu nghiệp vụ được giao không? Có thêm thắt tính năng dư thừa ngoài đặc tả (Feature Creep) không?
- [ ] **Độ chính xác của API/Contract:** Các endpoint, headers, và payload API trong frontend và backend có khớp nhau hoàn toàn theo mô tả trong `contracts/` không?

## 3. Quy trình phản biện (Judge Gate)
- Khi Review Agent thực hiện đánh giá (Step 5, 7, 11), nếu phát hiện bất kỳ điểm nào không nhất quán hoặc tự ý sáng tạo không có căn cứ, Review Agent phải từ chối phê duyệt với verdict `REJECTED`.
- Phải liệt kê cụ thể các điểm nghi ngờ ảo giác vào mục `critical-issues` trong Step-Result block để fix agent thực hiện điều chỉnh.