Các file tài liệu

Mỗi mẫu có một bộ file tài liệu ở thư mục gốc. Mỗi file dành cho một người đọc; AI đọc AGENTS.md trước tiên.

Bảng các file

File	Nội dung	Dành cho
`README.md`	Tổng quan, chạy trên máy, đưa lên mạng	Mọi người
`HUONG-DAN-SU-DUNG.md`	Các trang của site, sửa nội dung trong admin, việc thường làm, SEO và tracker, xử lý sự cố	Chủ site, người sửa nội dung
`FEATURES.md`	Tính năng có, chưa có, có một phần	Chủ site, developer
`DEPLOY.md`	Lệnh build, biến môi trường, những gì chưa sẵn sàng, checklist trước khi go-live	Developer
`PRODUCT.md`	Việc kinh doanh của site: thương hiệu, khách hàng, sản phẩm, chính sách	Chủ site, người viết nội dung, AI
`DESIGN.md`	Màu, font, khoảng cách, quy tắc giao diện (bản máy đọc: `.impeccable/design.json`)	Designer, developer, AI
`CONTEXT.md`	Tình trạng hiện tại, quyết định còn mở, thiếu sót đã biết	Developer, AI
`CREDITS.md`	Nguồn và giấy phép của ảnh, font, icon, code bên thứ ba	Chủ site, developer
`AGENTS.md`	Cách làm việc trong code (tiếng Anh): cấu trúc, lệnh, quy ước	Developer, AI
`CLAUDE.md`	Chỉ trỏ tới `AGENTS.md` để Claude Code tự đọc	AI

Giữ tài liệu đúng với code

Thêm hay bỏ một tính năng thì sửa FEATURES.md trong cùng lần commit; thêm ảnh hay font của bên thứ ba thì ghi vào CREDITS.md; quyết định còn bỏ ngỏ thì ghi vào CONTEXT.md. Nhờ AI làm việc này cũng được (xem 4 Làm việc với AI).

Cảnh báo

Trước khi go-live, mọi ảnh và tài nguyên trong CREDITS.md phải ở trạng thái "được dùng". Cái nào chưa thì thay.