QUY TẮC THIẾT KẾ VÀ VẬN HÀNH RESEARCH PIPELINE (TIÊU CHUẨN CEO ARS 3.0.0)

Tài liệu này chuẩn hóa cách thức thiết kế, phân chia giai đoạn và vận hành luồng nghiên cứu học thuật của Hermes (đặc biệt tối ưu cho tiếng Việt).

I. CẤU TRÚC 4 PHASE VÀ PHÂN VAI (PROFILE)

Phase 1a (Khảo sát): Xác định mục tiêu, danh sách đối tượng nghiên cứu và phương pháp. Assignee: r-and-d.
Phase 1b (Template): Xây dựng cấu trúc biểu mẫu báo cáo đầu ra. Assignee: r-and-d.
Phase 2 (Deep Research): Nghiên cứu chi tiết từng đối tượng cụ thể (Mỹ, Anh, Trung Quốc, Úc) độc lập song song. Assignee: r-and-d.
Phase 3 (Tổng hợp): Đọc toàn bộ báo cáo Phase 2 để tổng hợp ma trận so sánh. Assignee: writers.
Phase 4a (Phản biện): Thẩm định độc lập chất lượng bằng kỹ năng research-critism. Assignee: grill-qa (Reviewer).
Phase 4b (Chỉnh sửa): Writers tiếp thu góp ý phản biện để ra bản báo cáo hoàn thiện cuối cùng. Assignee: writers.

II. THIẾT KẾ KANBAN TASK BODY

Mô tả (body) của từng Task trên Kanban phải chứa đủ 5 phần thông tin để Agent tự hoạt động: * [CONTEXT]: File/thư mục bắt buộc đọc. * [PROFILE]: Vai trò của Agent. * [MỤC TIÊU]: Các gạch đầu dòng công việc cần hoàn tất. * [OUTPUT]: Đường dẫn tuyệt đối lưu file. * [MANUAL GATE]: Hướng dẫn lưu file, viết comment, đổi trạng thái và DỪNG.

III. CƠ CHẾ KHÓA CỨNG (MANUAL GATE & DEPENDENCIES)

Tắt hoàn toàn cơ chế tự động chuyển trạng thái của Kanban dispatcher.
Sử dụng SQLite task_links để khóa cứng: Phase 3 phụ thuộc vào toàn bộ Phase 2; Phase 4a phụ thuộc Phase 3; Phase 4b phụ thuộc Phase 4a.
Chỉ chuyển trạng thái sang ready/running sau khi CEO duyệt sản phẩm của Phase trước đó.

IV. ĐỊNH DẠNG LINK BÁO CÁO (TAILSCALE FUNNEL)

Bắt buộc dùng tiền tố Tailscale Funnel: https://vmi3427693.tail8c1aaf.ts.net/files/[đường_dẫn_tuyệt_đối]
Ví dụ: https://vmi3427693.tail8c1aaf.ts.net/files/opt/ai-os/products/ceo/content/research/educational_planning_positions/master_reports/educational_planning_us.md

V. CÁC CẠNH BÁO QUAN TRỌNG (PITFALLS)

SQLite Corruption: Không dùng patch hay write_file sửa file .db nhị phân. Phải dùng code Python hoặc sqlite3 CLI.
File Permissions: Khi tạo file báo cáo mới, luôn chạy chmod 644 [file_path] để cấp quyền cho Nginx đọc file (tránh lỗi 404/403 qua Funnel).
Path Routing: Chạy Python server tại /opt/ai-os/products/ceo/content và tạo symlink files -> research để khớp chính xác cấu hình Nginx.