Claude Code subagent imported from drluanbv175/medical-ebm-automation (.claude/agents/_ROUTINE-AGENT-WIRING.md). Copyright stays with the author.

CHUẨN WIRING ROUTINES ↔ ĐỘI AGENT EBM

Nguồn sự thật DUY NHẤT cho cách các routine uỷ thác cho đội agent (.claude/agents/): 7 routine VẬN HÀNH có Scheduled/<tên>/SKILL.md thật (uptodate · drug-safety-daily · giam-sat-chung-cu · nckh · tu-kiem-dong-bo · antifacts-weekly-ebm · tong-hop-chung-cu-hang-tuan) + 1 META-bảo trì là ĐẶC TẢ KHÁI NIỆM, KHÔNG có thư mục Scheduled/ và KHÔNG có job lịch (đã RETIRE — xem dòng META bên dưới). (2026-07-12: gỡ dòng "1 bản trùng lặp antifacts-weekly-update đã retire" — find xác nhận thư mục này KHÔNG tồn tại ở bất kỳ đâu trong repo, kể cả để tham chiếu lịch sử; ls Scheduled/ chỉ có đúng 7 thư mục routine thật liệt kê ở trên.) Sửa mapping / quy tắc / lịch ở ĐÂY rồi đồng bộ xuống từng routine — KHÔNG để mỗi routine định nghĩa một kiểu. Đồng bộ với: _BAN-DO-KET-NOI.md · _HIEN-PHAP-LIEM-CHINH.md · README.md. Tạo 2026-06-14; thêm routine META 2026-06-15.

1. MAPPING routine → agent (mặc định)

Phân loại routine: 7 dòng VẬN HÀNH thật (loại trừ dòng ~~antifacts-weekly-update~~ RETIRED xen giữa) = sinh nội dung EBM/NC, routine lâm sàng kết bằng tham-dinh-dau-ra. Dòng cuối = META-bảo trì: nâng cấp chính hệ thống (thư viện playbook + wiring), có khóa _LOCK.md chống chạy song song; tự khai "ĐÃ HOÀN THIỆN" trong _BAO-CAO-HOAN-THIEN khi đủ chuẩn → bác sĩ tắt lịch. Trạng thái 2026-06-16: thư viện có 86 playbook (đếm thật playbooks-lam-sang/); routine META KHÔNG có thư mục Scheduled/ và CHƯA từng có job lịch tự chạy — các playbook được sinh TRONG PHIÊN, không phải bởi daemon. Coi như đã RETIRE. ⚠️ Playbook lâm sàng được nhạc trưởng DÙNG LẠI ở từng ca → khi tái sử dụng, gói ca cuối VẪN qua tham-dinh-dau-ra; khuyến nghị thêm: rà 1 lần Lớp-1 + Q2/Q5 cho mỗi playbook (đề xuất, chưa tự chạy).

Quyền sở hữu chốt 2026-08-01: engine tuần/tháng là owner thu thập + watermark; giam-sat-chung-cu là owner thẩm định candidate; tong-hop-chung-cu-hang-tuan chỉ tóm tắt; uptodate sở hữu closed-loop/Hub; antifacts-weekly-ebm chỉ trình bày. Mọi routine không-owner phải tái dùng candidate queue, cấm tự quét lại cùng cửa sổ. Cổng triển khai: medical-ebm-automation/tools/verify_evidence_surveillance_deployment.py.

Tích lũy vào Antifacts (mặt tiền theo CHUYÊN KHOA): mọi routine sinh dashboard/thẻ chứng cứ → sau guardrail + vào sổ cái, EBM_MASTER/tools/sync_all.py gom vào Antifacts.html ở bước cuối (build_library.py add làm giàu badge → build_antifacts.py). Tự cập nhật TÍCH LŨY, thẻ ở hàng "chờ bác sĩ duyệt". Chi tiết: _BAN-DO-KET-NOI.md §9.

2. QUY TẮC MẶC ĐỊNH — áp cho MỌI routine

1. Liêm chính: tuân _HIEN-PHAP-LIEM-CHINH.md + _NGUYEN-TAC-TRUNG-THUC-BAO-MAT-PHAP-LY-LIEM-CHINH.md. KHÔNG bịa chứng cứ; mỗi mục kèm PMID/DOI; disclaimer "Cần bác sĩ kiểm chứng"; KHÔNG PII.
2. Guardrail đầu ra (bắt buộc với routine sinh nội dung lâm sàng): ở bước cuối trước khi báo bác sĩ, gọi tham-dinh-dau-ra soi gói theo 2 LỚP — Lớp 1 LIÊM CHÍNH R1–R7 (nguồn · PII · vượt cổng A/B/G · tự gán mức · tách 2 trục · nhãn [CẦN…] · disclaimer) + phụ lục CÓ ĐIỀU KIỆN R8 (thống kê — hiệu ứng+95%CI, cấm p-value đơn độc) / R14 (an toàn kê đơn — HARD-RED khi gói CÓ khuyến cáo/điều chỉnh thuốc mà thiếu rà tương tác/CCĐ/chỉnh liều) và Lớp 2 CHẤT LƯỢNG Med-PaLM Q1–Q7 (dễ đọc · đúng đắn · đầy đủ · thiên kiến · nguy cơ hại · cập nhật · thẩm quyền nguồn — _CHUAN-CHAT-LUONG-MEDPALM.md). Gói lâm sàng chỉ phát hành khi ĐẠT cả 2 lớp; còn lỗi đỏ → TRẢ-VỀ-SỬA; Q2/Q5 đỏ → chuyển bác sĩ. Cơ chế & giới hạn: _KIEM-DUYET-DOC-LAP.md.
3. Cổng người duyệt: routine chỉ ĐỀ XUẤT. "Áp dụng ngay" = chỉ vào hàng chờ bác sĩ duyệt (CỔNG A); ghi sổ cái = CỔNG B. KHÔNG tự đổi thực hành/đơn/nội dung lâm sàng.
4. Connector/source-health thiếu → run = PARTIAL: ghi QC_LOG, giữ watermark, không gửi cảnh báo nội dung và không nối Hub; KHÔNG kết luận "không có cập nhật/không có tín hiệu" khi chưa quét được.
5. Headless fallback: phiên nền không gọi được subagent → tự thực hiện bước đó theo đúng đặc tả .claude/agents/<tên>.md (cùng chuẩn, cùng định dạng) — không bỏ bước.
6. Một máy chủ: chạy routine trên MỘT máy (Mac) để tránh xung đột file OneDrive.

3. LỊCH CHẠY (đăng ký — scheduler in-app ~/.claude/scheduled-tasks/)

⚠️ Scheduler là CỤC BỘ TỪNG MÁY — KHÔNG sync qua OneDrive (~/.claude/ nằm ngoài OneDrive). Phải đăng ký trên đúng máy chủ. Máy chủ = Mac (1 máy, tránh xung đột ghi OneDrive). Đăng ký trên Mac bằng gói sẵn Scheduled/_DANG-KY-LICH-TREN-MAC.md (chứa taskId·cron·prompt đủ 6 task — 2026-07-12: sửa "4 task", đã lỗi thời từ trước khi TASK 5/6 được thêm 2026-07-04). Trạng thái cột dưới là đích trên Mac.

Mỗi task native là launcher mỏng: đọc & thực thi đúng Scheduled/<routine>/SKILL.md (đường dẫn tuyệt đối) → tuân hiến pháp liêm chính → guardrail tham-dinh-dau-ra → ghi sổ cái. Sửa NỘI DUNG routine ở Scheduled/; sửa LỊCH ở scheduler.

Khi thêm/sửa routine: cập nhật bảng ở đây + khối wiring trong Scheduled/<routine>/SKILL.md + đăng ký ở _BAN-DO-KET-NOI.md mục 8. "Cần bác sĩ kiểm chứng."