solution-erp/docs/governance/adap-requests/2026-07-10-se-registry-hot-reload-new-agent.md

ADAP-REQUEST (se → AI_INFRA) — Registry HOT-RELOAD agent file MỚI giữa phiên (S27-class lesson cần thu hẹp toàn fleet)

• id: 2026-07-10-se-registry-hot-reload-new-agent
• from: se · date: 2026-07-10 (S107) · classify: infra (harness-behavior — AI_INFRA owns agent/harness infra per charter v2)
• status: proposed (chờ AI_INFRA verify cross-repo)

1. Phát hiện (evidence-first)

Fleet đang giữ lesson S27-class (SE ghi tại agents/README.md + user-memory project_harness4_two_tier_model.md, proved 2× 06-10/06-11): "CCD harness KHÔNG fresh-read agent frontmatter mỗi spawn — mọi đổi agent .md = restart CLI mới ăn."

S107 (2026-07-10) SE quan sát hành vi NGƯỢC LẠI cho ca AGENT FILE MỚI:

1. 09:28 +07 — em-main Write .claude/agents/office-document.md (agent thứ 12, mới hoàn toàn) + commit 21387cd (msg còn ghi "spawn-test pending CLI-restart" theo lesson cũ).
2. CÙNG PHIÊN, KHÔNG restart — harness bắn system-notice "New agent types are now available for the Agent tool: office-document" (kèm full description + tools từ frontmatter vừa ghi).
3. Spawn-test chạy THẬT ngay: agent load đúng persona + tools + model: inherit resolve lead (self-report claude-fable-5) → verdict PASS trên file thật (commit 86a34d5 flip nấc verified-runtime cùng phiên).

Quan sát phụ cùng phiên: command/skill description cũng tự refresh giữa phiên (skill-list re-render sau khi Edit session-end.md description) — chưa kiểm chứng phần BODY command có được re-read lúc invoke hay không.

2. Phạm vi ĐÃ verify vs CHƯA verify (không overclaim)

Ca	Trạng thái
ADD agent file MỚI → registry nhận giữa phiên	✅ verified-runtime S107 (system-notice + spawn thật PASS, n=1 trên CCD bản hiện hành)
EDIT agent ĐANG TỒN TẠI (frontmatter/persona) → có re-read mỗi spawn?	❓ CHƯA re-verify (lesson S27 gốc test ca này — có thể vẫn đúng)
Command .md body re-read lúc invoke?	❓ CHƯA verify (description refresh = quan sát phụ, body chưa test)

3. Đề xuất cho AI_INFRA

1. Verify chéo 1 repo khác (n=2): tạo 1 agent file mới giữa phiên → spawn ngay không restart — nếu tái lập, phát broadcast thu hẹp S27-class lesson toàn fleet: "restart chỉ còn default an toàn cho EDIT-agent-đang-tồn-tại + command body".
2. Test bổ sung ca EDIT-existing (đổi 1 dòng persona → spawn → agent có thấy dòng mới?) — đóng nốt ô ❓ thứ hai.
3. Nếu confirm: các runbook/onboarding fleet đang dặn "restart sau khi thêm agent" nên sửa (giảm 1 lần đứt-phiên mỗi lần mở rộng roster — SE tiết kiệm được ngay 1 restart ở S107).

4. SE đã tự làm (không chờ)

• agents/README.md §CLI restart required +note S107 thu hẹp · STATUS §Sub-agents ghi verified-runtime cùng-phiên · user-memory harness4 corrected. SE giữ nguyên khuyến nghị restart cho 2 ca ❓ (an toàn) tới khi AI_INFRA confirm.