Incomex AI Portal
KB-62D8

Phụ lục Triển khai Agents Legal — Nhật ký & Index (ĐỌC ĐẦU TIÊN)

5 min read Revision 1
legal-agentsnhat-kyhandoffindexclaude-for-legalsoan-thao

Phụ lục Triển khai Agents Legal — Nhật ký & Index

Path: knowledge/dev/legal-agents/00-nhat-ky-trien-khai.md Vai trò: ĐỌC ĐẦU TIÊN khi resume. File entry-point của phụ lục triển khai agents legal. Trạng thái: ĐANG TRIỂN KHAI (nhiều phiên/nhiều tuần) Tạo: 2026-05-29 | Cập nhật cuối: 2026-05-29 Ghi chú: Tạm lưu trên KB. Khi miếng thông tin (IU Fabric) xong → migrate sang IU để kết nối + xem lại tốt hơn.

1. TÓM TẮT TRẠNG THÁI (1 màn hình — đọc cái này trước)

Mục tiêu lớn: tự động hoá soạn thảo TOÀN BỘ tài liệu kinh doanh & vận hành của Incomex — hợp đồng (lao động / đối tác / khách Nhật / thực tập sinh), công văn & văn bản hành chính (văn phong nhà nước), quy định nội bộ, chính sách nhân sự, quy trình thăng tiến, điều cấm kỵ nội bộ — kèm rà soát compliance. Giải phóng thời gian con người để sáng tạo.

Đang ở đâu: vừa CÀI XONG 4 khung agent pháp lý (Claude for Legal) ở local — đây là bước hạ tầng công cụ đầu tiên, độc lập. Chưa xây nghiệp vụ thật.

Nguyên lý định vị (quan trọng — đừng hiểu nhầm):

  • 4 plugin Claude for Legal = KHUNG quy trình + executor pattern THAM KHẢO (chuẩn tạm thời, "mai có cái tốt hơn → sửa"). KHÔNG phải hệ thống chính, KHÔNG phải chuẩn pháp lý VN. Ruột nội dung VN/Nhật tự xây sau.
  • "Soạn thảo" = một ứng dụng nghiệp vụ chạy TRÊN hạ tầng quy trình "4 bà mẹ" (MOW/MOT/MOIT/MOUT) + Event 5 lớp + miếng thông tin (IU). Claude legal agents chỉ là một executor class trong tầng worker.
  • Hạ tầng 4 bà mẹ đang ở Requirement Rev2 (DRAFT, chờ user duyệt) — chi tiết file 01. Vì vậy CHƯA enact "Điều 60 Luật Soạn thảo"; thứ tự đúng là hạ tầng trước (chi tiết file 02).

Việc anh Huyên cần làm ngay (tối thiểu):

  1. Restart Claude Code để 4 plugin live.
  2. Bấm OAuth connector qua /mcp (ưu tiên Google Drive + Slack; CLM/DMS chỉ khi cần) — agent KHÔNG tự làm.
  3. Dán mẫu thật vào profile CLAUDE.md (1 HĐ phái cử, 1 HĐ lao động, 1 công văn nhà nước, 1 nội quy nhân sự) → output đỡ generic.

2. MỤC LỤC PHỤ LỤC

File Nội dung
00-nhat-ky-trien-khai.md File này — nhật ký + index + tóm tắt trạng thái
01-kien-truc-dinh-vi.md Kiến trúc & định vị: 4 bà mẹ, IU-centered, plugin = khung executor, boundary luật
02-plan-roadmap.md Lộ trình theo thứ tự nền-trước + việc cần làm + open items

3. NHẬT KÝ THEO PHIÊN

Đã làm:

  • Xác minh "Claude for Legal" (Anthropic công bố 12/5/2026, repo anthropics/claude-for-legal, Apache 2.0): 12 plugin + 80+ agent + ~20 MCP connector + Managed Agents API.
  • Chốt cài chọn lọc 4 plugin (loại 8 cái Mỹ-EU/không liên quan).
  • Giao claude-go cài. Kết quả: cài đúng 4 plugin v1.0.2, scope user, local, versioned. Tổng 51 skill.
Plugin Skill Agent Phục vụ
commercial-legal 12 3 hợp đồng đối tác / khách Nhật
employment-legal 20 1 HĐ lao động + thực tập sinh + chính sách/quy định nhân sự (policy-drafting)
regulatory-legal 9 1 theo dõi thay đổi quy định phái cử VN/Nhật
ai-governance-legal 10 0 khung compliance gap (quy định→nghĩa vụ→rà đáp ứng)

Vị trí cài (local máy Huyên):

  • Repo upstream (tra cứu): /Users/nmhuyen/projects/claude-for-legal/
  • Profile versioned (nguồn duy nhất): /Users/nmhuyen/projects/incomex-legal/CLAUDE.md
  • Symlink vào: ~/.claude/plugins/config/claude-for-legal/{commercial,employment,regulatory,ai-governance}-legal/CLAUDE.md
  • Commit: 3540e074e4e7906567105601fa31577c50eaba23

Quyết định kỹ thuật / bài học:

  • Marketplace add từ path local FAIL (tên claude-for-legal reserved cho org); đúng cú pháp: claude plugin marketplace add anthropics/claude-for-legal, rồi claude plugin install <plugin>@claude-for-legal.
  • Cold-start interview KHÔNG chạy (tương tác) → thay bằng profile thủ công. Hệ quả: profile hiện là khung rỗng, output còn generic tới khi nạp mẫu thật.
  • 4 plugin dùng chung 1 profile (symlink). Tương lai có thể tách riêng theo trục khi profile giàu lên.

Trạng thái verify: mới ở mức "plugin khai báo đủ skill" (qua claude plugin list/details), CHƯA chạy skill thật trên tài liệu (đúng ràng buộc an toàn). Lần soạn thử đầu tiên (sau restart + có mẫu) mới xác nhận profile được đọc + skill chạy.

Còn treo: xem file 02 (restart, OAuth, nạp mẫu, duyệt Rev2...).

4. QUY ƯỚC CẬP NHẬT NHẬT KÝ

  • Mỗi phiên làm việc về legal agents → thêm 1 entry mới ở §3 (mới nhất trên cùng trong từng năm-tháng, hoặc theo ngày).
  • Cập nhật §1 (tóm tắt trạng thái) mỗi khi trạng thái lớn đổi.
  • Đổi "Cập nhật cuối" ở header.
  • Khi IU Fabric xong → migrate phụ lục sang miếng thông tin, để lại con trỏ ở đây.