Checklist Layer 1 — Domain Rules

Version: 1.0 | Date: 2026-02-25 Phạm vi: Áp dụng theo LOẠI task. Agent chọn đúng section phù hợp. Tham chiếu: checklist-layer0.md (phải pass Layer 0 trước)

---

MỤC ĐÍCH

Layer 1 bổ sung checklist theo loại công việc. Agent đọc Layer 0 (bắt buộc) + chọn đúng loại bên dưới.

---

type: code-change

Áp dụng khi: tạo PR, sửa code, thêm feature, fix bug.

• PR tạo đúng branch naming: feat/, fix/, chore/
• Không modify file ngoài scope của task
• Merge protocol đúng repo: gh pr merge <ID> --squash --delete-branch
• Không tạo file tạm/script 1 lần (dùng DOT tools)
• Dependencies mới phải justify (tại sao cần, có alternative built-in không?)

type: schema-change

Áp dụng khi: thêm/sửa/xóa collection, field, relation trong Directus.

• Snapshot schema TRƯỚC khi thay đổi (dot-schema hoặc export)
• Verify relations không bị phá sau thay đổi
• Test CRUD (Create/Read/Update/Delete) cho collection bị ảnh hưởng
• Permissions vẫn đúng cho tất cả roles
• Nuxt frontend vẫn render đúng (nếu collection hiển thị trên UI)

type: content-update

Áp dụng khi: thêm/sửa tài liệu trong Agent Data, Directus content.

• Nội dung đúng format (Markdown cho SSOT, JSON cho config)
• Không trùng lặp với document đã có
• Tags/metadata đầy đủ
• Verify document accessible qua API sau upload

type: infrastructure

Áp dụng khi: thay đổi VPS, nginx, Docker, CI/CD, DNS.

• Health check endpoints verified SAU thay đổi
• Rollback plan documented TRƯỚC khi thay đổi
• GC-LAW compliance: không tạo Service Account mới
• Backup/snapshot trước thay đổi quan trọng
• Monitor 30 phút sau deploy, không có error spike

type: review

Áp dụng khi: review PR, kiểm tra kết quả agent khác, audit.

• Đọc diff/change thực tế (không chỉ đọc mô tả)
• Test thực tế ít nhất 1 case (curl, browser)
• Phản biện constructive: nêu rõ vấn đề + đề xuất fix
• Không approve khi chưa verify CI green

type: investigation

Áp dụng khi: điều tra lỗi, phân tích vấn đề, research.

• Thu thập evidence trước khi kết luận
• Ghi rõ nguồn thông tin (log, API response, docs)
• Phân biệt rõ: sự thật vs giả thiết
• Đề xuất action items cụ thể (không chỉ mô tả vấn đề)