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.